O que você vai construir
Ao final deste guia, o Marcus vai conseguir disparar WhatsApp em nome da sua empresa, com:- Um número aprovado pela Meta (não o seu pessoal)
- Janela 24h da Meta respeitada automaticamente
- Tracking de respostas chegando no chat
- Audit trail completo de cada mensagem
Pré-requisitos
Conta Twilio
Pay-as-you-go basta. twilio.com
Número de telefone novo
Preferencialmente NÃO um número pessoal ou do time. Use um número
dedicado à empresa.
Documentos da empresa
CNPJ + razão social + endereço. A Meta verifica antes de aprovar.
Domínio verificado (recomendado)
Acelera a aprovação Meta. Não obrigatório, mas evita rebote.
Passo 1: cadastrar conta Twilio
Vá em twilio.com e crie a conta. O processo padrão inclui verificação de e-mail e telefone — não tem segredo aqui.Conta nova vs sub-account. Se você já tem Twilio rodando outras
coisas (SMS de OTP, fluxos voice), considere criar uma
sub-account dedicada ao Apollo Space. Isolamento de billing +
permissões fica mais limpo.
Passo 2: aprovar o número WhatsApp
No dashboard Twilio: Develop → Messaging → Senders → WhatsApp senders → Get started. O Twilio te guia por um wizard:- Confirma os dados da empresa (CNPJ, razão social, endereço)
- Cadastra o número (idealmente um número novo + dedicado)
- Submete pra aprovação Meta
- Aguarda
Passo 3: criar Messaging Service
Ainda no Twilio: Develop → Messaging → Services → Create new.| Campo | Valor sugerido |
|---|---|
| Friendly name | ”Apollo Space Outbound” (ou similar identificável) |
| Use case | Notifications / Marketing / Mixed (conforme seu caso) |
| Sender pool | Adicione o número aprovado do passo 2 |
| Inbound webhook | Deixe vazio — o Apollo Space preenche ao conectar |
| Status callback | Idem — Apollo Space preenche |
MGxxxx...).
Você cola no Apollo Space no passo 5.
Passo 4: pegar Account SID + Auth Token
No dashboard Twilio, Account Dashboard → Account Info:Passo 5: conectar no Apollo Space
No Apollo Space: Settings → Integrações → WhatsApp → Conectar Twilio. Cole os três valores:| Campo | De onde |
|---|---|
| Account SID | Passo 4 (começa com AC) |
| Auth Token | Passo 4 (clica pra revelar) |
| Messaging Service SID | Passo 3 (começa com MG) |
- Valida as credenciais com a API Twilio
- Atualiza o inbound webhook + status callback do Messaging Service apontando pro Apollo Space (você não precisa fazer isso manualmente)
- Marca a integração como ativa
Passo 6: testar o envio
Em Settings → Integrações → WhatsApp → Enviar mensagem teste:- Coloca seu próprio número WhatsApp como destinatário
- Escolhe um template aprovado pela Meta (ou texto livre se você é um contato recente do número)
- Clica Enviar
Diagnóstico — erros comuns
| Erro | Causa provável | Como resolver |
|---|---|---|
| ”Número não aprovado” | Meta ainda não aprovou, ou aprovação expirou | Volte ao Twilio → status do sender. Re-submete se necessário |
| ”Authentication failed” | Auth Token errado ou rotacionado | Confira no dashboard Twilio; cole de novo no Apollo Space |
| ”Messaging Service not found” | SID errado ou serviço deletado | Confirme o MGxxx... no dashboard Twilio |
| ”Out of window — template required” | Tentou texto livre fora da janela 24h | Use template aprovado, ou aguarde uma resposta do destinatário pra abrir a janela |
| ”Number not in sender pool” | O número não está no pool do Messaging Service | Adicione o número ao pool no dashboard Twilio |
| Sistema | Onde olhar |
|---|---|
| Apollo Space | Settings → Integrações → WhatsApp → Histórico de envios |
| Twilio | Develop → Messaging → Logs (mostra a resposta da Meta linha-a-linha) |
| Meta Business | business.facebook.com → Quality Rating (saúde do número ao longo do tempo) |
Dicas de produção
Antes de operar em escala real, vale revisar:Rotação de credenciais
Rotação de credenciais
Rotacione o Auth Token Twilio:
- Sempre quando alguém com acesso deixa o time
- Periodicamente (sugerido: a cada 6 meses) por higiene
- Imediatamente se há suspeita de vazamento
Quality rating no Meta Business
Quality rating no Meta Business
A Meta atribui um Quality Rating ao seu número (verde / amarelo
/ vermelho). Se cair pra vermelho:
- Você perde direito de iniciar conversas marketing
- Pode receber suspensão temporária do número
- Em casos extremos, banimento permanente
Múltiplos números (escala)
Múltiplos números (escala)
Quando o volume cresce, considere adicionar múltiplos números
ao mesmo Messaging Service. O Twilio distribui automaticamente
a carga + isola o impacto se um número for penalizado.Custo: cada número aprovado é uma fatura mensal de hosting Twilio
(independente do volume).
Templates aprovados
Templates aprovados
Crie templates na sua conta Twilio, não no Apollo Space. Por quê:
- O Twilio submete pra Meta + gerencia o ciclo de aprovação
- Os templates ficam disponíveis pra qualquer ferramenta que use o mesmo Messaging Service (não só Apollo Space)
- Apollo Space lê os templates aprovados automaticamente
Desconectar
Em Settings → Integrações → WhatsApp → Desconectar:- Apollo Space apaga as credenciais do banco
- Apollo Space reverte os webhooks no Twilio (você precisa apontar pra outro endpoint depois — o Twilio não permite webhook vazio)
- Campanhas em andamento que usam WhatsApp pausam até reconectar
Próximos passos
Marcus em ação
Como o agente outbound opera o canal que você acabou de conectar.
Outbound — feature
Tipos de campanha, cadência, métricas.
Custos
Como o WhatsApp entra no faturamento da org.