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:
-
WhatsApp Cloud API (forma preferida)
-
Twilio
Este guia orientará você no processo de configuração.
Pré-requisitos
-
Um número de telefone válido
-
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:
-
Maneira regular sem serviço de mensagens
-
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
-
Vá para Console Twilio → Números de telefone → Gerenciar → Números ativos
-
Clique no seu número do WhatsApp.
-
Clique em Configurar
-
Em Mensagens, marque o campo “Webhook (Quando chega uma mensagem)”.
-
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:
-
Identifique a etapa do seu fluxo em que você deseja que a “transferência do agente” aconteça.
-
Adicione um “widget de solicitação http” conforme mostrado abaixo com os valores fornecidos.
-
Certifique-se de que seu fluxo possa lidar com as respostas do usuário às respostas do agente.
Como validar na IAra
- Execute o fluxo em uma conta ou conversa de teste.
- Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
- 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.