Como configurar e enviar campanhas de email no Cloud Chat
🎥 Demonstração em vídeo
Veja o fluxo completo na prática — da configuração (endereço postal, domínio e remetente) à criação da campanha de
e-mail:
https://www.loom.com/share/1e2684089c8b40b3affd12a982092f4f
Quando usar
- Você quer disparar emails em massa para um segmento de contatos do Cloud Chat.
- Você precisa que as respostas dos clientes voltem como conversas normais no Cloud Chat (não em um inbox externo).
- O envio precisa cumprir CAN-SPAM / LGPD (endereço postal + link de unsubscribe automáticos).
Pré-requisitos
:::error Antes de criar a primeira campanha, conclua as etapas 1, 2 e 3 deste tutorial na ordem. Pular qualquer uma faz
a campanha falhar silenciosamente ou ser rejeitada pelo Gmail/Yahoo.
:::
- Perfil de administrador no Cloud Chat.
- Acesso ao DNS do domínio que será usado pra enviar (Cloudflare, Route53, Registro.br, etc.). A verificação envolve
adicionar 3-4 registros.
- Uma caixa de entrada do tipo Email já configurada — ela vai receber as respostas dos contatos. Se ainda não tem,
crie em Configurações → Caixas de entrada.
- O endereço postal completo da empresa (rua, cidade, estado, CEP, país) — exigência da CAN-SPAM, vai no rodapé de
todo email.
Sobre este tutorial
O fluxo completo tem 5 etapas: endereço postal → domínio → remetente → campanha → acompanhamento. Cada etapa fica em
Configurações → Campanhas por email no menu lateral.
Passo a passo
Etapa 1 — Configurar o endereço postal
O endereço postal aparece no rodapé de todos os emails de campanha, junto com o link de unsubscribe. É exigência legal
(CAN-SPAM nos EUA, LGPD no Brasil) e Gmail/Yahoo rejeitam emails sem essa informação.
1. Vá em Configurações → Campanhas por email → Endereço postal.
2. Preencha rua, cidade, estado/UF, CEP e país.
3. Clique em Salvar.
:::warning Sem endereço postal preenchido, qualquer tentativa de criar uma campanha de email retorna erro de validação.
Configure antes de prosseguir.
:::
Etapa 2 — Adicionar e verificar o domínio
Você precisa provar que controla o domínio que vai usar como remetente (ex: mail.suaempresa.com). Sem isso, emails caem
em spam ou são rejeitados na origem.
1. Vá em Configurações → Campanhas por email → Domínios.
2. Clique em Adicionar domínio.
3. Digite o domínio (recomendado: subdomínio dedicado, ex: mail.suaempresa.com em vez do domínio raiz).
4. O Cloud Chat mostra 3-4 registros DNS (MX, SPF/TXT, DKIM). Copie todos.
5. No seu provedor de DNS (Cloudflare, Route53, etc.), adicione cada registro exatamente como aparece — tipo, nome,
valor.
6. Volte ao Cloud Chat e clique em Verificar agora no card do domínio.
7. Aguarde a verificação assíncrona (pode levar até 5 minutos após o DNS propagar).
:::success Quando estiver tudo certo, o status do domínio muda para Verificado (verde). Só domínios verificados podem
ser usados como remetente.
:::
:::info O botão Verificar agora fica desabilitado por 30 segundos depois de cada clique pra dar tempo do provedor de
envio processar. Se o status não mudar em 5 minutos, confirme se os registros DNS estão idênticos aos exibidos na tela e
tente de novo.
:::
Etapa 3 — Criar um remetente
O remetente é o endereço visível que aparece no campo "De" dos emails (ex: [email protected]). Cada remetente
está vinculado a um domínio verificado e a uma caixa de entrada que recebe as respostas.
1. Vá em Configurações → Campanhas por email → Remetentes.
2. Clique em Adicionar remetente.
3. Preencha:
- Nome de exibição: nome que aparece no email do destinatário (ex: "Pepa - Suporte Suaempresa").
- Parte local: o que vem antes do @ (ex: pepa, contato, noreply).
- Domínio: escolha um dos domínios verificados na etapa anterior.
- Caixa de entrada de resposta: a caixa de entrada do tipo Email que vai receber respostas dos clientes. Quando o
destinatário responder o email, vira uma conversa nessa inbox.
4. Clique em Salvar.
:::warning A caixa de entrada de resposta precisa ser do tipo Email e estar no mesmo account. Se você não tem nenhuma,
crie primeiro em Configurações → Caixas de entrada → Adicionar caixa de entrada → Email.
:::
Etapa 4 — Criar a campanha
1. Vá em Campanhas → Únicas → Criar uma campanha única.
2. Escolha Tipo: Email.
3. Preencha:
- Título: nome interno da campanha (não vai pro destinatário).
- Assunto: vai no email. Suporta variáveis dinâmicas (ver abaixo).
- Remetente: escolha um dos remetentes criados na Etapa 3.
- Tipo de corpo: HTML (com formatação) ou Texto puro (line breaks preservados).
- Corpo: o conteúdo do email. Suporta variáveis dinâmicas.
4. Defina a audiência — escolha uma das 3 formas:
- Filtro: por atributo do contato (ex: custom_attribute_1 igual a cloud).
- Etiquetas: contatos com tags específicas.
- CSV: upload de planilha com email ou phone_number na coluna identificadora.
5. Clique em Salvar. A campanha entra em status Ativo e é disparada na próxima janela de envio (geralmente em 1-2
minutos).
Variáveis dinâmicas disponíveis no assunto e corpo:
- {{ contact.first_name }} — primeiro nome do contato. Se o contato tem nome de uma palavra só (ex: "Ana"), retorna o
nome inteiro.
- {{ contact.last_name }} — sobrenome. Vazio se o contato só tem 1 palavra no nome.
- {{ contact.name }} — nome completo capitalizado.
- {{ contact.email }} — email do contato.
- {{ contact.phone_number }} — telefone do contato.
- {{ contact.custom_attribute['chave'] }} — qualquer custom attribute do contato.
:::info Contatos sem email válido (campo vazio ou formato inválido) são automaticamente excluídos da audiência. Mesma
coisa pra contatos na lista de bloqueios — quem deu unsubscribe ou bounce permanente não recebe.
:::
Etapa 5 — Acompanhar o envio
Na lista de campanhas (Campanhas → Únicas), cada campanha mostra um status:
- Ativo: aguardando a próxima janela de envio (≈1 min).
- Em execução: emails sendo disparados no momento.
- Concluído: envio finalizado com 99%+ de eventos terminais.
- Parcialmente concluído: pelo menos 80% dos contatos receberam — usado quando alguns falharam mas a maioria foi
entregue.
- Falhou: erro de configuração (domínio não verificado, remetente deletado, kill switch acionado por bounce alto).
Clique em Ver detalhes pra ver quantos contatos foram alvo da campanha e quantos receberam o email.
:::info Quando o destinatário responde o email, a resposta vira automaticamente uma conversa proativa na caixa de
entrada de resposta do remetente. Toda a thread (email original + resposta do cliente) fica vinculada via headers de
email padrão.
:::
Solução de problemas
Se você configurou tudo mas a campanha não envia, o progresso não avança ou os e-mails não chegam, verifique os pontos
abaixo na ordem.
A campanha não dispara
1. Confirme que a campanha está Ativa, não em Rascunho. Campanhas em rascunho não disparam.
2. Verifique o domínio: ele precisa estar Verificado. Se estiver pendente ou falho, confira os registros DNS
(MX/SPF/DKIM) e use Verificar agora.
3. Confirme que o endereço postal foi preenchido e que o remetente tem uma inbox de resposta com e-mail válido.
O progresso não avança ou fica em andamento
O envio acontece em lotes e é processado aos poucos, então é normal levar alguns minutos em audiências grandes.
:::info Se a audiência elegível for zero, a campanha é marcada como Concluída com 0 envios. Isso acontece quando nenhum
contato tem e-mail válido ou quando todos estão na lista de bloqueios (descadastro ou bounce).
:::
1. Abra a campanha e confira os destinatários elegíveis. Se for 0, revise a audiência e os e-mails dos contatos.
2. Contatos sem e-mail válido ou na lista de bloqueios são excluídos automaticamente.
3. Cada campanha envia para no máximo 3.000 contatos. Acima disso, divida em mais de uma campanha.
Os e-mails não chegam, nem no spam
1. Confira o status da campanha. Se estiver Falhou, houve bloqueio: domínio não verificado, remetente removido ou taxa
de rejeição alta.
2. Se a taxa de bounce ou spam ficou alta, o envio é interrompido automaticamente para proteger a reputação do domínio.
3. Revise a verificação do domínio (DNS) e a qualidade da lista de contatos antes de reenviar.
Observações
- Limite por campanha: 3.000 contatos por envio. Pra públicos maiores, divida em várias campanhas.
- Kill switch automático: se a taxa de bounce/reclamação ultrapassar 10% em uma amostra de 200+ entregas, a campanha é
pausada automaticamente e marcada como Falhou. Isso protege a reputação do domínio remetente.
- Lista de bloqueios: contatos que deram unsubscribe, bounce permanente ou marcaram como spam ficam em Configurações →
Campanhas por email → Lista de bloqueios. Eles são excluídos automaticamente de todas as campanhas futuras.
- Cancelando unsubscribes manualmente: você pode remover um email da lista de bloqueios pela mesma tela. Use com
cuidado — clientes podem reclamar.
