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: ## 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.