Instalação
Instale o MailG a partir do Google Workspace Marketplace e abra-o no Google Sheets.
Dois passos: instalar o add-on e depois abri-lo a partir do Sheets.
Instalar o MailG
- Abra a listagem MailG no Google Workspace Marketplace.
- Clique em Install.
- Escolha a conta Google que deve ser proprietária da instalação.
- Reveja as permissões e clique em Allow.
A instalação costuma terminar em menos de 15 segundos. Deve ver uma confirmação de que o add-on foi instalado.
Listagem no Marketplace
Se a listagem no Marketplace ainda não estiver disponível na sua região, use o CTA de instalação em www.mailg.io ou contacte [email protected].
Abrir o MailG no Google Sheets
- Abra o Google Sheets (atualize se o Sheets já estiver aberto).
- Aguarde alguns segundos para as Extensions carregarem (muitas vezes ~10–15 segundos).
- Vá a Extensions → MailG for Gmail → 🚀 Start.
Mais tarde pode executar Extensions → MailG for Gmail → 🔄 Refresh Tracking para sincronizar estados de abertura sem abrir o diálogo completo.
Problemas de instalação
Estas são peculiaridades comuns do Google Workspace, não bugs do MailG:
Nunca vejo o popup «installed successfully»
Isto acontece frequentemente quando várias contas Google têm sessão iniciada e a instalação não usou a conta que esperava.
Solução alternativa: abra uma janela privada/incógnito, inicie sessão apenas com a conta pretendida e instale novamente a partir do Marketplace.
O MailG não aparece em Extensions
- Atualize a folha de cálculo.
- Aguarde cerca de 10–15 segundos para os add-ons carregarem.
- Confirme que está na mesma conta Google que instalou o MailG.
- Experimente outra folha de cálculo ou limpe a cache do browser se continuar em falta.
Implementações self-hosted / personalizadas
As instalações do Marketplace vêm pré-configuradas. Se implementar o MailG por si, defina propriedades de script do Apps Script:
| Propriedade | Valor |
|---|---|
APP_URL | URL HTTPS pública da sua API MailG |
APP_API_KEY | Mesma chave que o servidor API |
O add-on não consegue aceder a localhost a partir dos servidores da Google — use um túnel (Cloudflare Tunnel, ngrok, etc.) para testes locais.
Seguinte
Continue com o tutorial de mail merge.