Como configurar WhatsApp via Twilio

Suporte

Suporte

Última atualização em Jun 1, 2026

Use este guia quando você precisar configurar, entender ou validar Como configurar WhatsApp via Twilio na IAra.

Antes de começar na IAra

  • Confirme que seu usuário tem permissão para acessar a área citada no artigo.
  • Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
  • Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

Guia detalhado

Gerencie as conversas da sua conta comercial do WhatsApp através da IAra. Você tem duas opções de provedor:

  1. WhatsApp Cloud API (forma preferida)

  2. Twilio

Este guia orientará você no processo de configuração.

Pré-requisitos

  1. Um número de telefone válido

  2. Uma conta Twilio. Se você não tiver um, crie-o aqui: https://www.twilio.com/en-us/messaging/channels/WhatsApp

Usando a API Twilio

Existem duas maneiras de usar o Twilio com IAra:

  1. Maneira regular sem serviço de mensagens

  2. Com serviço de mensagens

Configurando o Twilio sem serviço de mensagens

Faça login em sua conta Twilio e clique em "Criar nova conta"

Preencha todos os campos obrigatórios e conclua o processo de criação da conta

Copie o SID da sua conta, token de autenticação e número de telefone. Se você ainda não adicionou um número de telefone à sua conta Twilio, faça-o antes de continuar.

Faça login em sua conta da IAra, clique em Configurações > Caixa de entrada > Adicionar caixa de entrada e selecione WhatsApp

Insira o SID da sua conta, token de autenticação e número do WhatsApp aqui

Adicione agentes para gerenciar sua caixa de entrada do WhatsApp

Vá para Configurações > Caixa de entrada, selecione sua caixa de entrada, clique em Configuração e copie o URL do seu webhook

Retorne ao painel do Twilio

  1. Vá para Console Twilio → Números de telefone → Gerenciar → Números ativos

  2. Clique no seu número do WhatsApp.

  3. Clique em Configurar

  4. Em Mensagens, marque o campo “Webhook (Quando chega uma mensagem)”.

  5. Atualize o URL do webhook.

É isso! Você está pronto para começar a enviar mensagens do WhatsApp através da IAra.

Configurando o Twilio com um serviço de mensagens

Configurar o Twilio com um serviço de mensagens requer etapas adicionais em comparação com a configuração normal.

Navegue até Mensagens > Serviços e clique no botão "Criar serviço de mensagens".

Preencha todos os campos obrigatórios nas etapas subseqüentes até chegar aqui. Copie o ID do seu serviço de mensagens e clique em “Salvar”.

Faça login em sua conta da IAra. Ao criar uma caixa de entrada, marque a caixa “Usar Twilio Message Service”. Em seguida, copie e cole seu ID da conta, ID do serviço de mensagens e token nos campos apropriados.

Vá para o painel do Twilio, navegue até Mensagens > Serviços > Selecionar serviço > Integração e cole seu URL do Webhook aqui.

É isso aí, está tudo pronto! Agora você pode começar a enviar mensagens do WhatsApp através da IAra.

Perguntas frequentes

Que tipos de modelos do WhatsApp a IAra suporta ao usar o Twilio?

Atualmente, IAra não oferece suporte a modelos com Twilio.

Estou usando o Twilio Studio. Existem etapas adicionais necessárias para que isso funcione?

Se você usar o Twilio Studio para um fluxo de conversa personalizado, atualizar diretamente o URL do webhook interromperá sua integração existente.

Em vez disso, siga estas etapas:

  1. Identifique a etapa do seu fluxo em que você deseja que a “transferência do agente” aconteça.

  2. Adicione um “widget de solicitação http” conforme mostrado abaixo com os valores fornecidos.

  3. Certifique-se de que seu fluxo possa lidar com as respostas do usuário às respostas do agente.


Como validar na IAra

  1. Execute o fluxo em uma conta ou conversa de teste.
  2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
  3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

Problemas comuns

  • Usuário sem permissão para acessar a configuração.
  • Nome de tela diferente entre versões ou contas.
  • Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
  • Falta de teste em conversa realista antes de liberar para a equipe.

Checklist final

  • [ ] Configuração revisada por um administrador.
  • [ ] Teste realizado com dado ou conversa controlada.
  • [ ] Impacto para agentes e gestores entendido.
  • [ ] Artigos relacionados revisados para evitar links quebrados.