WhatsApp na IAra

Como conectar WhatsApp

Use este guia quando você precisar configurar, entender ou validar Como conectar WhatsApp 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 Você pode gerenciar as conversas da sua conta comercial do WhatsApp diretamente da IAra. Para conectar seu número do WhatsApp, a IAra oferece suporte a dois métodos de integração: - Inscrição incorporada (recomendado) – um fluxo guiado desenvolvido pela Meta que configura automaticamente seu número, webhooks e tokens. - Configuração manual – uma opção avançada para provedores de tecnologia e casos em que a inscrição incorporada não pode ser usada. Este guia oferece uma visão geral de ambos os métodos, suas diferenças e links para instruções detalhadas passo a passo. Pré-requisitos - Um desenvolvedor Meta (Facebook) ou conta comercial - Um número de telefone válido (ainda não vinculado a outro fluxo de inscrição incorporada do WhatsApp, a menos que esteja migrando) - Um espaço de trabalho IAra com recurso WhatsApp ativado Etapa 1: vá para as caixas de entrada 1. Faça login em sua conta da IAra. 2. Navegue até Configurações › Caixas de entrada › Adicionar caixa de entrada. Na tela: Comece em Configurações > Caixas de entrada e clique para adicionar uma nova caixa. caixas. Etapa 2: Escolha seu método de configuração Ao criar uma caixa de entrada do WhatsApp, você verá duas opções: Na tela: Depois de escolher WhatsApp, revise a caixa criada e confirme se ela aparece na lista de canais. WhatsApp. - Redireciona você para o fluxo de inscrição incorporado do Meta. - Você faz login com sua conta do Facebook, seleciona ou cria uma conta comercial do WhatsApp (WABA) e adiciona seu número de telefone. - IAra recebe automaticamente o webhook, tokens e configuração do número de telefone. Use esta opção se você: - Adicionando um novo número do WhatsApp - Procurando a configuração mais rápida e sem configuração - Não é um provedor de tecnologia que integra seu próprio número [Leia o guia completo sobre inscrição incorporada no WhatsApp] Configuração manual - Você configura tudo através do Meta Developer Console. - Requer geração de tokens, criação de um usuário do sistema, atribuição de ativos e configuração manual de webhooks. - Você copia/cola o ID do número de telefone, o ID da conta comercial e a chave API na IAra. Use esta opção se você: - Um provedor de tecnologia integrando seu próprio número - Reutilizando um número que já está vinculado ao Embedded Signup - Confortável trabalhando com o painel Meta Developer [Leia o guia completo sobre configuração manual] 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.

Como reconectar WhatsApp

Use este guia quando você precisar resolver ou investigar: Como reconectar WhatsApp. Quando usar este guia Use quando o WhatsApp parou de receber ou enviar mensagens, aparece como desconectado, perdeu sessão ou precisa ler um novo QR Code. Antes de começar - Confirme qual caixa de entrada está desconectada. - Tenha acesso ao celular ou instância vinculada ao número. - Avise a equipe que o canal pode ficar instável durante a reconexão. - Separe um número externo para teste. Diagnóstico passo a passo 1. Abra Configurações -> Caixas de entrada e localize a caixa do WhatsApp afetada. 2. Confira se o problema é só no WhatsApp ou se outros canais também apresentam falha. 3. Entre nas configurações da caixa e verifique o status da conexão. 4. Se houver botão de reconectar, gere uma nova sessão ou novo QR Code. 5. No celular, abra WhatsApp -> Aparelhos conectados -> Conectar aparelho. 6. Leia o QR Code assim que ele aparecer e aguarde a confirmação no painel. 7. Não faça várias tentativas seguidas sem aguardar; isso pode aumentar instabilidade. 8. Depois da conexão, mantenha celular/instância com internet estável quando o modelo de conexão depender disso. Como testar - Envie uma mensagem de um número externo para o WhatsApp conectado. - Confirme se a conversa aparece na caixa correta. - Responda pela IAra e confirme se a mensagem chega no WhatsApp do cliente. - Teste uma segunda mensagem depois de alguns minutos para garantir que a sessão não caiu de novo. Problemas comuns e leitura do resultado - QR Code lido, mas status continua desconectado: atualize a página e aguarde alguns minutos antes de nova tentativa. - Mensagem chega no celular, mas não aparece na IAra: a sessão pode não estar vinculada à caixa correta. - Mensagem aparece na IAra, mas não envia: pode haver instabilidade, bloqueio, limite do provedor ou falha de sessão. - Número conectado em outro sistema: a sessão anterior pode derrubar a conexão da IAra. Evidências para salvar - Nome da conta. - Nome da caixa de entrada. - Número do WhatsApp. - Horário da queda ou reconexão. - Print do status da caixa. - Print do erro ou da tentativa de envio, se houver. Quando abrir chamado - Abra chamado se a reconexão falhar após duas tentativas bem feitas. - Abra chamado se o QR Code não aparecer. - Abra chamado se conectar, mas cair de novo em poucos minutos. - Abra chamado se mensagens continuam presas após reconexão validada. Checklist final - [ ] Canal, caixa de entrada ou assistente correto identificado. - [ ] Teste controlado realizado com horário anotado. - [ ] Prints e links relevantes salvos. - [ ] Causa provável registrada. - [ ] Chamado aberto apenas se o diagnóstico local não resolver.

O que fazer quando o QR Code expira

Use este guia quando você precisar resolver ou investigar: O que fazer quando o QR Code expira. Quando usar este guia Use quando o QR Code do WhatsApp vence antes da leitura, carrega em branco ou não conclui a autenticação. Antes de começar - Deixe o celular desbloqueado e com WhatsApp aberto. - Confirme se a câmera consegue focar a tela. - Evite tentar em rede instável. - Use navegador atualizado e, se possível, janela sem extensões bloqueando scripts. Diagnóstico passo a passo 1. Atualize a tela de conexão e gere um novo QR Code. 2. No WhatsApp, acesse Aparelhos conectados antes de gerar o código, para ganhar tempo. 3. Leia o QR Code imediatamente após aparecer. 4. Aguarde a confirmação no painel da IAra antes de sair da tela. 5. Se expirar de novo, feche outras abas da IAra e tente em janela anônima. 6. Se a tela ficar em branco, limpe cache ou teste outro navegador. Como testar - Depois de conectar, envie uma mensagem de teste para o número. - Responda pela IAra. - Anote horário da conexão e do teste. Problemas comuns e leitura do resultado - QR expira por demora: prepare o celular antes de gerar o código. - QR não aparece: pode ser cache, bloqueador, sessão travada ou instabilidade. - QR lido mas não conecta: pode haver sessão anterior, internet instável ou conflito com outro provedor. Evidências para salvar - Print da tela sem QR ou com erro. - Horário da tentativa. - Navegador usado. - Número do WhatsApp. - Nome da caixa de entrada. Quando abrir chamado - Abra chamado se o QR não aparecer em dois navegadores diferentes. - Abra chamado se a leitura conclui no celular, mas a IAra não muda o status. - Abra chamado se o QR expira imediatamente após ser gerado. Checklist final - [ ] Canal, caixa de entrada ou assistente correto identificado. - [ ] Teste controlado realizado com horário anotado. - [ ] Prints e links relevantes salvos. - [ ] Causa provável registrada. - [ ] Chamado aberto apenas se o diagnóstico local não resolver.

Diferença entre WhatsApp por QR Code, API oficial e integrações

Use este guia quando você precisar configurar e usar este recurso com clareza operacional. Quando usar este guia Use este guia para resolver ou revisar Diferença entre WhatsApp por QR Code, API oficial e integrações na IAra com mais segurança, sem depender de tentativa e erro. Na tela: Use a lista de caixas para identificar qual conexão de WhatsApp está ativa antes de comparar os métodos. caixas WhatsApp. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Passo a passo operacional 1. Acesse a área correspondente no painel da IAra. 2. Revise se você está na conta, caixa de entrada, time ou assistente correto. 3. Faça a configuração ou ação descrita pelo artigo. 4. Teste usando um cenário realista, mas controlado. 5. Confirme se o resultado aparece para quem precisa operar: agente, gestor, cliente ou suporte. 6. Documente qualquer diferença de tela para ajustar o artigo antes da publicação. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Como configurar WhatsApp API oficial por Embedded Signup

Use este guia quando você precisar configurar, entender ou validar Como configurar WhatsApp API oficial por Embedded Signup 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 O que é a inscrição incorporada no WhatsApp? Inscrição incorporada é uma interface baseada em navegador fornecida pela Meta que autentica um usuário do Facebook, cria (ou vincula) uma conta comercial do WhatsApp (WABA), adiciona um número de telefone e retorna credenciais de produção em um fluxo. A IAra Cloud incorpora essa interface quando você escolhe o WhatsApp Cloud ao adicionar uma caixa de entrada, portanto, não são necessários tokens manuais ou URLs de webhook. Resumo dos pré-requisitos - Login do Facebook (Meta) - Informações comerciais - Espaço de trabalho IAra Cloud com recurso WhatsApp habilitado Fluxo de trabalho de integração na IAra Etapa 1. Vá para Configurações → Caixas de entrada → “Adicionar caixa de entrada”. Selecione WhatsApp. Na tela: Comece pela lista de caixas de entrada e escolha WhatsApp para iniciar a conexão oficial. conectar WhatsApp. Pontos de verificação de conformidade 1. Verificação comercial: Carregue documentos legais se o Meta solicitar durante ou após a inscrição 2. Revisão do nome de exibição: certifique-se de que o nome de exibição do WhatsApp corresponda às diretrizes da marca para evitar rejeição 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.

Como configurar WhatsApp API oficial manualmente

Use este guia quando você precisar configurar, entender ou validar Como configurar WhatsApp API oficial manualmente 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 Você pode gerenciar as conversas da sua conta comercial do WhatsApp no IAra. Para configurá-lo, você tem duas opções para escolher seu provedor: 1. API de nuvem do WhatsApp 2. Twilio Explicaremos todos os procedimentos neste guia. Pré-requisitos 1. Você precisa de uma Meta conta de desenvolvedor para configurar a API do WhatsApp. Se você ainda não tem uma conta de desenvolvedor, clique aqui para criar uma antes de continuar 2. Um número de telefone válido Usando API do WhatsApp Cloud WhatsApp Cloud API está disponível para todas as empresas e desenvolvedores individuais. Como ele está hospedado na infraestrutura de nuvem do Meta, você não precisa mais usar provedores terceirizados como Twilio, Zendesk, 360Dialog ou MessageBird (Business Solution Providers) para hospedar sua API do WhatsApp Business. Configure o perfil da sua empresa Crie um perfil comercial profissional no WhatsApp com o nome da sua empresa, descrição e informações de contato. Um perfil bem elaborado ajuda os clientes a reconhecer e confiar em sua marca quando interagem com você. Faça login em https://business.facebook.com e clique no botão criar portfólio no menu suspenso em Página inicial Preencha todos os campos obrigatórios para configurar seu portfólio de negócios. Depois de criar seu portfólio de negócios, é hora de criar seu aplicativo do Facebook. Configure seu aplicativo do Facebook Faça login em https://developers.facebook.com/ e clique no botão Criar aplicativo. Preencha os campos obrigatórios Clique em "Outro" nas opções Escolha "Comercial" como seu tipo de aplicativo Digite seu endereço de e-mail de contato e escolha seu portfólio de negócios no menu suspenso. Adicione o WhatsApp ao seu aplicativo Depois de criar seu aplicativo, você será direcionado para o painel do aplicativo. A partir daí, clique em "Adicionar Produto" e escolha WhatsApp na lista de produtos disponíveis. Clique no botão "Configurar" do WhatsApp Observação: Antes de continuar, verifique sua empresa com Meta. Você precisará enviar documentação para verificação, que é necessária para acesso completo à API. Configurar um token de acesso permanente à API do WhatsApp Cloud Você precisará criar um Usuário do sistema e gerar um token permanente para manter acesso seguro e ininterrupto. Faça login em sua conta de desenvolvedor do Facebook, selecione seu aplicativo WhatsApp e navegue até a página de configurações empresariais. Clique em "Usuários do sistema" e adicione um novo usuário do sistema com a função Admin Clique no botão “Adicionar ativos”, selecione o nome do seu aplicativo, escolha a opção “Controle total” e clique em “Atribuir ativos”. Retorne à página usuários do sistema, selecione o usuário do sistema recém-criado na lista e clique no botão "Gerar novo token". Selecione seu aplicativo no menu suspenso Selecione estes três níveis de permissão para seu token: *whatsapp_business_manage_events *whatsapp_business_management *whatsapp_business_messaging Copie e salve seu token Configurar a API do WhatsApp Cloud Para criar uma nova conta empresarial Meta, selecione "criar uma conta empresarial" no menu suspenso. Se você já possui uma conta empresarial, pode selecioná-la entre as opções existentes. Estou selecionando "criar uma conta comercial". Clique no botão continuar. Cole seu token permanente aqui Adicione seu número de telefone pronto para produção Depois de adicionar e verificar seu número de telefone, a próxima etapa é configurar um webhook para receber mensagens recebidas. Conectando sua conta da IAra Vamos conectar sua conta da IAra com sua API WhatsApp Cloud Copie o ID do seu número de telefone do WhatsApp e o ID da conta comercial desta seção Faça login em sua conta da IAra, vá em Configurações > Caixa de entrada e selecione Canal WhatsApp Insira seu número de telefone, ID do número de telefone e ID comercial na configuração da API do WhatsApp Adicione membros da equipe à sua caixa de entrada do WhatsApp Copie o URL do webhook e o token de verificação do webhook fornecidos aqui Configure seu webhook Precisamos configurar o webhook do WhatsApp para receber mensagens de clientes enviadas para o seu número comercial. Seu URL de retorno de chamada deve seguir o formato exibido pela própria IAra na configuração da caixa de entrada, por exemplo https://app.digi2b.com/webhooks/WhatsApp/{phone_number}. Faça login em sua conta de desenvolvedor do Facebook e navegue até WhatsApp > Configuração Cole o URL do webhook da IAra e o token de verificação aqui e clique em "Verificar e salvar" Configure permissões de webhook assinando mensagens É isso aí, está tudo pronto! Agora você pode começar a enviar mensagens do WhatsApp através da IAra. Perguntas frequentes Como configurar vários números em um único aplicativo do Facebook? O aplicativo do Facebook permite configurar apenas um único endpoint Webhook. Portanto, crie caixas de entrada na IAra para todos os números conforme necessário. Você precisará configurar o URL do Webhook fornecido para apenas uma dessas caixas de entrada no aplicativo do Facebook para que todas as outras caixas de entrada funcionem. Que tipo de modelos do WhatsApp são suportados pela IAra? Para detalhes sobre modelos, veja Como usar templates de WhatsApp. Quais são os tipos de mídia suportados? 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.

Como configurar WhatsApp via Twilio

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.

Como usar templates de WhatsApp

Use este guia quando você precisar configurar, entender ou validar Como usar templates de WhatsApp 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 Os modelos do WhatsApp são formatos de mensagens pré-aprovados que permitem iniciar conversas com seus clientes. Eles são essenciais para enviar mensagens promocionais, atualizações de pedidos e notificações de suporte através do WhatsApp Business Platform. Na tela: A tela de Modelos Meta é onde você confere os templates disponíveis para envio. modelos Meta. O que são modelos do WhatsApp? Os modelos do WhatsApp são mensagens estruturadas que devem ser aprovadas pelo WhatsApp antes de serem enviadas aos clientes. Eles ajudam a garantir a conformidade com as políticas de mensagens do WhatsApp, ao mesmo tempo que permitem enviar comunicações profissionais e consistentes. Os modelos podem incluir: - Mensagens de texto com variáveis personalizadas - Imagens, vídeos ou documentos como cabeçalhos - Botões de ação para respostas rápidas dos clientes - Botões de call to action com links para sites ou números de telefone Categorias de modelos O WhatsApp organiza os modelos em diferentes categorias com base na sua finalidade: - Utilitário - Mensagens transacionais como confirmações de pedidos e recibos - Marketing – Conteúdo promocional e ofertas especiais - Atualização de envio - Atualizações de entrega e status do pacote - Atualização de tickets - Notificações de casos de suporte - Resolução de problemas - Acompanhamento de atendimento ao cliente O que não é compatível Modelos de autenticação - AUTENTICAÇÃO modelos com códigos OTP e mensagens de verificação - Preenchimento automático de parâmetros de botão com valores OTP - Validação OTP e tratamento do tempo de expiração Componentes interativos - LISTA modelos com opções selecionáveis - PRODUCT modelos com integração de catálogo - CATALOG modelos para navegação de produtos - Componentes de seleção múltipla Componentes de permissão de chamada - CALL_PERMISSION_REQUEST modelos que exigem API de chamada do WhatsApp ativada - Botões de permissão de chamada e componentes de chamada interativos Componentes de localização - LOCATION cabeçalhos com coordenadas do mapa - Endereço parâmetros com latitude/longitude - Modelos baseados em localização Recursos avançados - Formatação rich text na criação do modelo (preservada no envio) - Modelos de carrossel com vários cartões - Formulário componentes para coleta de dados - Pagamento modelos de integração - Modelos de fluxo com lógica condicional Modelos legados versus modelos aprimorados IAra oferece suporte a dois formatos de modelo para garantir compatibilidade com todos os seus modelos existentes: Modelos legados Estes são modelos tradicionais que usam variáveis de texto simples. Eles trabalham com: - Mensagens de texto básicas - Substituição simples de variáveis (como inserir o nome do cliente) - Interações diretas com botões Exemplo de formato legado: { "parâmetros": ["John Doe", "12345", "2025-01-15"] } ⚠️ Importante: O suporte a modelos legados será descontinuado na versão 4.7. Recomendamos a migração para modelos aprimorados para garantir funcionalidade contínua. Modelos aprimorados O novo formato aprimorado oferece recursos mais sofisticados: - Suporte de mídia - Envie imagens, vídeos e documentos - Variáveis avançadas – Personalização de texto mais flexível - Botões interativos – botões de URL com links dinâmicos, códigos de cópia e respostas rápidas - Melhor validação - Verificação em tempo real dos parâmetros do seu modelo Exemplo de formato aprimorado: { "corpo": { "1": "John Doe", "2": "12345", "3": "15/01/2025" }, "cabeçalho": { "media_url": "https://example.com/image.jpg", "media_type": "imagem" }, "botões": [ { "tipo": "url", "parâmetro": "track123" } ] } Observação: todos os seus modelos legados existentes continuam funcionando por enquanto, mas você deve planejar a transição para modelos aprimorados. Os recursos aprimorados ficam automaticamente disponíveis quando você usa tipos de modelos compatíveis. Verifique esta API para saber mais sobre os formatos de solicitação. Como criar modelos de WhatsApp Atualmente, os modelos do WhatsApp devem ser criados através do WhatsApp Business Manager: 1. Acesse o gerenciador de negócios do WhatsApp - Acesse business.facebook.com 2. Navegue até os modelos - Encontre a seção "Ferramentas de conta" e selecione "Modelos de mensagem" 3. Criar novo modelo - Clique em "Criar modelo" e escolha o tipo de modelo 4. Crie seu modelo - Adicione cabeçalho, corpo, rodapé e botões conforme necessário 5. Enviar para aprovação - O WhatsApp analisará seu modelo (isso pode levar até 24 horas) 6. Sincronizar com IAra - Depois de aprovados, os modelos aparecerão automaticamente ou você pode sincronizar manualmente os modelos via caixa de entrada na IAra 🚀 Em breve: Estamos planejando adicionar a criação de modelos diretamente na interface da IAra em uma versão futura, facilitando o design e o gerenciamento de seus modelos sem sair da IAra. Como enviar modelos do WhatsApp Os modelos do WhatsApp podem ser enviados de duas maneiras: - Conversas individuais - Envie modelos para clientes específicos durante conversas - Campanhas - Envie modelos para vários clientes de uma só vez usando o recurso de campanha da IAra Enviando modelos em conversas Etapa 1: acessar opções de modelo Abra qualquer conversa com um contato do WhatsApp, clique no ícone de modelo no compositor de mensagens, selecione "Modelos do WhatsApp" no menu suspenso Etapa 2: Escolha seu modelo Navegue pelos seus modelos aprovados, use a barra de pesquisa para encontrar modelos específicos rapidamente Etapa 3: Personalize sua mensagem Dependendo do tipo de modelo, pode ser necessário preencher: Para modelos de texto: - Nome do cliente, número do pedido ou outras informações personalizadas - Quaisquer campos variáveis marcados com {{1}}, {{2}}, etc. Para modelos de mídia: - URL de imagem/vídeo - Forneça um link direto para seu arquivo de mídia - URL do documento – Link para PDFs, documentos do Word ou outros arquivos - A mídia deve ser acessível publicamente (não é necessário fazer login) Para modelos de botão: - Parâmetros de URL – Links dinâmicos para botões de call to action - Copiar códigos - Códigos de desconto ou códigos de referência - Números de telefone – Para botões clique para ligar Etapa 4: visualizar e enviar 1. Revise sua mensagem no painel de visualização 2. Verifique se todas as variáveis estão preenchidas corretamente 3. Verifique se os URLs de mídia estão funcionando (se aplicável) 4. Clique em "Enviar modelo" para entregar sua mensagem Envio de modelos por meio de campanhas Para enviar modelos para vários clientes de uma só vez: Vá para WhatsApp Campanhas no painel da IAra, crie uma nova campanha e selecione WhatsApp como canal Escolha seu modelo de WhatsApp entre as opções disponíveis e configure seu público e parâmetros de modelo Observação: A funcionalidade da campanha permite que você alcance vários clientes de forma eficiente com o mesmo modelo de mensagem. Perguntas frequentes (FAQ) Perguntas Gerais Por que não consigo ver todos os meus modelos do WhatsApp na IAra? Somente modelos aprovados pelo WhatsApp e suportados pela IAra aparecerão. Os tipos de modelos não suportados (como modelos de autenticação com códigos OTP) são automaticamente filtrados. Quanto tempo leva para novos modelos aparecerem na IAra? Os modelos normalmente são sincronizados automaticamente após algum tempo e você também pode atualizá-los manualmente nas configurações da caixa de entrada. Posso editar modelos diretamente na IAra? Não, os modelos devem ser criados e editados no WhatsApp Business Manager. IAra é usado apenas para envio de modelos aprovados. Por que preciso fornecer URLs para imagens e vídeos? O WhatsApp exige que os arquivos de mídia sejam hospedados online e acessíveis ao público. Você não pode fazer upload de arquivos diretamente – você deve fornecer URLs funcionais para seu conteúdo de mídia. Posso usar o mesmo modelo para clientes diferentes? Sim! Os modelos são projetados para serem reutilizados. Basta preencher diferentes informações do cliente cada vez que enviar o modelo. Solução de problemas Meu modelo não é enviado. O que devo verificar? Problemas comuns incluem: - Variáveis ausentes - Certifique-se de que todos os campos obrigatórios sejam preenchidos - URLs de mídia quebrados - Verifique se os links de imagem/vídeo/documento funcionam - Tamanho do arquivo muito grande - Verifique se os arquivos de mídia atendem aos limites de tamanho do WhatsApp - Modelo não aprovado - Confirme o status do modelo no WhatsApp Business Manager Por que os clientes não conseguem ver minhas imagens/vídeos? Isso geralmente significa: - O URL não é acessível publicamente - O formato do arquivo não é suportado - O arquivo é muito grande - O servidor de hospedagem está inoperante ou requer autenticação Meus botões de URL não funcionam corretamente. Como faço para corrigir isso? Para modelos com botões de URL dinâmicos, existem problemas conhecidos com determinadas configurações de modelo. Tente usar URLs estáticos em vez de parâmetros dinâmicos para obter funcionalidades mais confiáveis. Posso enviar modelos para clientes que não me enviaram mensagens primeiro? Sim, mas apenas para determinadas categorias de modelos: - Modelos de utilitários podem ser enviados a qualquer momento para fins transacionais - Modelos de marketing exigem a aceitação do cliente e têm janelas de envio específicas *Siga sempre as diretrizes de conformidade do WhatsApp para sua região Mídia e arquivos Que tipos de arquivo posso usar em modelos? Os formatos suportados incluem: - Imagens: JPEG, PNG (menos de 5 MB) - Vídeos: MP4, 3GPP (menos de 16 MB) - Documentos: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT (menos de 100 MB) Conformidade e limites Quantos modelos posso enviar por dia? Isso depende dos limites da sua conta do WhatsApp Business e das cotas de mensagens. Entre em contato com o suporte do WhatsApp para saber os limites específicos da sua conta. Existem restrições sobre quando posso enviar modelos de marketing? Sim, os modelos de marketing têm janelas de envio específicas e exigem a aceitação do cliente. Verifique as políticas atuais do WhatsApp para sua região e tipo de negócio. O que acontece se eu enviar muitas mensagens? O WhatsApp monitora a qualidade das mensagens e as taxas de entrega. O envio de muitas mensagens malsucedidas ou indesejadas pode afetar os limites de mensagens e as taxas de aprovação de modelos da sua conta. Precisa de mais ajuda? Se você estiver enfrentando problemas não abordados neste guia: 1. Verifique o status do modelo no WhatsApp Business Manager 2. Verifique se os URLs de mídia estão funcionando e acessíveis publicamente 3. Teste com dados de amostra antes de enviar aos clientes 4. Entre em contato com seu administrador da IAra para questões específicas da conta 5. Revise os modelos de políticas do WhatsApp para questões de conformidade Lembre-se de que os modelos do WhatsApp são uma ferramenta poderosa para comunicação com a pessoa atendida quando usados corretamente. Concentre-se em fornecer valor aos seus clientes com mensagens relevantes e oportunas que respeitem suas preferências.PI 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.

Como criar mensagens ativas com template

Use este guia quando você precisar usar um modelo pronto sem transformar a operação em respostas genéricas. Quando usar este guia Use este guia para resolver ou revisar Como criar mensagens ativas com template na IAra com mais segurança, sem depender de tentativa e erro. Na tela: Antes de enviar mensagem ativa, confirme se o template aparece aprovado na tela de modelos. template WhatsApp. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Como usar o modelo 1. Copie o modelo para um rascunho interno antes de aplicar na IA. 2. Substitua nomes, horários, regras, serviços e limites da empresa. 3. Remova qualquer promessa que dependa de humano, agenda, pagamento ou sistema externo. 4. Teste com perguntas fáceis, difíceis e fora do escopo. 5. Só publique depois de validar tom, segurança e transferência para humano. Modelo base editável Você é o assistente da [empresa]. Responda com clareza, educação e objetividade. Use apenas informações disponíveis na base de conhecimento. Quando não souber responder, quando a pessoa atendida pedir humano ou quando o assunto envolver exceção, transfira para o time responsável. Não invente valores, prazos, diagnósticos, políticas ou promessas. Critérios de qualidade - A resposta precisa ser curta o suficiente para o canal, mas completa o suficiente para resolver a dúvida. - A IA deve perguntar uma coisa por vez quando precisar coletar dados. - Todo limite importante precisa estar escrito de forma explícita. - A transferência para humano deve ser tratada como parte do fluxo, não como falha. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Pesquisas CSAT por WhatsApp usando templates

Use este guia quando você precisar configurar, entender ou validar Pesquisas CSAT por WhatsApp usando templates na IAra. Antes de começar na IAra Na tela: Para CSAT por WhatsApp, revise primeiro o template que será usado na pesquisa. template CSAT. - 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 As pesquisas de satisfação do cliente (CSAT) ajudam você a entender o quão satisfeitos os clientes estão com o suporte que recebem no WhatsApp. A IAra agora suporta pesquisas CSAT por meio de modelos de mensagens do WhatsApp, para que as pesquisas possam ser enviadas de forma confiável mesmo após o período de 24 horas de mensagens do WhatsApp. Quando uma conversa é resolvida, a IAra pode enviar automaticamente uma breve pesquisa ao cliente no WhatsApp solicitando que ele avalie sua experiência. A mensagem da pesquisa contém: - Uma curta mensagem de texto (por exemplo: pedindo feedback) - Um botão que abre a página de classificação CSAT Os clientes tocam no botão e enviam sua avaliação em apenas alguns segundos. Por que o WhatsApp exige um modelo? O WhatsApp só permite mensagens de formato livre dentro de 24 horas após a última mensagem do cliente. Há uma grande chance de que as pesquisas CSAT geralmente sejam enviadas após o término de uma conversa. Elas devem ser enviadas usando um modelo de mensagem do WhatsApp aprovado pelo WhatsApp. IAra cuida disso automaticamente: - Um modelo é criado para sua mensagem CSAT *O modelo é enviado ao WhatsApp para aprovação - Depois de aprovado, é usado para enviar pesquisas CSAT Você não precisa criar ou gerenciar modelos manualmente. Você pode usar pesquisas de modelo CSAT se estiver usando uma caixa de entrada WhatsApp Cloud ou WhatsApp Twilio na IAra Como ativar o CSAT para uma caixa de entrada do WhatsApp Siga estas etapas para ativar as pesquisas CSAT. Etapa 1: Abra as configurações da caixa de entrada do WhatsApp 1. Vá para Configurações → Caixas de entrada 2. Selecione sua caixa de entrada do WhatsApp 3. Abra a guia CSAT Etapa 2: Habilitar CSAT Ative o botão Ativar CSAT. Uma vez ativado, a IAra preparará um modelo de WhatsApp para sua pesquisa. Etapa 3: Personalize a mensagem da pesquisa Preencha os seguintes campos: - Mensagem: o texto que os clientes verão antes de avaliar. - Texto do botão A etiqueta mostrado no botão. - Idioma: Escolha o idioma do seu público do WhatsApp. Uma visualização ao vivo é mostrada à direita para que você possa ver como ficará no WhatsApp. \ Status de aprovação do modelo Depois de salvar, você poderá ver um destes status: - Aprovação pendente O WhatsApp está revisando seu modelo CSAT. Isso pode levar algum tempo. - Aprovado O modelo foi aprovado e as pesquisas CSAT serão enviadas automaticamente. - Rejeitado O WhatsApp rejeitou o modelo. Você pode atualizar a mensagem e tentar novamente. Uma vez aprovado, nenhuma ação adicional é necessária. O que acontece quando uma conversa é resolvida? Quando uma conversa termina: 1. IAra verifica se a conversa corresponde às regras da sua pesquisa 2. Se sim, a pesquisa CSAT é enviada usando o modelo aprovado do WhatsApp 3. A pessoa atendida toca no botão e envia sua avaliação As pesquisas são enviadas apenas uma vez por conversa. Atualizando sua mensagem CSAT posteriormente O WhatsApp não permite a edição de um modelo aprovado. Então, quando você altera qualquer um dos seguintes: - Texto da mensagem da pesquisa - Texto do botão - Idioma IAra mostrará uma mensagem de confirmação explicando que: - O modelo antigo será substituído *Um novo modelo será criado e enviado para aprovação Após aprovação, o novo modelo será utilizado automaticamente. Boas práticas para WhatsApp CSAT - Mantenha a mensagem curta e amigável - Use um texto de botão claro, como “Avaliar agora” ou “Dar feedback” - Envie pesquisas apenas para conversas significativas usando etiquetas - Evite alterar modelos com muita frequência para reduzir atrasos na aprovação 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.

Problemas comuns do WhatsApp e como corrigir

Use este guia quando você precisar configurar, entender ou validar Problemas comuns do WhatsApp e como corrigir 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 Mensagens do WhatsApp não recebidas mesmo que tudo pareça conectado Sintomas - O canal WhatsApp foi conectado com sucesso - O status do número de telefone mostra Conectado - A classificação de qualidade é Verde - Nenhum erro é mostrado na IAra - As mensagens enviadas podem funcionar, mas as mensagens recebidas não são recebidas Por que isso acontece Em alguns casos, o Meta exige que o número de telefone do WhatsApp seja registrado novamente, mesmo que ainda pareça conectado e íntegro. Isso geralmente acontece depois: - Uma mudança no nome de exibição - Atualizações do perfil comercial - Certos problemas internos de sincronização do Meta-side Quando isso ocorre, as mensagens do WhatsApp podem parar de ser entregues silenciosamente, sem apresentar erros visíveis. Este é um comportamento Meta conhecido. Como consertar Registrar novamente o número de telefone do WhatsApp resolve o problema imediatamente (pergunte-nos no suporte e resolveremos para você) *Não são necessárias alterações de plano - Nenhuma alteração no webhook é necessária - Na maioria dos casos, nenhum novo código de verificação é necessário Assim que o número for registrado novamente, a entrega da mensagem será retomada normalmente. Problemas de status do nome de exibição (pendente/rejeitado/não aprovado) O que é um nome de exibição? O nome de exibição é o nome comercial mostrado aos clientes no WhatsApp. Meta revisa e aprova esse nome antes de se tornar ativo. Status comuns de nomes de exibição - Aprovado – Tudo está bem, nenhuma ação necessária - Pendente – Meta está revisando o nome - Rejeitado – O nome não atendeu às diretrizes da Meta Por que os problemas de nomes de exibição são importantes - Um nome de exibição rejeitado ou pendente pode atrasar a integração *Alterar o nome de exibição pode exigir registrar novamente o número de telefone *As mensagens podem falhar ou parar de funcionar se o registro não for concluído após a aprovação Razões comuns para rejeição - O nome não corresponde ao nome da empresa no Meta Business Manager - Uso de palavras genéricas (por exemplo, “Suporte”, “Oficial”, “Serviço”) - Uso de emojis, símbolos ou letras maiúsculas - Incompatibilidade entre nome da marca e site/domínio Práticas recomendadas para nomes de exibição - Use seu nome comercial ou marca oficial - Combine o nome usado em seu site e no Meta Business Manager - Evite emojis, slogans ou descritores extras - Mantenha-o simples e consistente com a marca Nota importante Depois que um nome de exibição for aprovado, o Meta ainda poderá exigir que o número de telefone seja registrado novamente para que a alteração tenha efeito total. Se as mensagens do WhatsApp pararem de funcionar após uma atualização do nome de exibição, registrar novamente o número geralmente resolve o problema. Erro do WhatsApp 131049 – O usuário não aceitou os Termos de Serviço do WhatsApp O que é o erro 131049? O erro 131049 significa que o destinatário não aceitou os Termos de Serviço mais recentes do WhatsApp. Este erro é retornado pelo WhatsApp, não pela IAra, e é específico para o número de telefone do cliente, não para a configuração da sua empresa. Quando esse erro ocorre? Você pode ver o erro 131049 quando: - Enviando uma mensagem para um usuário que não abriu o WhatsApp recentemente - O WhatsApp lançou Termos de Serviço atualizados - O usuário não aceitou os novos termos em seu aplicativo WhatsApp Nesse estado, o WhatsApp bloqueia a entrega de mensagens para esse usuário até que ele aceite os termos. Por que isso acontece O WhatsApp exige que todos os usuários aceitem explicitamente os Termos de Serviço atualizados antes que possam: - Receba mensagens de empresas *Participe de conversas de negócios Até que o usuário aceite os termos, o WhatsApp rejeitará mensagens com erro 131049. Como corrigir o erro 131049 Este problema não pode ser corrigido na IAra ou na sua conta do WhatsApp Business. O pessoa atendida deve: 1. Abra o aplicativo WhatsApp 2. Aceite o prompt dos Termos de Serviço mais recente Assim que o usuário aceitar os termos, as mensagens começarão a ser entregues automaticamente – nenhuma nova tentativa ou alteração de configuração será necessária. 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.

Inconsistências de números de WhatsApp no Brasil e Argentina

Use este guia quando você precisar configurar, entender ou validar Inconsistências de números de WhatsApp no Brasil e Argentina 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 Nos últimos anos, alguns países alteraram os seus sistemas de numeração móvel para acomodar o crescimento. Essas mudanças criaram inconsistências entre o número que você pode discar hoje e o número que o WhatsApp armazenou para contas mais antigas. - Brasil: Um "9" foi adicionado após o código de área para todos os números de celular, criando um formato total de 13 dígitos. Exemplo: +55 11 9 8765-4321 em vez de +55 11 8765-4321. - Argentina: Os números podem aparecer com ou sem um “9” após o código do país, dependendo de quando a conta do WhatsApp foi registrada. Exemplo: +54 9 11 1234-5678 vs +54 11 1234-5678. Por causa disso, quando a IAra inicia uma conversa no WhatsApp (usando o formato discável “correto”), o WhatsApp pode responder com o número registrado mais antigo do usuário. Isso pode criar contatos duplicados e interromper o fluxo de tickets na sua caixa de entrada. Infelizmente, esse problema vem do próprio WhatsApp. Não há nenhuma correção no nível da API e é improvável que o WhatsApp atualize contas antigas para corresponder às novas regras de numeração. Como IAra resolve isso Adicionamos lógica para evitar automaticamente contatos e tickets duplicados quando ocorrem essas incompatibilidades: - Caso 1: Mensagem recebida com um novo formato de número (por exemplo, +55 código do país + código de área + 9 + número, total de 13 dígitos) → Nenhuma alteração necessária. A mensagem está vinculada diretamente ao contato existente. - Caso 2: Mensagem recebida com um número no formato antigo (por exemplo, +55 código do país + código de área + número, 12 dígitos no total, faltando o dígito extra) → IAra verifica se já existe um contato no novo formato. → Nesse caso, vinculamos a mensagem ao contato correto em vez de criar uma duplicata. O que isso significa para você - Você ainda pode notar a diferença na aparência dos números no WhatsApp e na aparência no seu CRM. - Você pode continuar enviando mensagens aos clientes normalmente. A IAra cuida da incompatibilidade de plano de fundo - A IAra normaliza automaticamente os números de telefone dos formatos antigos e novos nos bastidores para garantir uma correspondência consistente de contatos, independentemente do formato que o WhatsApp retorna. 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.

Como evitar bloqueio do número de WhatsApp

Use este guia quando você precisar configurar e usar este recurso com clareza operacional. Quando usar este guia Use este guia para resolver ou revisar Como evitar bloqueio do número de WhatsApp na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Passo a passo operacional 1. Acesse a área correspondente no painel da IAra. 2. Revise se você está na conta, caixa de entrada, time ou assistente correto. 3. Faça a configuração ou ação descrita pelo artigo. 4. Teste usando um cenário realista, mas controlado. 5. Confirme se o resultado aparece para quem precisa operar: agente, gestor, cliente ou suporte. 6. Documente qualquer diferença de tela para ajustar o artigo antes da publicação. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Boas práticas para atendimento via WhatsApp

Use este guia quando você precisar configurar e usar este recurso com clareza operacional. Quando usar este guia Use este guia para resolver ou revisar Boas práticas para atendimento via WhatsApp na IAra com mais segurança, sem depender de tentativa e erro. Na tela: Revise a caixa de WhatsApp usada pela operação antes de aplicar boas práticas de atendimento. caixa WhatsApp. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Passo a passo operacional 1. Acesse a área correspondente no painel da IAra. 2. Revise se você está na conta, caixa de entrada, time ou assistente correto. 3. Faça a configuração ou ação descrita pelo artigo. 4. Teste usando um cenário realista, mas controlado. 5. Confirme se o resultado aparece para quem precisa operar: agente, gestor, cliente ou suporte. 6. Documente qualquer diferença de tela para ajustar o artigo antes da publicação. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Como diagnosticar falhas em templates do WhatsApp

Use este guia quando uma mensagem de WhatsApp com template não envia, falha fora da janela de 24 horas ou volta com erro de variável, idioma ou status do template. O que conferir primeiro - A conversa está dentro ou fora da janela de atendimento permitida? - A mensagem é texto livre ou template oficial? - O template está aprovado e ativo no provedor/canal? - O nome técnico e o idioma batem exatamente com o template cadastrado? - A quantidade de variáveis enviada é igual à quantidade de placeholders? - Cada variável está no formato esperado: texto, moeda, data, mídia ou botão? - O template foi pausado, rejeitado, desabilitado ou teve qualidade reduzida? Fluxo de decisão 1. Se a pessoa atendida falou com a empresa recentemente, teste uma resposta curta de texto livre. 2. Se texto livre falhar fora da janela, troque para template aprovado. 3. Se o template falhar, copie o nome técnico, idioma e categoria do template. 4. Compare cada placeholder com os valores enviados. 5. Remova mídia, botões e variáveis opcionais para testar uma versão mínima. 6. Se a versão mínima funcionar, adicione cada componente de volta até achar o ponto de falha. Erros mais comuns | Erro | Causa provável | Correção | |---|---|---| | 131047 ou 63016 | Tentativa de enviar texto livre fora da janela. | Use template aprovado para iniciar ou retomar a conversa. | | 132001 | Template não existe, não está aprovado, está em outro idioma ou não sincronizou. | Corrija nome técnico, idioma e status do template. | | 132000 | Quantidade de parâmetros diferente do template. | Envie todos os placeholders exigidos, na ordem correta. | | 132012 | Formato de parâmetro incompatível. | Ajuste data, moeda, mídia, botão ou estrutura do componente. | | 132005 | Texto final ficou grande demais. | Reduza variáveis longas e conteúdo dinâmico. | | 132007 | Caracteres ou formatação violam política. | Remova excesso de quebra de linha, símbolos ou conteúdo sensível. | | 63040, 63041 ou 63042 | Template rejeitado, pausado ou desabilitado. | Use outro template ativo ou corrija e submeta novamente. | Boas práticas para evitar falhas - Padronize nomes técnicos em minúsculas e sem espaços. - Use idiomas exatamente como aprovados no canal. - Evite variáveis muito longas em cabeçalho, corpo e botões. - Não coloque link, preço, cupom ou promessa comercial em variável sem validar a política. - Faça teste com contato interno antes de usar em campanha. - Mantenha um template transacional de fallback para casos urgentes. Checklist Antes de pedir ajuda à Digi2B - [ ] Nome técnico do template. - [ ] Idioma do template. - [ ] Print do status do template no provedor/canal. - [ ] Link da conversa na IAra. - [ ] Horário da tentativa. - [ ] Print do erro ou código retornado. - [ ] Valores enviados em cada variável. - [ ] Confirmação se o envio era dentro ou fora da janela permitida.

Como usar templates de conteúdo da Twilio

Use este guia quando você precisar configurar, entender ou validar Como usar templates de conteúdo da 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 Os modelos de conteúdo da Twilio permitem que você envie modelos de mensagens do WhatsApp pré-aprovados por meio dos canais do Twilio WhatsApp Business na IAra. Esses modelos permitem iniciar conversas e enviar mensagens estruturadas que atendem às políticas de mensagens do WhatsApp. Tipos de modelo suportados Modelos de texto - Mensagens de texto simples com variáveis opcionais - Suporte para até 100 variáveis por modelo usando o formato {{1}}, {{2}} - Suporte multilíngue Modelos de mídia - Modelos de imagem: texto com cabeçalhos de imagem (JPEG/PNG, máximo 5 MB) - Modelos de vídeo: texto com cabeçalhos de vídeo (MP4/3GPP, máximo de 16 MB) - Modelos de documento: texto com anexos de documentos (formatos PDF/Office, máximo de 100 MB) - Suporte para URLs de mídia dinâmica com variáveis Modelos de resposta rápida - Respostas de botões interativos gerenciadas pelo WhatsApp - Ações simples de botões para respostas comuns - Suporte para múltiplas variantes de idioma Modelos de apelo à ação - Modelos de botão de URL: envie mensagens com botões de ação clicáveis - Suporte a variáveis: tanto o texto da mensagem quanto os parâmetros do botão podem incluir variáveis - Tipos de ação: botões de URL para pagamentos, reservas, sites, etc. Pré-requisitos Antes de usar os modelos de conteúdo da Twilio: 1. Conta Twilio: conta Twilio ativa com acesso à API do WhatsApp Business 2. Modelos aprovados: modelos criados e aprovados no Console da Twilio 3. Integraçãa IAra: canal Twilio WhatsApp configurado na IAra 4. Conta WhatsApp Business: perfil verificado do WhatsApp Business Configurando modelos 1. Faça login em seu Console Twilio 2. Navegue até Mensagens → Content Template Builder 3. Clique em Criar novo modelo 4. Escolha o tipo de modelo: Texto: para mensagens de texto simples, Mídia: para imagens, vídeos ou documentos, Resposta rápida: para botões interativos 5. Configure o modelo com base na finalidade. 6. Envie modelo para aprovação do WhatsApp 7. Aguarde aprovação (5 minutos a 24 horas) 8. Os modelos aprovados recebem um ContentSid 9. Os modelos agora estão prontos para uso na IAra Sincronizando modelos com IAra Sincronização automática via API Os modelos são sincronizados automaticamente quando você: 1. Abra o modal de modelos de conteúdo em uma conversa 2. Crie uma nova conversa com um canal Twilio WhatsApp Sincronização manual Para administradores de caixa de entrada: 1. Vá para Configurações → Caixas de entrada 2. Selecione sua caixa de entrada do Twilio WhatsApp 3. Clique no botão Sincronizar modelos 4. Aguarde a notificação de conclusão da sincronização Usando modelos em conversas Etapa 1: acessar opções de modelo Abra qualquer conversa com um contato do WhatsApp, clique no ícone de modelo no compositor de mensagens, selecione "Modelos do WhatsApp" no menu suspenso Etapa 2: Escolha seu modelo Navegue pelos seus modelos aprovados, use a barra de pesquisa para encontrar modelos específicos rapidamente Etapa 3: Personalize sua mensagem Dependendo do tipo de modelo, pode ser necessário preencher: Práticas recomendadas Design de modelo - Mantenha as mensagens concisas e claras - Use variáveis para personalização - Garanta que os arquivos de mídia estejam otimizados e acessíveis - Modelos de teste antes do envio para aprovação Uso variável - Use nomes de variáveis descritivos no console da Twilio - Forneça exemplos claros para aprovação - Mantenha a contagem de variáveis razoável (menos de 10 para melhor UX) Diretrizes para a mídia - Hospede arquivos de mídia em servidores rápidos e confiáveis - Use URLs HTTPS para todas as mídias - Otimize tamanhos de arquivo para entrega mais rápida - Incluir texto alternativo para modelos de mídia Conformidade - Siga as diretrizes da Política Comercial do WhatsApp - Garanta que os modelos atendam a propósitos comerciais legítimos - Respeite a privacidade e o consentimento do usuário - Monitore o desempenho do modelo e o status de aprovação Solução de problemas Problemas comuns Modelo não aparece - Causa: Modelo não aprovado pelo WhatsApp - Solução: verifique o status de aprovação no console da Twilio Falha na sincronização do modelo - Causa: problemas de conexão da API ou credenciais inválidas - Solução: verifique as credenciais do Twilio e tente sincronizar novamente A mídia não carrega - Causa: URL da mídia não acessível ou formato incorreto - Soluções: verificar se o URL está acessível publicamente, verificar o formato do arquivo e os limites de tamanho, garantir o protocolo HTTPS Variáveis não funcionam - Causa: Formato de variável incorreto ou valores ausentes - Soluções: Use o formato {{1}}, {{2}} correto no Twilio, preencha todas as variáveis necessárias na IAra, verifique a contagem de variáveis corresponde ao modelo Mensagens de erro "Modelo não encontrado" - Modelo não sincronizado com IAra - Execute a sincronização manual ou verifique a aprovação do modelo "Arquivo de mídia muito grande" *Arquivo excede limites do WhatsApp - Compacte o arquivo ou use um formato diferente "Parâmetros de modelo inválidos" - Valores de variáveis ausentes ou incorretos - Revise e preencha todos os campos obrigatórios Exemplos de modelos Modelo de texto básico Nome: mensagem_de_boas-vindas Conteúdo: "Bem-vindo a {{1}}! Estamos felizes em ajudá-lo com {{2}}." Variáveis: Nome da empresa, Tipo de serviço Mostra do produto (modelo de mídia) Nome: product_launch Mídia: imagem do produto Conteúdo: "🎉 Novidade! {{1}} já está disponível por {{2}}. Oferta por tempo limitado!" Variáveis: Nome do produto, Preço Confirmação do pedido (modelo de texto) Nome: pedido_confirmado Conteúdo: "Olá {{1}}! Seu pedido {{2}} foi confirmado. Entrega prevista: {{3}}." Variáveis: Nome do cliente, ID do pedido, Data de entrega Modelo de resposta rápida Nome: support_options Conteúdo: "Como podemos ajudá-lo hoje?" Botões: "Suporte Técnico", "Faturamento", "Informações Gerais" Limitações Limitações atuais - Modelos não suportados em campanhas (em atualizações futuras) - Modelos de seletor de lista - Modelos de catálogo - Modelos de carrossel Limites do modelo - Máximo de 100 variáveis por modelo - Os arquivos de mídia devem ser acessíveis publicamente *Os modelos exigem aprovação do WhatsApp - Numeração sequencial de parâmetros necessária Suporte Para obter ajuda adicional: - Verifique a documentação do Twilio WhatsApp - Revise as Diretrizes da Plataforma WhatsApp Business - Entre em contato com o administrador do sistema para problemas técnicos - Consulte a documentação da IAra para orientação geral da plataforma 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.

Códigos de erro do WhatsApp: causas e soluções

Use este artigo quando a IAra, a Meta, a API oficial do WhatsApp ou o provedor retornar um código de erro no envio. Ordem recomendada de diagnóstico 1. Confirme se a conversa está dentro da janela permitida para resposta livre. 2. Se estiver fora da janela, use template aprovado e ativo. 3. Valide nome técnico, idioma e variáveis do template. 4. Confirme se o número do destinatário usa WhatsApp e está completo com DDI/DDD. 5. Se houver mídia, teste uma mensagem sem anexo. 6. Se houver volume alto, reduza ritmo e aguarde os limites normalizarem. 7. Se o erro envolver política, bloqueio ou conta comercial, acione o suporte Digi2B com as evidências. Limites, instabilidade e erros temporários | Código | Significado provável | Como resolver | |---|---|---| | 130429 | Throughput excedido. O número ou conta ultrapassou o ritmo permitido. | Reduza o volume, use filas, segmente envios e aguarde antes de reenviar. | | 131056 | Limite por par remetente-destinatário. | Aguarde antes de enviar novamente para o mesmo contato. | | 131016 | Serviço temporariamente indisponível. | Aguarde e tente novamente com intervalo. | | 131057 | Conta ou número em manutenção/upgrade. | Aguarde normalização e evite volume alto durante a janela. | | 1, 2, 131000 ou 135000 | Erro genérico da API ou do serviço. | Repita com texto simples e colete retorno completo se persistir. | | 130472 | Número do destinatário afetado por limitação/experimento do canal. | Use canal alternativo ou tente novamente mais tarde. | Janela de 24 horas e templates | Código | Significado provável | Como resolver | |---|---|---| | 131047 | Tentativa de reengajamento fora da janela permitida. | Use um template aprovado para iniciar ou retomar a conversa. | | 132001 | Template inexistente, não aprovado, indisponível ou idioma incorreto. | Confira nome técnico, idioma e status do template. | | 132000 | Quantidade de variáveis diferente do template. | Envie exatamente a quantidade de parâmetros exigida. | | 132012 | Tipo ou formato de parâmetro inválido. | Corrija texto, moeda, data, mídia ou estrutura dos componentes. | | 132005 | Texto final do template ficou longo demais. | Reduza variáveis e conteúdo gerado. | | 132007 | Formatação/caracteres violam política do template. | Revise quebras, emojis, símbolos e texto promocional sensível. | Destinatário, mídia e tipo de mensagem | Código | Significado provável | Como resolver | |---|---|---| | 131026 | Mensagem não entregável ao destinatário. | Confirme número, DDI/DDD, WhatsApp ativo, bloqueio e aceite dos termos do app. | | 131051 | Tipo de mensagem não suportado. | Troque por formato aceito, como texto ou link. | | 131052 | Erro ao baixar mídia. | Use URL pública, estável, sem expiração curta e com content-type correto. | | 131053 | Erro ao enviar ou processar mídia. | Reduza tamanho, troque formato e teste arquivo simples. | | 131021 | Remetente e destinatário são o mesmo número. | Envie para outro número de teste. | Permissão, conta, pagamento e política | Código | Significado provável | Como resolver | |---|---|---| | 131005 | Acesso negado. | Reconecte o canal com permissões corretas. | | 131008 | Parâmetro obrigatório ausente. | Revise dados do template, destinatário e payload. | | 131042 | Elegibilidade comercial, pagamento ou conta WhatsApp Business com problema. | Regularize a conta comercial e acione o suporte Digi2B se necessário. | | 368, 130497 ou 131031 | Bloqueio, restrição geográfica ou conta bloqueada. | Interrompa envios e trate como incidente de política/compliance. | | 131049 | Entrega suprimida por proteção do ecossistema, frequência, qualidade ou elegibilidade. | Reduza frequência, melhore segmentação e revise qualidade dos templates. | Códigos comuns via Twilio ou provedor intermediário | Código | Significado provável | Como resolver | |---|---|---| | 63016 | Fora da janela permitida. | Use template oficial ou aguarde nova interação do cliente. | | 63040, 63041 ou 63042 | Template rejeitado, pausado ou desabilitado. | Corrija, substitua ou ressubmeta o template. | | 63005 ou 63021 | Conteúdo inválido ou recusado pelo canal. | Ajuste formato, variáveis, mídia e componentes. | | 63013 | Violação de política do canal. | Revise o conteúdo antes de tentar novamente. | | 63017 ou 63018 | Rate limit excedido. | Reduza ritmo, aplique espera e segmente envios. | Quando pedir ajuda à Digi2B - O código afeta grande volume ou todos os envios do número. - A conta, número ou WABA aparece bloqueada/restrita. - O erro persiste mesmo com texto simples e contato de teste válido. - O template está aprovado, mas falha com 132001, 132000 ou 132012. - A IAra mostra enviado, mas o provedor retorna falha posterior. Envie o código, horário, número remetente, número destinatário, link da conversa, nome do template e print do erro.