Integração com WhatsApp utilizando a Twilio
Este guia cobre todo o processo de integração com WhatsApp via Twilio: criação de conta, compra de número, aprovação do WhatsApp e configuração da integração no EvaGPT.
1. Requisitos para criação de conta
Requisitos para a criação de conta:
- Grupo de e-mail no domínio do cliente contendo as partes interessadas
- Comprovante de endereço atualizado
- Cartão CNPJ
Exemplo de grupo de e-mail: [email protected]
2. Criando conta no Twilio
Acesse o site: https://www.twilio.com/
Localize a opção Sign up na página inicial e preencha as informações do representante da empresa conforme os campos solicitados.
Um e-mail de verificação será enviado para o endereço de e-mail cadastrado. Informe o número de telefone no qual fará acesso à plataforma — o Twilio enviará um código de verificação por esse número.
Com a validação realizada, será carregada uma nova página para preenchimento do cadastro. Após concluir esse formulário, o cadastro junto à plataforma estará finalizado.
3. Regulatory Compliance
Para acessar o Regulatory Compliance, localize a opção # Phone Numbers e fixe-a. Clique em # e localize a opção Regulatory Compliance.
Acesse o menu Bundles e clique em Create a Regulatory Bundle. Nesta etapa será necessária a criação de um tipo de número Local e Mobile — o processo é igual para ambos.
Selecione o país no qual será contratado o número de telefone, selecione o tipo de número como Local e, em seguida, selecione a opção Business. Certifique-se de que a opção marcada seja Enter new business information.
É recomendado que os campos Friendly name e Business Name sejam nomeados com o nome do cliente seguido do tipo de número.
Exemplo: Intelliway - Local
Após preencher os campos, clique em Save. Em seguida, valide as informações e clique em Next.
Para o passo seguinte, será necessário o cartão CNPJ e um comprovante que valide o endereço da empresa. Após o envio da documentação, será aberta uma tela de notificação na qual será necessário validar o e-mail e salvar.
4. Comprando Número
Acesse o menu # Phone Numbers e localize a opção Buy a Number.
Na aba Buy a Number, selecione o país no qual deseja realizar a compra e, no campo Number, informe o DD desejado. Clique em Search para ver os números disponíveis e clique em Buy para adquirir o número escolhido.
5. Redirecionamento de chamada (aprovação do WhatsApp)
Desde 2022, a aprovação do WhatsApp é feita dentro do próprio Twilio, em um modelo self-service.
Passo 1: Configuração do redirecionamento de chamada (webhook)
Estando logado na conta do cliente, clique em Active numbers dentro de Phone Numbers → Manage, e selecione o número que deseja aprovar.
Na seção Voice & Fax, na opção A CALL COMES IN, selecione Webhook e informe a URL a seguir, substituindo 9xxxxxxx5 por um número de telefone celular válido e conhecido: http://twimlets.com/forward?PhoneNumber=+5527xxxxxxxxx
Clique em Save no final da página.
Passo 2: Solicitando aprovação do WhatsApp
Clique em WhatsApp senders, dentro de Messaging → Senders.
Na seção 1. Select a phone number to register, mantenha Twilio phone number marcado, selecione o número desejado em Select Twilio number e clique em Continue.
Na seção 2. Link WhatsApp Business Account with your number, clique em Log in with Facebook. Na janela aberta, clique em Continuar como... se já estiver logado com a conta do cliente, ou em Entrar em outra conta para usar outras credenciais.
Siga as orientações tela a tela. Quando solicitado, informe o número adquirido do Twilio, marque a opção Ligação de voz e clique em Enviar código. O telefone configurado no Passo 1 tocará e o código será fornecido em português 3 vezes. Insira o código no campo indicado — se não houver problemas com as políticas do Facebook/WhatsApp, a conta será validada imediatamente.
6. Configurando o Twilio
Com a conta criada e validada, volte à plataforma da Twilio, clique em Messaging e depois em WhatsApp Senders. Localize o número que deseja vincular ao EvaGPT e confira se o status está como Online.
Role até a seção Endpoint configuration e marque Use Webhooks. Preencha o campo Webhook URL for incoming messages com: https://whatsappconnector.intellidevs.com.br/receive
O campo Webhook method for incoming messages URL deve estar como HTTP Post.
(Opcional) Business profile information
Logo abaixo de "Endpoint configuration" está a seção Business profile information, onde você edita as informações exibidas ao cliente no WhatsApp. O nome da empresa já vem preenchido automaticamente; para alterá-lo, é necessário abrir um ticket diretamente na plataforma da Twilio. As demais informações são opcionais e editáveis nessa seção. Ao concluir, clique em Update WhatsApp Sender.
Account Info
Acesse https://console.twilio.com/ e role até a seção Account Info. Copie as informações dos campos AccountSID e Auth Token — serão usadas na configuração do EvaGPT a seguir.
7. Configurando o EvaGPT
No menu principal à esquerda do EvaGPT, clique em Criar Integração, depois em Whatsapp e escolha a plataforma Twilio.
Preencha Nome da Integração e Descrição com informações que ajudem você e sua equipe a identificar a integração. No campo Agente, selecione o agente treinado para atender as solicitações do WhatsApp. No campo Número do telefone (Produção), informe o número cadastrado na Twilio, no formato indicado.
- Cada número do WhatsApp deve estar vinculado a apenas um agente por vez. É possível trocar o agente da integração quando desejar, mas a plataforma impede criar uma nova integração com um número já em uso em outra integração.
- Não use um número do WhatsApp que já esteja integrado a outro serviço, nem use em outro serviço um número já vinculado ao EvaGPT — isso fará um dos dois parar de funcionar.
Clique em Configurações Avançadas e cole o AccountSID e o Auth Token copiados da Twilio. Clique em Salvar.
Recurso útil: Code Exchange
O Code Exchange da Twilio é um portal útil para encontrar code snippets prontos para integração.