MailGDocumentation
Ajuda

Resolução de problemas

Corrija erros API, folhas vazias, envios falhados, tracking e problemas de quota no MailG for Gmail.

Correções rápidas para as mensagens e estados que vê no add-on.

O diálogo não carrega

Could not reach the MailG API

O diálogo start não conseguiu chamar o backend MailG.

  • Confirme que está online
  • Instalações Marketplace: aguarde um momento e reabra 🚀 Start
  • Self-hosted: verifique propriedades Apps Script APP_URL (HTTPS pública) e APP_API_KEY
  • O add-on não pode usar localhost — use um túnel para testes API locais

Could not read your sheet

O MailG falhou ao ler a folha de cálculo ativa.

  • Certifique-se de que um separador da folha está aberto (não apenas o editor Apps Script)
  • Recarregue a folha de cálculo e reabra o diálogo
  • Confirme que tem acesso de edição ao ficheiro

Loading… nunca termina

Feche o diálogo, atualize o Sheets, aguarde ~15 segundos para Extensions e 🚀 Start novamente.

Folha vazia

No email address found in your sheet

O MailG precisa de pelo menos uma coluna com endereços de email válidos.

  • Adicione emails sob um cabeçalho ou clique em Fill with mock data
  • Dados mock criam Email, First Name, Last Name, Company e frequentemente My First Template

Consulte o Tour do diálogo Start.

Modelos

  • Criar: Creating Template...Template created successfully! ou Failed to create template! Try again later.
  • Atualizar: Updating template...
  • Falhas ao eliminar: Failed to delete template. Try again later

Consulte Templates.

Problemas de envio

Botão de envio desativado / Send emails sem contagem

  • Selecione um Template
  • Selecione uma Recipient column com emails únicos válidos por célula
  • Toasts de bloqueio que pode ver: Configure your recipient column first, Select a template first., No valid recipient emails found in the selected column.

A campanha falha ao iniciar

Toast: Failed to create campaign. Please try again.

  • Tente novamente uma vez
  • Verifique se Daily quota não é 0
  • Confirme conectividade API (consulte acima)

Linhas mostram ⚠️ Failed

Essa linha teve um erro de envio (endereço inválido, rejeição Gmail, quota transitória, etc.). Corrija os dados e inicie uma nova campanha para as linhas restantes, ou consulte Parar uma campanha.

Email de teste falha

  • Configure your preview first — escolha template + destinatário para a pré-visualização ter To
  • Failed to send test email. Please check your email settings. — reautorize o Gmail se necessário e tente novamente

Tracking

  • Aberturas exigem imagens remotas carregadas pelo destinatário
  • Execute 🔄 Refresh Tracking — espere Tracking info synced ou No active campaigns
  • Estado 👀 Opened só aparece quando o pixel carrega

Consulte Email tracking.

Quota e branding

  • N left na barra lateral é min(MailG remaining, Gmail remaining)
  • @gmail.com gratuito é frequentemente limitado perto de 500/dia pela Google mesmo no Professional
  • Marca de água ainda presente após pagamento → email do checkout deve coincidir com conta Sheets; reabra o diálogo

Consulte Daily quota e avaliações e Remove branding.

O agendamento não diferiu

Horas a menos de cerca de 15 segundos à frente são tratadas como envio imediato (coluna 🚀), não como agendamento diferido 🗓️. Escolha uma hora mais distante no futuro.

Ainda com dificuldades?

FAQ completa: FAQ · Email [email protected] · Site app.mailg.io/help

On this page