Twilio

Guia de Configuração Twilio para WhatsApp e Telegram

A Twilio é uma plataforma que oferece um conjunto de APIs (Interfaces de Programação de Aplicações) para simplificar a comunicação através de múltiplos canais. Para usar o Twilio para enviar e receber mensagens no WhatsApp e no Telegram, o primeiro passo é obter as suas credenciais de autenticação, seguidas pela configuração específica para cada canal.

1. Obtendo suas Credenciais Twilio

Para a maioria das integrações, você precisará de duas credenciais principais da sua conta Twilio: o Account SID e o Auth Token. Eles funcionam como um nome de usuário e uma senha para a sua conta, permitindo que você faça requisições à API da Twilio.

  1. Acesse o Painel da Twilio: Faça login no Twilio Console em https://www.twilio.com/console. Você será direcionado para o painel principal (Dashboard).

  1. Localize as Credenciais: Na seção Account Info do painel, você encontrará o seu Account SID (identificador único da sua conta) e o Auth Token.

  1. Revele o Auth Token: Por motivos de segurança, o Auth Token fica oculto por padrão. Para visualizá-lo, clique no ícone de olho (eye icon) ao lado dele.

Aviso de Segurança: Trate o Auth Token como uma senha. Não o compartilhe publicamente. Se ele for comprometido, regenere-o imediatamente.

2. Configuração para WhatsApp

A Twilio oferece duas formas de se conectar ao WhatsApp: a Sandbox (para testes rápidos) e a API Business (para uso em produção).

Método A: Configurando o Sandbox para testes

O Sandbox é uma forma de começar a testar a integração do WhatsApp imediatamente, usando um número de telefone compartilhado pela Twilio. Ele é ideal para prototipagem e desenvolvimento.

  1. Ative o Sandbox: No seu painel Twilio, navegue até Programmable Messaging > WhatsApp > Sandbox e ative-o. Você verá um número de telefone e uma palavra-chave de sandbox.

  2. Participe do Sandbox: Para começar, você deve enviar uma mensagem de opt-in do seu próprio número WhatsApp para o número do Sandbox, com o texto "join <sua palavra-chave>". A Twilio responderá com uma confirmação.

Limitações do Sandbox: O Sandbox é restrito e só permite que seu número envie mensagens para um único Sandbox por vez. Além disso, as mensagens são limitadas e o número é compartilhado com outros usuários Twilio.

Método B: Configurando um Remetente WhatsApp (para produção)

Para uma solução comercial completa, você precisa registrar um número próprio como um Remetente WhatsApp. Esse processo envolve a Twilio e a plataforma Meta Business Manager (Facebook Business Manager).

  1. Conecte sua Conta Business: No painel Twilio, navegue até Messaging > Senders > WhatsApp Senders. Siga as instruções para conectar sua conta Twilio ao seu Meta Business Manager. Você precisará fazer login na sua conta do Facebook e autorizar a Twilio a ter acesso à sua conta de negócios.

  2. Registre o Número: Você pode escolher um número de telefone Twilio ou conectar um número próprio. Se for seu próprio número, ele não pode já estar registrado no WhatsApp.

  3. Verifique o Número: Meta enviará um código de verificação para o número de telefone que você está registrando, que pode ser enviado via SMS ou chamada de voz.

  4. Verificação da Empresa: Para remover as limitações de envio de mensagens e obter o selo de Official Business Account, sua empresa deve ser verificada pelo Facebook Business Manager.

3. Configuração para Telegram

A Twilio não tem uma integração nativa e direta com o Telegram da mesma forma que com o WhatsApp, mas a conexão é feita através de plataformas de terceiros que atuam como pontes entre as APIs.

  1. Crie seu Bot no Telegram: O primeiro passo é criar um bot no próprio Telegram, utilizando o bot oficial chamado @BotFather. Use o comando /newbot e siga os passos para obter um token de API, que é a credencial do seu bot.

  2. Integre com uma Plataforma de Terceiros: Plataformas no-code como Buildship e Latenode permitem que você crie fluxos de trabalho que conectam as APIs do Twilio e do Telegram sem a necessidade de programação. Você usará o Account SID e o Auth Token da Twilio e o token do seu bot do Telegram.

  3. Defina a Lógica: Nesses construtores, você pode definir as ações do seu chatbot. Por exemplo, uma mensagem recebida pelo bot do Telegram pode acionar uma ação no Twilio para enviar uma notificação por SMS.

Resumindo

Integração do WhatsApp com o aiBlue

A extensão External Chatbot – WhatsApp Integration permite que você conecte seus chatbots da aiBlue ao WhatsApp usando o Twilio. Isso possibilita que os usuários conversem com seu bot diretamente no WhatsApp. A extensão também oferece o recurso de Atendente Humano, permitindo que sua equipe responda às mensagens do WhatsApp ao vivo a partir do painel da aiBlue.

Como Configurar a Integração com o WhatsApp

Passo 1: Habilitar o Canal do WhatsApp para o seu Bot

  1. No painel da sua conta aiBlue, vá para AI Bots.

  2. Abra as configurações do bot que você deseja conectar.

  3. Vá até a etapa Channel e selecione a opção WhatsApp.

Passo 2: Preencher os Campos de Configuração do WhatsApp

Nesta seção, você verá os campos para inserir os detalhes da sua conta Twilio.

Passo 3: Obter as Credenciais da sua Conta Twilio

  1. Faça login na sua conta Twilio.

  2. Copie o seu Account SID e o Auth Token.

  3. Cole essas informações nos campos correspondentes no painel da aiBlue.

Passo 4: Adicionar os Números de Telefone

  1. Insira o número de telefone Twilio e o número de telefone Sandbox nos campos relevantes no painel da aiBlue.

Passo 5: Salvar as Configurações e Obter a URL do Webhook

  1. Após inserir todos os detalhes, clique em Salvar.

  2. A aiBlue irá gerar uma Webhook URL para você.

Passo 6: Configurar o Webhook no Twilio

  1. Volte para o painel da sua conta Twilio.

  2. Nas configurações do WhatsApp, cole a Webhook URL fornecida pela aiBlue.

  3. Salve as alterações.

Tudo Pronto!

Seus usuários já podem conversar com o seu bot de IA pelo WhatsApp. Caso o recurso Atendente Humano esteja ativado, as conversas podem ser transferidas para um chat ao vivo, que pode ser gerenciado diretamente na página Atendente Humano do painel da sua conta aiBlue.

Configuração Simplificada com aiblue.dev

Se o processo de configuração parecer complexo, você tem a opção de contratar uma equipe especializada para realizar todo o set up para você.

Para contratar o serviço de set up direto com a A.I. Blue, você pode entrar em contato com a equipe de vendas e suporte. As informações de contato são:

  • Telefone: 11 97732-1743

  • E-mail: hi@aiblue.dev

  • Site: aiblue.dev

AnteriorTelegramPróximoONBOARDING

Atualizado