Por que Twilio
O Apollo Space usa Twilio como provedor de WhatsApp Business porque é a opção mais estável + auditável do mercado: aprovação Meta, templates oficiais, status callbacks, suporte a múltiplos números na mesma org. A integração é BYO key (Bring Your Own Key) — você cria a conta Twilio e fica dono dela. O Apollo Space só dispara mensagens via sua conta; a fatura real do WhatsApp vai pra você direto.O que você precisa pra começar
Conta Twilio
Crie em twilio.com. Plano pay-as-you-go é
suficiente — não precisa de plano enterprise.
Número WhatsApp aprovado
Aprovação feita pela Meta (Business). O Twilio cobre o processo
end-to-end — pode levar de 2 a 7 dias úteis dependendo do tipo de
negócio.
Messaging Service no Twilio
Crie um Messaging Service que agrupa: número aprovado, webhook de
inbound, status callback, e (opcionalmente) templates pré-aprovados.
Credenciais
Account SID + Auth Token + Messaging Service SID — três strings
que você cola no Apollo Space (Settings → Integrações → WhatsApp).
Como funciona o envio
Quando o Marcus dispara uma mensagem:Apollo Space monta a chamada
O agente compõe a mensagem com a voz da sua org, escolhe template
aprovado (quando fora da janela 24h) ou texto livre (quando dentro).
Apollo Space chama o Twilio
Via Messaging Service SID — o Twilio escolhe o número remetente
do pool configurado.
Twilio entrega via Meta
O Twilio é quem realmente fala com a infra do WhatsApp. Apollo Space só
recebe o ID da mensagem + status inicial.
Tracking inbound (replies)
Quando alguém responde, o Twilio chama um webhook do Apollo Space. O
reply vira atividade no lead + notificação no chat do dono da
relação. Marcus não responde sozinho — quem responde é humano
(ou o Twin configurado).
Janela 24h do WhatsApp
A Meta tem uma regra rígida: depois que o cliente manda uma mensagem pra você, abre uma janela de 24h durante a qual você pode responder com texto livre. Fora dessa janela, qualquer primeira mensagem precisa ser um template aprovado pela Meta. O Marcus respeita isso automaticamente:- Dentro da janela → texto livre, com a voz da org
- Fora da janela → usa o template mais adequado ao contexto, pré-cadastrado no seu Messaging Service do Twilio
Modos de operação
Self (default)
Você usa seu próprio número + sua conta Twilio. Fatura inteira é
sua (Twilio cobra você direto). Esta é a opção recomendada para
qualquer time sério — controle total + zero intermediário.
Shared (pool Apollo Space)
Em desenvolvimento. Será uma opção pra times pequenos testarem o
produto sem aprovar número próprio. Quotas mensais reduzidas;
apropriado pra exploração inicial, não pra operação real.
Custos
| Onde cai | Quem paga |
|---|---|
| Mensagem enviada (preço Meta por conversação) | Sua conta Twilio |
| Uso da plataforma Apollo Space (orquestração, agentes, tracking) | Seu saldo de Stars |
Setup passo-a-passo
Veja Configurar WhatsApp para o guia completo com screenshots + diagnóstico de erros comuns.Próximos passos
Marcus — quem usa o canal
O agente outbound dispara via WhatsApp quando o canal está
conectado.
Guia passo-a-passo
Detalhe da configuração + troubleshooting.
Stars
Como o uso do Apollo Space + o uso do Twilio se dividem no faturamento.