Conectar um número real de WhatsApp via Twilio

Antes de começar: teste e produção

A conexão de WhatsApp pela Twilio tem dois momentos. No ambiente de teste (sandbox), você valida a integração usando um número compartilhado da Twilio, e só quem envia a palavra de entrada consegue trocar mensagens. Para atender clientes de verdade, você precisa do ambiente de produção: um número oficial da sua empresa, aprovado pela Meta. Este tutorial mostra como registrar esse número na Twilio e ativá-lo no sistema.

Aviso: o registro de um número oficial passa por uma análise da Meta (verificação do negócio e do nome de exibição). Reserve alguns dias para a aprovação.

Pré-requisitos

Antes de iniciar, você precisa ter:

• Uma conta na Twilio com saldo (a conta de teste não envia mensagens para números reais)
• Acesso a um Portfólio de Negócios da Meta (Business Manager) — ou criar um durante o processo
• Um número de telefone que ainda não esteja em uso no WhatsApp — nem no aplicativo comum, nem no WhatsApp Business
• O nome de exibição da empresa, seguindo as diretrizes da Meta (o nome real do negócio)
• Permissão para configurar a conexão de WhatsApp no sistema

Passo 1: Abra o registro de remetente na Twilio

No Console da Twilio, acesse Messaging > Senders > WhatsApp senders e clique em Create new sender (criar novo remetente).

Passo 2: Escolha o número

Selecione o número que será o WhatsApp oficial da empresa. Pode ser um número da própria Twilio ou um número seu, desde que ele não esteja registrado no WhatsApp. Se o número já tiver uma conta de WhatsApp ativa, apague essa conta antes de continuar.

Passo 3: Conecte sua conta da Meta

Clique em Continue with Facebook. Uma janela da Meta se abre. Faça login e autorize a Twilio a gerenciar sua Conta de WhatsApp Business.

Em seguida, crie ou selecione o seu Portfólio de Negócios (Business Manager). Se for um portfólio novo, você precisará concluir a verificação de negócio da Meta antes de ir para produção.

Passo 4: Defina a conta de WhatsApp e o nome de exibição

Crie uma nova Conta de WhatsApp Business (WABA) ou selecione uma existente. Defina o nome de exibição — é o nome que seus clientes verão no topo da conversa.

Dica: use o nome real da empresa, sem termos promocionais ou proibidos. Nomes fora das diretrizes são recusados pela Meta, e o número fica limitado a poucas mensagens por dia até a correção.

Passo 5: Verifique o número

A Meta envia um código de verificação por SMS ou ligação, conforme o tipo do número. Digite o código para confirmar que o número é seu. Números de SMS da Twilio mostram o código no próprio Console; números de voz recebem por ligação ou e-mail.

Passo 6: Aguarde a aprovação da Meta

Depois do registro, a Meta analisa a verificação do negócio e o nome de exibição. Enquanto a aprovação não sai, o número funciona com limite reduzido (cerca de 250 conversas iniciadas por dia). Após aprovado, os limites aumentam e você pode operar normalmente.

Passo 7: Copie as credenciais na Twilio

No painel inicial da Twilio (Account Info), copie dois valores:

Credencial	Onde usar
Account SID	Identifica a sua conta (começa com AC)
Auth Token	Senha de acesso da conta — clique em Show para revelar

Anote também o número aprovado do remetente, no formato internacional (por exemplo, +5548999990000).

Aviso: o Auth Token é secreto. Não compartilhe e, se ele for exposto, gere um novo no próprio Console da Twilio.

Passo 8: Ative a conexão no sistema

No sistema, abra as configurações da conexão de WhatsApp do CRM. No campo Como conectar o WhatsApp, escolha a opção API Oficial (via Twilio).

Preencha os campos com o que você copiou:

• Account SID — o identificador que começa com AC
• Número de envio — o número aprovado (ex.: +5548999990000)
• Auth Token — o token de autenticação da Twilio

Clique em Salvar e deixe o rastreamento ativo.

Passo 9: Ligue o webhook de entrada

Para as mensagens que chegam aparecerem no CRM, a Twilio precisa avisar o sistema. Na tela de conexão, copie a URL do webhook (Twilio) que aparece.

De volta ao Console da Twilio, no remetente de WhatsApp (ou no Messaging Service ligado a ele), cole essa URL no campo When a message comes in e salve.

Nota: cole a URL exatamente como aparece na tela, sem tirar nem acrescentar nada. É por ela que o sistema identifica a sua empresa e casa a conversa com a origem do cliente.

Passo 10: Faça um teste real

Do seu celular, envie uma mensagem para o número oficial da empresa. Ela deve aparecer na caixa de entrada do CRM em segundos. Responda pela tela do atendimento e confirme que a resposta chega no WhatsApp. Com a ida e a volta funcionando, a conexão está pronta.

Erros comuns

• Número já registrado no WhatsApp: use outro número ou apague a conta de WhatsApp existente daquele número antes de registrar.
• Nome de exibição recusado: ajuste o nome seguindo as diretrizes da Meta (nome real, sem promoções). Enquanto isso, o número fica com limite reduzido.
• Conta Twilio em teste: adicione saldo. A conta de teste não envia para números reais fora do sandbox.
• A mensagem não chega ao CRM: confirme que a URL do webhook está idêntica à da tela e que o rastreamento está ativo.
• Não consigo iniciar conversa após 24h: fora da janela de 24 horas desde a última mensagem do cliente, a Meta só permite enviar por modelo (template) aprovado. Dentro das 24h, a resposta é livre.

Próximos passos

• Cadastre respostas rápidas e organize os atendimentos na caixa de entrada do CRM.
• Configure a distribuição das conversas entre os atendentes da equipe.
• Acompanhe a origem de cada conversa (campanha, anúncio) direto no CRM.