Skip to main content

​
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
Tempo estimado: 45 minutos a 7 dias — a aprovação do número pela Meta é o gargalo. As outras etapas levam 10 minutos.

​
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 ApolloSpace AI. 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:
  1. Confirma os dados da empresa (CNPJ, razão social, endereço)
  2. Cadastra o número (idealmente um número novo + dedicado)
  3. Submete pra aprovação Meta
  4. Aguarda
Aprovação Meta leva 2-7 dias úteis. Não comece esse passo na véspera de um lançamento. E se for o primeiro WhatsApp Business da sua empresa, a Meta pode pedir verificação adicional do domínio + CNPJ — pode estender pra 14 dias em casos sensíveis.
Resultado esperado: e-mail do Twilio confirmando “Sender approved” + o número aparece como active no painel Senders → WhatsApp.

​
Passo 3: criar Messaging Service

Ainda no Twilio: Develop → Messaging → Services → Create new. Salvar e copiar o Messaging Service SID (formato MGxxxx...). Você cola no ApolloSpace AI no passo 5.

​
Passo 4: pegar Account SID + Auth Token

No dashboard Twilio, Account Dashboard → Account Info:
O Auth Token é equivalente à senha master da sua conta Twilio. Quem tem o token pode disparar mensagens (e gerar fatura) em seu nome. Trate com o mesmo cuidado de uma senha: nunca commit em repo público, nunca cole em chat, nunca compartilhe em screenshot.Se você suspeitar que vazou, rotacione imediatamente no dashboard Twilio e atualize no ApolloSpace AI.

​
Passo 5: conectar no ApolloSpace AI

No ApolloSpace AI: Settings → Integrações → WhatsApp → Conectar Twilio. Cole os três valores: Clique Conectar. O ApolloSpace AI executa por baixo dos panos:
  1. Valida as credenciais com a API Twilio
  2. Atualiza o inbound webhook + status callback do Messaging Service apontando pro ApolloSpace AI (você não precisa fazer isso manualmente)
  3. Marca a integração como ativa
Resultado esperado: badge Conectado na linha do WhatsApp em Settings → Integrações.

​
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
A mensagem chega no seu WhatsApp em segundos. O ApolloSpace AI grava o teste no histórico de uso da org.
Sem janela 24h aberta? Use template. Como você nunca trocou mensagem com o número ApolloSpace AI, está fora da janela 24h da Meta. O ApolloSpace AI te oferece os templates pré-aprovados do seu Messaging Service. Escolha qualquer um — só pra testar a integração.

​
Diagnóstico — erros comuns

Onde os logs ficam:

​
Dicas de produção

Antes de operar em escala real, vale revisar:
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
Trocar no Twilio + atualizar no ApolloSpace AI leva 2 minutos. Marcus para de funcionar durante esses 2 minutos — agende em horário não-crítico.
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
O que afeta o rating: respostas negativas dos destinatários, opt-outs em massa, denúncias. Não dispare em massa pra lista fria sem aquecer. O Marcus respeita cadência conservadora por default — não acelere arbitrariamente.
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).
Crie templates na sua conta Twilio, não no ApolloSpace AI. 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ó ApolloSpace AI)
  • ApolloSpace AI lê os templates aprovados automaticamente
Bons templates: utility ou service (mais permissivos). Marketing template requer cuidado redobrado com tom + opt-out.

​
Desconectar

Em Settings → Integrações → WhatsApp → Desconectar:
  • ApolloSpace AI apaga as credenciais do banco
  • ApolloSpace AI 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
Sua conta Twilio e o número aprovado continuam — desconectar do ApolloSpace AI não mexe na sua infra Twilio.

​
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.