Configuração de cliente Pro
Configure o WhatsApp para clientes Pro
Um guia completo para agências e ISVs darem a cada cliente Pro um número dedicado do WhatsApp usando a Twilio e a API do WhatsApp Business da Meta.
Como funciona
Esta configuração conecta três serviços. A Twilio fornece o número de telefone, a Meta fornece a API do WhatsApp Business e o AutoManus executa o agente de IA.
1️⃣
Twilio
Provedor de número de telefone
Cerca de $1 a $5 por mês
2️⃣
Meta
API do WhatsApp Business
Cuida de todo o envio de mensagens
3️⃣
AutoManus
Painel do agente de IA
Conexão por credenciais de API
O que você precisa
- Uma conta da Twilio com faturamento ativado
- Acesso a uma conta do Meta Business Suite
- Os dados de registro da empresa do seu cliente (para o pacote regulatório)
- Uma assinatura Pro ativa do AutoManus
Fase 1: obter um número da Twilio
Acesse o Console da Twilio
Faça login em console.twilio.com, depois vá em Phone Numbers e em seguida Buy a Number.
Procure um número
Selecione o país do cliente e escolha um número com capacidade de Voice e SMS.
Conclua o pacote regulatório do Reino Unido
Se a Twilio solicitar um pacote regulatório, crie um com estas escolhas:
- Selecione ISV ou revendedor como tipo de empresa
- Selecione sim quando perguntarem sobre subatribuir o número a um usuário final
- Selecione que uma empresa recebe e usa o número
Insira as informações da empresa do cliente:
- Nome da empresa: A razão social registrada do cliente
- Órgão de registro: Companies House (para empresas do Reino Unido)
- Número de registro: O número de registro da empresa do cliente
- Site: O site da empresa do cliente
- Endereço: O endereço comercial registrado do cliente
A análise costuma levar de um a três dias úteis. Você pode consultar os dados de uma empresa no Companies House.
Configure o encaminhamento de chamadas
Números da Twilio podem receber chamadas. Encaminhe as chamadas recebidas para um telefone real para não perder clientes.
- Abra o número no Console da Twilio
- Em Voice Configuration, defina o manipulador de chamadas como um TwiML Bin
- Cole o TwiML abaixo para encaminhar as chamadas
<?xml version="1.0" encoding="UTF-8"?> <Response> <Dial>+YOUR_PERSONAL_PHONE</Dial> </Response>
Substitua +YOUR_PERSONAL_PHONE pelo número em que deseja receber as chamadas encaminhadas.
Fase 2: configurar o Meta Business Suite
Abra o Meta Business Suite
Acesse business.facebook.com, depois vá em Settings, Accounts e em seguida WhatsApp Accounts.
Crie uma nova conta do WhatsApp Business
Clique em Add para criar uma nova conta do WhatsApp Business (WABA) com estes dados:
- Nome da conta: O nome da empresa do cliente
- Categoria: A categoria que melhor corresponde ao negócio do cliente
Adicione o número de telefone da Twilio
Quando for solicitado um número de telefone:
- Selecione adicionar um novo número
- Insira o número da Twilio que você comprou
- Selecione a verificação por chamada de voz (não SMS)
Receba a chamada de verificação
A Meta ligará para o número da Twilio com um código de verificação. Graças ao encaminhamento de chamadas, a ligação chega ao seu telefone. Insira o código no Meta Business Suite.
Registre o número na Cloud API
Registre o número de telefone na Cloud API da Meta para que ele possa enviar e receber mensagens. Esta etapa costuma ser esquecida.
curl -X POST "https://graph.facebook.com/v21.0/PHONE_NUMBER_ID/register" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"messaging_product": "whatsapp", "pin": "123456"}'- O número aparecerá como conectado, mas as mensagens falharão
- O webhook não entregará as mensagens recebidas
- Você verá erros ao enviar pelo AutoManus
Fase 3: obter credenciais de API
Abra o console de desenvolvedores da Meta
Acesse developers.facebook.com, depois selecione seu app, vá em WhatsApp e em seguida API Setup.
Selecione o novo número de telefone
Na página de API Setup, selecione o número de telefone do cliente no menu suspenso para que as credenciais abaixo correspondam a ele.
Copie as credenciais
Você precisa de três valores da página de API Setup:
- ID do número de telefone: O ID exibido ao lado do número selecionado
- ID da conta do WhatsApp Business: O ID da WABA da conta do cliente
- Token de acesso: O token temporário exibido na página
Gere um token permanente
O token temporário expira em 24 horas. Gere um token permanente a partir de um usuário do sistema:
- Vá em Business Settings e depois System Users
- Crie um usuário do sistema com a função de Admin
- Clique em Generate Token
- Selecione seu app e conceda estas permissões:
- whatsapp_business_management
- whatsapp_business_messaging
- Copie o token gerado e guarde-o com segurança
Fase 4: conectar ao AutoManus
Abra a configuração do WhatsApp
Faça login na conta do AutoManus do cliente e vá para → /dashboard/whatsapp-setup
Use a configuração avançada
Clique em Advanced Setup para inserir as credenciais manualmente em vez de usar o login guiado do Facebook.
Insira as credenciais
Preencha o formulário com os valores da Fase 3:
- Token de acesso: O token permanente do usuário do sistema
- ID do número de telefone: O ID do número de telefone do API Setup
- ID da conta empresarial: O ID da conta do WhatsApp Business
- Nome de exibição: O nome que os clientes verão
Configure o webhook
No console de desenvolvedores da Meta, configure o webhook para que o AutoManus receba as mensagens recebidas:
- URL de callback: https://automanus.io/api/whatsapp/webhook
- Token de verificação: automanus_webhook_2025
Conecte e teste
Salve a configuração e envie uma mensagem de teste para o número do cliente. O agente de IA deve responder em alguns segundos.
Transferência de propriedade
Quando o trabalho terminar, você pode entregar o número e a conta do WhatsApp ao cliente.
Meta Business Suite
- Abra Business Settings e depois WhatsApp Accounts
- Selecione a WABA do cliente
- Adicione o cliente como parceiro ou atribua a empresa dele
- Conceda ao cliente o controle total da conta
- Remova seu próprio acesso quando o cliente confirmar
Twilio
Na Twilio, você pode criar uma subconta ou transferir o número para a conta Twilio do cliente, ou continuar faturando pela sua conta.
Custos
- Número da Twilio: Cerca de $1 a $5 por mês
- Conversas da Meta: Conversas iniciadas pelo usuário são gratuitas por 24 horas
- Iniciadas pela empresa: Cerca de $0.005 a $0.05 por conversa
Solução de problemas
Pacote regulatório do Reino Unido rejeitado
Verifique se o nome da empresa, o número de registro e o endereço correspondem exatamente ao registro oficial do Companies House.
A verificação por SMS não funciona
Números da Twilio podem não receber SMS da Meta de forma confiável. Use a verificação por chamada de voz.
Chamada de verificação não recebida
Confirme se o encaminhamento de chamadas está configurado no número da Twilio e se o telefone de destino consegue atender a chamada.
Número não disponível
Se não for possível adicionar o número na Meta, confirme se ele já não está registrado no WhatsApp e se o pacote regulatório foi aprovado.
Conta não registrada
Se as mensagens falharem com um erro de registro, registre o número na Cloud API:
curl -X POST "https://graph.facebook.com/v21.0/PHONE_NUMBER_ID/register" \
-H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
-d '{"messaging_product": "whatsapp", "pin": "123456"}'Número de telefone não encontrado
Confirme se você selecionou o número de telefone correto no API Setup e se as credenciais correspondem a esse número.
O agente de IA não responde
Verifique se existe uma implantação em own_whatsapp_deployments e se o agente está ativo para este número.