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

Ponto-chave: A Twilio fornece apenas o número e a verificação. Todo o envio real de mensagens do WhatsApp passa pela Cloud API da Meta, não pela Twilio.

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

1

Acesse o Console da Twilio

Faça login em console.twilio.com, depois vá em Phone Numbers e em seguida Buy a Number.

2

Procure um número

Selecione o país do cliente e escolha um número com capacidade de Voice e SMS.

Números do Reino Unido: Números do Reino Unido exigem um pacote regulatório antes de poderem ser comprados. Veja a próxima etapa.
3

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.

4

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.

  1. Abra o número no Console da Twilio
  2. Em Voice Configuration, defina o manipulador de chamadas como um TwiML Bin
  3. 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

1

Abra o Meta Business Suite

Acesse business.facebook.com, depois vá em Settings, Accounts e em seguida WhatsApp Accounts.

2

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
3

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)
4

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.

A chamada não chega? Verifique se o encaminhamento de chamadas está configurado no número da Twilio e se o destino do encaminhamento consegue receber chamadas.
5

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"}'
Se você pular esta etapa:
  • 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

1

Abra o console de desenvolvedores da Meta

Acesse developers.facebook.com, depois selecione seu app, vá em WhatsApp e em seguida API Setup.

2

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.

3

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
4

Gere um token permanente

O token temporário expira em 24 horas. Gere um token permanente a partir de um usuário do sistema:

  1. Vá em Business Settings e depois System Users
  2. Crie um usuário do sistema com a função de Admin
  3. Clique em Generate Token
  4. Selecione seu app e conceda estas permissões:
    • whatsapp_business_management
    • whatsapp_business_messaging
  5. Copie o token gerado e guarde-o com segurança

Fase 4: conectar ao AutoManus

1

Abra a configuração do WhatsApp

Faça login na conta do AutoManus do cliente e vá para → /dashboard/whatsapp-setup

2

Use a configuração avançada

Clique em Advanced Setup para inserir as credenciais manualmente em vez de usar o login guiado do Facebook.

3

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
4

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
5

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

  1. Abra Business Settings e depois WhatsApp Accounts
  2. Selecione a WABA do cliente
  3. Adicione o cliente como parceiro ou atribua a empresa dele
  4. Conceda ao cliente o controle total da conta
  5. 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.

Recursos