Por Pranav, harishmita, and Sojan
Por Pranav, harishmita, and Sojan
Seu guia completo do WhatsApp no Chatwoot: conecte seu número, use modelos, campanhas, pesquisas de CSAT e chamadas, mantenha seu número saudável e corrija erros comuns de configuração e entrega.
WhatsApp no Chatwoot
Conecte seu número do WhatsApp Business ao Chatwoot e sua equipe poderá responder aos chats do WhatsApp a partir de uma caixa de entrada compartilhada, junto com seus outros canais. Você também pode enviar mensagens modelo aprovadas, realizar campanhas de transmissão, coletar avaliações CSAT e atender chamadas do WhatsApp. O que você pode fazer no WhatsApp Capacidade O que faz Saiba mais Caixa de entrada WhatsApp compartilhada As mensagens dos clientes chegam como conversas que sua equipe pode atribuir, rotular, responder e resolver 2. Escolha como conectar o WhatsApp Mensagens modelo Inicie uma conversa ou responda após 24 horas com uma mensagem aprovada pela Meta 7. Modelos e a janela de 24 horas Campanhas Envie um modelo aprovado para cada contato com os rótulos escolhidos. Plano Business ou superior. 8. Campanhas WhatsApp Pesquisas CSAT Solicite uma avaliação quando uma conversa for resolvida, mesmo após o fechamento da janela de 24 horas 9. Pesquisas CSAT no WhatsApp Chamadas Clientes ligam para sua empresa pelo WhatsApp e os agentes atendem pelo navegador 10. Chamadas WhatsApp Saúde da conta Veja o status do seu número, limite de mensagens, revisão do nome exibido e perfil comercial no Chatwoot 11. Gerencie seu número WhatsApp Plano & acesso Chatwoot Cloud Self-hosted Caixa de entrada WhatsApp (qualquer método de conexão) Planos Startups e superiores, e avaliação gratuita. Não disponível no plano gratuito Hacker. Incluído Configuração rápida com a Meta (forma mais rápida de conectar) Incluída a partir do plano Startups. Durante a avaliação gratuita, clique em Solicitar acesso na tela de configuração e envie seu caso de uso para ativá-la. Apenas se sua instalação tiver seu próprio app Meta configurado. A maioria das instalações self-hosted utiliza configuração manual. Campanhas WhatsApp : envio Plano Business ou superior. Disponível automaticamente, sem necessidade de solicitação. Não é um recurso premium. Funciona na Community Edition e está ativado por padrão. Análise de campanhas Plano Business ou superior Apenas plano Enterprise . O super admin de sua instalação ativa Campaign Analytics em Super Admin › Accounts › abra a conta › Editar , em Premium features , e clique em Salvar alterações . Chamadas Plano Business ou superior Requer um plano pago self-hosted com Enterprise Edition, a partir da v4.15.0. Somente instalar o Enterprise Edition não habilita o recurso. Modelos, pesquisas CSAT, saúde da conta Todo plano que inclui WhatsApp Incluído Quem pode fazer o quê: - Administradores conectam caixas de entrada e alteram as configurações da caixa. - Agentes adicionados à caixa de entrada respondem conversas e enviam modelos. Veja Preços & Planos para saber o que cada plano inclui. Seu método de conexão decide o que você pode usar O Chatwoot se conecta ao WhatsApp de três formas. Escolha antes de conectar, pois alguns recursos só funcionam com WhatsApp Cloud API. Configuração rápida com a Meta (WhatsApp Cloud API) Configuração manual (WhatsApp Cloud API) Twilio Esforço de configuração Alguns minutos em uma janela da Meta. Sem necessidade de desenvolvedor. App Meta, token de usuário do sistema e webhook Conta Twilio, credenciais e webhook Continuar usando o app WhatsApp Business no celular ✅ (Coexistência) ❌ ❌ Mensagens modelo ✅ ✅ ✅ Modelos de conteúdo Twilio Campanhas ✅ ✅ ❌ Pesquisas CSAT após 24 horas ✅ ✅ ✅ Chamadas ✅ ✅ ❌ Aba Saúde da conta ✅ ✅ ❌ Disponível em Chatwoot Cloud Cloud e self-hosted Cloud e self-hosted Usando 360dialog? 360dialog não é mais oferecido para novas caixas de entrada. Caixas 360dialog existentes continuam funcionando para conversas, mas não podem usar campanhas, chamadas ou modelos CSAT. Como verificar o que você tem - Tipo da sua caixa de entrada: vá em Configurações › Caixas de entrada e abra sua caixa do WhatsApp. Uma aba Saúde da conta significa que é uma caixa WhatsApp Cloud API. - Configuração rápida: na tela de configuração do WhatsApp, uma caixa Solicitar acesso no lugar do botão de conectar significa que a configuração rápida ainda não está ativa para sua conta. - Campanhas: WhatsApp em Campanhas na barra lateral significa que campanhas estão disponíveis para sua conta. - Chamadas: uma aba Chamadas nas configurações da caixa significa que chamadas estão disponíveis para sua conta. Seu caminho neste guia 1. Conectar: Escolher como conectar o WhatsApp, depois vá para a página do seu método (3, 4 ou 5). 2. Aprenda a única regra que define o WhatsApp: Modelos e a janela de 24 horas. 3. Adicione o que precisar: campanhas (8), CSAT (9), chamadas (10). 4. Mantenha saudável: Gerencie seu número WhatsApp. 5. Quando algo quebrar: Solucionar problemas no WhatsApp.
Escolha como conectar o WhatsApp
Qual método é o ideal para você? Sua situação Usar Você está no Chatwoot Cloud e conectando um novo número Configuração rápida com a Meta (página 3) Seu número está no app WhatsApp Business e você quer continuar usando o app no seu telefone Configuração rápida com a Meta e escolha conectar seu app existente (página 3). Isso se chama Coexistência. Seu número já está na Plataforma WhatsApp Business (API) , você é um provedor técnico conectando seu próprio número ou é auto-hospedado Configuração manual (página 4) Você já envia SMS ou WhatsApp através da Twilio e quer continuar faturando por lá Twilio (página 5). Note que campanhas e chamadas não estão disponíveis com o Twilio. Não tem certeza de quais recursos precisa? Veja Seu método de conexão decide o que você pode usar em WhatsApp no Chatwoot. Antes de começar (todos os métodos) - Você é um administrador no Chatwoot. - Para WhatsApp Cloud API: você pode entrar no Facebook com uma conta que seja admin do portfólio de negócios da Meta que possui (ou possuirá) a Conta WhatsApp Business. - Seu número pode receber um SMS de verificação ou chamada de voz. Telefones fixos precisam de verificação por voz. Números que atendem com um menu automático (URA/IVR) não são suportados pela Meta. - Você tem os dados da sua empresa prontos e um nome de exibição que segue as diretrizes da Meta para nomes de exibição. Veja Nome de exibição em Gerencie seu número do WhatsApp. Posso mudar de método depois? - Configuração rápida para configuração manual: possível em alguns casos, sem perder conversas. O suporte do Chatwoot verifica a elegibilidade antes, e não está disponível para números usando Coexistência (o app WhatsApp Business). Veja Mover uma caixa de entrada de configuração rápida para configuração manual. - Configuração manual para Configuração rápida: não está disponível pelo painel. - Entre Twilio e WhatsApp Cloud API: isso significa criar uma nova caixa de entrada. As conversas permanecem na caixa de entrada antiga. Iniciar Vá em Configurações › Caixas de entrada › Adicionar caixa de entrada › WhatsApp. Você verá duas opções: - WhatsApp Cloud: Configuração rápida com a Meta (ou configuração manual, pelo link no final daquela tela) - Twilio
Conecte-se com a configuração rápida do Meta
Configuração rápida com a Meta (também chamada de Cadastro Embutido) conecta seu número por meio de uma janela da Meta. O Chatwoot configura automaticamente o webhook, token e número de telefone para você. Plano & acesso - Apenas no Chatwoot Cloud. Incluso a partir do plano Startups. Durante o teste gratuito, clique em Solicitar acesso, descreva como você usará o WhatsApp e clique em Enviar para ativar. O WhatsApp não está disponível no plano gratuito Hacker. Veja Preços & Planos. - Somente administradores. Antes de começar - Entre no Facebook com uma conta que seja admin do portfólio de negócios correto da Meta. - Permita pop-ups para o Chatwoot e Facebook. - Manter o app WhatsApp Business (Coexistência): atualize o app para a versão mais recente e mantenha o telefone online. A coexistência funciona com o app WhatsApp Business, não com o app WhatsApp pessoal. A Meta decide quais números são elegíveis. Conecte seu número 1. Vá em Configurações › Caixas de entrada › Adicionar caixa de entrada › WhatsApp e escolha WhatsApp Cloud. 2. Clique em Conectar com o WhatsApp Business. Uma janela da Meta será aberta. 3. Na janela da Meta, faça login e escolha ou crie seu portfólio de negócios e Conta do WhatsApp Business. 4. Escolha seu número: - Um novo número: digite e verifique com o código que a Meta envia por SMS ou ligação. - Um número no app WhatsApp Business (Coexistência): escolha conectar seu app existente, então: 1. Copie o código de verificação exibido na janela da Meta. 2. No seu telefone, abra a mensagem do Facebook Business, toque em Conectar e depois em Conectar à Plataforma de Negócios. 3. Toque em Confirmar e escolha se deseja compartilhar seu histórico de conversas. 4. Digite o código copiado no app e conclua os passos na janela da Meta. 5. Quando aparecer Conta do WhatsApp Business conectada!, adicione os agentes que atenderão essa caixa de entrada. Teste: envie uma mensagem do WhatsApp para o número da sua empresa de outro telefone. Ela deve aparecer como uma nova conversa. Responda pelo Chatwoot e confira se a mensagem é entregue. Na Coexistência, verifique também se o app no seu telefone ainda funciona. O que acontece depois - Modelos aprovados na sua Conta do WhatsApp Business sincronizam automaticamente com o Chatwoot. Veja Modelos e a janela de 24 horas. - Chamadas: se chamadas estiverem disponíveis no seu plano, o Chatwoot tenta ativar durante a configuração. Se seu número não estiver inscrito na API de Chamadas da Meta, a caixa de entrada ainda será criada e você poderá ativar as chamadas depois. Veja Chamadas do WhatsApp. - Histórico de conversas (Coexistência): a Meta sincroniza o histórico apenas dentro de 24 horas da conexão. Mantenha o app aberto e com conexão estável. Históricos grandes podem demorar mais. - Revisões da Meta: a Meta pode solicitar a verificação do seu negócio (upload de documentos) e vai revisar seu nome de exibição. Acompanhe ambos em Saúde da Conta. Veja Gerencie seu número do WhatsApp. Se a Configuração rápida estiver indisponível Às vezes, a Meta restringe a Configuração rápida para todos os provedores. O Chatwoot então mostra um aviso na tela de configuração. Durante esse período: - Números já na API WhatsApp Cloud podem usar a configuração manual. Veja Conecte-se com a API WhatsApp Cloud (configuração manual). - Números usando Coexistência não podem ser conectados até o fim da restrição. Algo deu errado? Veja Conexão em Solucionar problemas do WhatsApp. Ele cobre todos os códigos de erro da Meta que você pode encontrar durante esse fluxo.
Conectar com a API em Nuvem do WhatsApp (configuração manual)
Use a configuração manual se o seu número já estiver na Plataforma WhatsApp Business (API), você for um provedor de tecnologia integrando seu próprio número, utiliza hospedagem própria ou a Configuração rápida estiver indisponível. Você conecta o Chatwoot ao seu próprio aplicativo Meta. Plano & acesso - Todo plano que inclui WhatsApp (Startups e acima, e o teste gratuito) no Chatwoot Cloud e em hospedagem própria. Veja Preços & Planos. - Apenas administradores. - A coexistência (manter o app WhatsApp Business) não é suportada com a configuração manual. Se o seu número está ativo no app WhatsApp Business, não o registre por este fluxo. Use a Configuração rápida (página 3) ou entre em contato com o suporte. Antes de começar Você precisa de três itens da Meta. A configuração guiada no Chatwoot explica cada um e leva para a tela certa na Meta: - Um aplicativo Meta com o caso de uso WhatsApp - O ID do número de telefone e o ID da Conta Comercial do WhatsApp do seu número - Um token de acesso permanente de um usuário de sistema da Meta Conecte seu número 1. Vá em Configurações › Caixas de entrada › Adicionar caixa de entrada › WhatsApp e escolha WhatsApp Cloud. Na tela de Configuração rápida, clique em fluxo de configuração manual na parte inferior. (Se a Configuração rápida não estiver disponível, você será direcionado diretamente para a configuração manual.) 2. Crie ou selecione um aplicativo Meta. No Meta Developers, crie um aplicativo (ou selecione o que você já usa para este número), escolha conectar com clientes via WhatsApp e selecione o portfólio comercial que é dono do número. Clique em Meu aplicativo Meta está pronto. 3. Adicione seu número de telefone e obtenha seus IDs. No seu aplicativo Meta, abra o caso de uso WhatsApp e escolha Configuração de API. Em Enviar e receber mensagens, abra o seletor De e selecione seu número, ou escolha Adicionar número de telefone, complete o perfil comercial e faça a verificação com o código enviado pela Meta. Copie o ID do número de telefone e o ID da Conta Comercial do WhatsApp, insira no Chatwoot e clique em Próximo. 4. Gere um token de acesso permanente. Nas Configurações Comerciais da Meta, vá em Usuários › Usuários de sistema, crie um usuário de sistema admin (ou selecione um), atribua o seu aplicativo Meta e a Conta Comercial do WhatsApp com controle total, depois clique em Gerar token. Defina validade como Nunca, selecione whatsapp_business_management e whatsapp_business_messaging, e copie o token. A Meta mostra o token apenas uma vez. De volta ao Chatwoot, cole-o como Token de acesso permanente e clique em Verificar detalhes. 5. Confira o nome da empresa, número e IDs, altere o Nome da caixa de entrada se desejar, e clique em Criar caixa de entrada. 6. O Chatwoot verifica Acesso ao número, Acesso a modelos, Webhook callback e Assinatura do webhook, e configura o webhook na Meta para você. Quando todos os quatro mostrarem Verificado, clique em Continuar para adicionar agentes. Teste: envie uma mensagem WhatsApp para o número da empresa de outro telefone. Ela deve aparecer no Chatwoot. Responda e verifique se chegou. Mantenha seu token em segurança. Qualquer pessoa com o token pode usar sua conexão WhatsApp. Se você trocar ou revogar na Meta, atualize na aba Configuração da caixa de entrada. Se uma etapa de verificação falhar Mensagem O que fazer Este token de acesso é inválido ou expirou Gere um novo token permanente (validade Nunca ) e tente novamente Acesso a modelos não verificado O token está sem o escopo whatsapp_business_management . As mensagens funcionarão, mas os modelos não vão sincronizar. Gere um token com as duas permissões. Webhook callback ou Assinatura do webhook não verificada Clique em Tentar configurar webhook novamente . Se ainda falhar, verifique se o usuário de sistema tem controle total da Conta Comercial do WhatsApp. Insira o ID do número de telefone e o ID da Conta Comercial do WhatsApp Copie ambos de Configuração de API no seu aplicativo Meta. São números diferentes. Para outros casos, veja Soluções para WhatsApp. O que acontece depois - Modelos aprovados na sua Conta Comercial do WhatsApp são sincronizados automaticamente. Veja Modelos e a janela de 24 horas. - Chamadas também funcionam com configuração manual, após seu número estar inscrito na API de chamadas da Meta. Veja Chamadas WhatsApp. Conectando mais de um número Sim, é possível. Crie uma caixa de entrada Chatwoot separada para cada número. A configuração guiada já ajusta o direcionamento dos webhooks para cada uma, então não é preciso conectar manualmente.
Conecte o WhatsApp pelo Twilio
Conecte um número do WhatsApp que você gerencia no Twilio. Ideal se você já usa Twilio para SMS ou WhatsApp e quer manter a cobrança lá. Plano & acesso - Todo plano que inclui WhatsApp (Startups e acima, e o teste gratuito) no Chatwoot Cloud e auto-hospedado. Veja Preços & Planos. - Apenas administradores. - Com o Twilio você pode enviar templates (templates de conteúdo do Twilio) e pesquisas de CSAT. Você não pode usar campanhas do WhatsApp ou ligações pelo WhatsApp. Veja a tabela em WhatsApp no Chatwoot. Antes de começar - Uma conta Twilio com um remetente (número) do WhatsApp aprovado no Twilio. - Seu Account SID e Auth Token do Twilio, ou um API Key SID e API Key Secret. - Opcional: um Messaging Service SID, se você enviar através de um Messaging Service do Twilio. Para obter, no Console do Twilio vá em Messaging › Services › Create Messaging Service, complete as etapas e copie o SID do serviço. - Se você usa Twilio Studio, não substitua seu webhook pelo Callback URL do Chatwoot. Isso interrompe seu fluxo do Studio. Contate o suporte primeiro. Conectar seu número 1. Vá em Configurações › Caixas de entrada › Adicionar caixa de entrada › WhatsApp e escolha Twilio. 2. Insira um Nome da Caixa de Entrada. 3. Insira o Número de Telefone, começando com + e sem espaços. Se você enviar por um Messaging Service, ative Usar um Messaging Service do Twilio e insira o Messaging Service SID. O campo Número de Telefone fica oculto quando esta opção está ativa. Você preenche um ou outro, não ambos. 4. Insira seu Account SID, e ou seu Auth Token ou (após ativar Autenticação por Chave de API) seu API Key SID e API Key Secret. 5. Verifique se você inseriu ou o Número de Telefone, ou, com Usar um Messaging Service do Twilio ativado, o Messaging Service SID (veja o passo 3). 6. Clique em Criar Canal Twilio e depois adicione agentes. 7. Copie o Callback URL exibido no Chatwoot e defina-o como webhook de mensagens recebidas no Console do Twilio: - Para um remetente WhatsApp: vá em Messaging › Senders › WhatsApp Senders e selecione seu remetente. Em Configuração de endpoint, defina a URL do webhook para mensagens recebidas como o Callback URL e salve. - Para um Messaging Service: vá em Messaging › Services, selecione seu serviço, depois Integração, e cole a URL lá. Para encontrar o Callback URL mais tarde, vá em Configurações › Caixas de entrada, abra sua caixa de entrada e selecione a guia Configuração. Teste: envie uma mensagem WhatsApp para seu número de outro telefone e verifique se ela chega ao Chatwoot. Responda e confira se chega no telefone. O que acontece em seguida - Templates: os templates de conteúdo aprovados no Twilio serão sincronizados com o Chatwoot. Veja Templates de conteúdo do Twilio em Templates e a janela de 24 horas.
Mover uma caixa de entrada de configuração rápida para configuração manual
Reconecte uma caixa de entrada criada com a Configuração rápida para que use seu próprio aplicativo Meta. Sua caixa de entrada, conversas e configurações permanecem como estão. Quando você deve fazer isso O Chatwoot exibe um banner Configuração manual recomendada na caixa de entrada quando restrições da Meta no aplicativo compartilhado da Configuração rápida podem afetá-la. Conectar usando seu próprio aplicativo Meta protege a caixa de entrada dessas restrições. Plano & acesso - Chatwoot Cloud Preços & Planos, apenas administradores. - Disponível quando o banner Configuração manual recomendada aparece nas configurações da caixa de entrada. O banner não é uma configuração que pode ser ativada: ele aparece em caixas de entrada do WhatsApp Cloud criadas por Configuração rápida (Embedded Signup) após o acesso ser concedido à sua conta, o número não está usando Coexistência, e a conexão não tem erro de autorização. Entre em contato com o suporte para uma avaliação da sua caixa de entrada. - Não para números com Coexistência. Se o seu número também é usado no aplicativo WhatsApp Business, entre em contato com o suporte antes de qualquer procedimento. O que muda e o que permanece Permanece igual É atualizado Conversas, contatos, colaboradores, roteamento, horários de atendimento, configurações de CSAT e bot, e o número de telefone exibido ao cliente ID da Conta WhatsApp Business, ID do Número de Telefone e token de acesso O webhook para seu próprio aplicativo Meta não é configurado automaticamente. Entre em contato com o suporte antes de começar para que o webhook seja configurado no seu aplicativo Meta antes de mover a caixa de entrada. Após a migração, teste conforme descrito em Verifique se funcionou Antes de começar Tenha em mãos seu aplicativo Meta, ID do Número de Telefone, ID da Conta WhatsApp Business e token de acesso permanente. Siga os passos 2 a 4 em Conectar com WhatsApp Cloud API (configuração manual). Seu token deve incluir whatsapp_business_messaging. Adicione também whatsapp_business_management, ou os modelos não serão sincronizados. Migrar a caixa de entrada 1. Vá até Configurações › Caixas de entrada e abra a caixa de entrada do WhatsApp. 2. No banner Configuração manual recomendada, clique em Iniciar migração manual. 3. Antes de começar: leia o que será mantido e atualizado, depois continue. 4. Detalhes da empresa: insira o ID do WABA e o ID do Número de Telefone. O Número de telefone exibido é mostrado apenas para referência e não pode ser alterado. 5. Token de acesso: cole seu token de acesso permanente. 6. Revisar migração: confira os detalhes e clique em Reconectar caixa de entrada do WhatsApp. O Chatwoot verifica seu token, conta e número na Meta antes de fazer qualquer alteração. Se alguma checagem falhar, a caixa de entrada mantém a conexão atual. Verifique se funcionou - Uma nova mensagem de cliente chega na caixa de entrada - Uma resposta do Chatwoot chega no telefone do cliente - Você pode enviar um modelo - Sincronizar modelos na aba Configuração traz seus modelos
Modelos e a janela de 24 horas
A janela de 24 horas O WhatsApp permite que você envie qualquer mensagem por 24 horas após a última mensagem do cliente. Depois disso, você só pode enviar um modelo: uma mensagem previamente aprovada pela Meta. - No Chatwoot, quando a janela está fechada, a caixa de resposta mostra: Você só pode responder usando uma mensagem de modelo devido à restrição da janela de mensagens de 24 horas - Assim que o cliente responder, uma nova janela de 24 horas é aberta e você pode digitar livremente novamente. - Para iniciar uma conversa com um cliente que ainda não te enviou mensagem, você também precisa de um modelo. Plano & acesso - Todo plano que inclui WhatsApp (Startups e superiores, e o teste gratuito). Funciona com inboxes WhatsApp Cloud API (Configuração rápida ou manual) e inboxes Twilio. Veja Preços & Planos. - Agentes no inbox podem enviar modelos. Administradores podem sincronizar modelos e gerenciar tokens. De onde vêm os modelos Os modelos são criados e aprovados fora do Chatwoot, depois sincronizados. Tipo de inbox Criar modelos em Sincronizar com o Chatwoot WhatsApp Cloud API WhatsApp Manager ( Ferramentas da conta › Modelos de mensagem ). A Meta revisa geralmente em 24h. Automaticamente após um tempo, ou imediatamente com Sincronizar Modelos na aba Configuração do inbox Twilio Twilio Console (Content Template Builder), enviado para aprovação no WhatsApp Automaticamente, ou com o botão de sincronizar nas configurações do inbox Apenas modelos aprovados e de um tipo suportado aparecem no Chatwoot. Enviar um modelo numa conversa 1. Abra a conversa e clique no ícone de modelo na caixa de resposta. 2. O seletor Modelos WhatsApp será exibido. Pesquise e selecione um modelo. 3. Preencha as variáveis, por exemplo o nome do cliente ou um número de pedido. Para cabeçalhos de mídia, cole uma URL pública da imagem, vídeo ou documento. 4. Confira a mensagem, que é atualizada conforme você preenche as variáveis, e clique em Enviar mensagem. Teste: envie um modelo para seu próprio número primeiro e veja como ele aparece no celular. Do que é composto um modelo Os modelos podem incluir cabeçalho, corpo, rodapé e botões: - Cabeçalho: texto, imagem, vídeo ou documento - Corpo: sua mensagem, com variáveis como o nome do cliente - Rodapé: uma linha curta de texto - Botões: respostas rápidas, links de site, números de telefone e copiar código Alguns tipos de modelos do WhatsApp ainda não podem ser usados no Chatwoot: autenticação (OTP), lista, produto e catálogo, carrossel, cabeçalhos de localização, permissão de chamadas e formulários, pagamentos e Flows. Mídia no cabeçalho do modelo O arquivo precisa estar em um link público que a Meta possa acessar, sem login. Limites da Meta: Tipo Formatos Tamanho máximo Imagem JPEG, PNG 5 MB Vídeo MP4, 3GPP (H.264 vídeo, AAC áudio) 16 MB Documento PDF 100 MB Outros tipos de documentos, como Word, Excel, PowerPoint e arquivos de texto, podem ser enviados como mensagens comuns dentro de uma conversa, mas não em um cabeçalho de modelo. Modelos de conteúdo Twilio suportam texto (até 100 variáveis), mídia, respostas rápidas e modelos de chamada para ação. Eles não podem ser usados em campanhas. Modelos de lista, catálogo e carrossel não são suportados. - Use variáveis numeradas, como 1, 2, 3, em ordem e sem pular. O número de variáveis preenchidas deve corresponder ao do modelo. - Confira o status de aprovação de um modelo no Twilio Console, não no WhatsApp Manager. - Se a sincronização falhar, verifique se o Account SID e Auth Token do inbox (ou API Key SID e API Key Secret) ainda são válidos no Twilio, depois sincronize novamente. Boas práticas - Modelos de utilidade (atualizações de pedido, lembretes) são para mensagens transacionais. Modelos de marketing precisam de opt-in do cliente e seguir as regras de envio da Meta. - Mantenha um conjunto pequeno de modelos bem nomeados que sua equipe saiba usar. - A Meta monitora a qualidade das mensagens. Muitas mensagens bloqueadas ou ignoradas podem baixar seu limite de envio. Veja Limite de mensagens em Gerencie seu número WhatsApp. Se os modelos não sincronizarem (Inboxes de configuração rápida) Às vezes as mensagens funcionam mas os modelos não sincronizam. Isso acontece quando a conexão feita durante a Configuração rápida perde permissão para ler sua Conta Empresarial do WhatsApp. Você pode corrigir fornecendo ao Chatwoot um token de Gestão de Negócios, usado apenas para sincronizar modelos. Plano & acesso: Chatwoot Cloud, apenas inboxes de Configuração rápida (incluindo Coexistência). Inboxes de configuração manual usam seu próprio token, então verifique se este token tem o escopo whatsapp_business_management. Você deve ser admin tanto no Chatwoot quanto na conta de negócios da Meta. 1. Em Configurações de Negócios da Meta, vá em Usuários › Usuários do sistema e selecione (ou crie) um usuário do sistema administrador. Um dedicado, como Chatwoot template sync, é mais fácil de gerenciar. 2. Clique em Atribuir ativos, escolha Contas WhatsApp, selecione a Conta Empresarial do WhatsApp conectada ao Chatwoot e conceda controle total. Atribua apenas essa conta. 3. Clique em Gerar token, escolha o aplicativo Meta vinculado àquela conta WhatsApp e selecione a validade (60 dias é mais seguro; Nunca exige menos manutenção). 4. Marque apenas whatsapp_business_management e copie o token. A Meta pode mostrar apenas uma vez. 5. No Chatwoot, acesse Configurações › Inboxes, abra o inbox, vá até a aba Configuração e encontre Adicionar token de Gestão de Negócios. Cole o token e clique em Adicionar. 6. Clique em Sincronizar Modelos. Trate o token como uma senha. Se você revogar no Meta, substitua no Chatwoot senão a sincronização dos modelos irá parar. - Token de 60 dias: a sincronização de modelos para quando expira. Gere um novo token e substitua o antigo. - Token sem expiração: ainda pode parar de funcionar se o usuário do sistema, app, permissão ou vínculo de ativo mudar. - Para substituir um token: após salvar um token, o campo diz Substituir token de Gestão de Negócios. Cole o novo token e clique em Substituir.
Campanhas no WhatsApp
Envie um modelo aprovado para cada contato com os rótulos que você escolher, em um horário agendado, e veja quem recebeu e leu. Plano & acesso - Chatwoot Cloud: As campanhas do WhatsApp estão disponíveis no plano Business e superiores. Elas estão ativadas automaticamente; você não precisa solicitá-las. - Self-hosted: Funciona em todos os planos. - Análise de campanhas: Plano Business e superiores na Cloud. No self-hosted, somente no plano Enterprise. O super admin da sua instalação ativa a Análise de Campanhas em Super Admin › Contas › abre a conta › Editar, em Recursos premium, e depois clica em Salvar alterações. - Caixa de entrada: Apenas WhatsApp Cloud API (Configuração rápida ou manual). Caixas de entrada Twilio e 360dialog não podem enviar campanhas. - Quem: administradores. Veja Preços & Planos. Como saber se você possui: abra Campanhas na barra lateral. Se WhatsApp aparece abaixo, as campanhas estão disponíveis para sua conta. Antes de começar Pelo menos um modelo aprovado na sua caixa de entrada WhatsApp Cloud API. Veja Modelos e a janela de 24 horas. Criar uma campanha 1. Vá em Campanhas › WhatsApp e clique em Criar campanha. 2. Configurações básicas: insira um Título e escolha sua Caixa de entrada do WhatsApp. O painel de Informações da conta mostra o nível de mensagens do número, status da conta e avaliação de qualidade da Meta. 3. Público: escolha um ou mais Rótulos. Contatos com qualquer um dos rótulos serão incluídos. Clique em Visualizar para ver exatamente quem será incluído. O painel mostra quantos clientes sua conta do WhatsApp pode enviar mensagens. 4. Modelo: escolha um modelo aprovado e preencha o cabeçalho, variáveis e botões dele. Verifique o Preview da mensagem. 5. Clique em Agendar campanha, escolha o horário e clique em Criar. Teste: envie a primeira campanha para um rótulo de teste que contenha apenas o seu próprio número. O botão Teste ao vivo no topo do formulário ainda não está disponível (o tooltip diz Teste ao vivo estará disponível em breve). O que esperar - A campanha é enviada uma vez, no horário agendado. Seu status muda de Agendada para Processando para Concluída. - Você pode editar enquanto ela estiver Agendada. Depois que começar a enviar, não poderá mais ser alterada. - Contatos sem número de telefone serão ignorados. - Somente modelos aprovados podem ser enviados. Não é possível enviar mensagens de texto livre no WhatsApp. - O número de clientes que você pode enviar mensagens por dia é definido pelo limite de mensagens da Meta, compartilhado entre todos os números do seu portfólio de negócios. Veja Gerencie seu número WhatsApp. - Quando os clientes respondem, uma nova conversa é aberta na caixa de entrada e a janela de 24 horas começa a contar. - Mensagens de campanha enviadas para um contato aparecem na conversa do WhatsApp dele, marcadas como Campanha. Veja os resultados Analytics está disponível no plano Business e superiores (Cloud), ou num plano self-hosted pago. Clique em Ver indicadores na campanha para ver: - Público, Enviado para o WhatsApp, Entregue, Lido, Falhou e Ignorado - A tabela de Entregas: status de cada contato e, nos casos de falhas ou pulados, o Motivo. Filtre pelo status. - Enquanto uma campanha estiver sendo enviada, os números são parciais. Campanhas enviadas antes da introdução do analytics de campanhas não terão analytics. Analytics pode não estar disponível para campanhas enviadas antes da introdução do rastreamento de entregas. Boas práticas - Crie um rótulo dedicado para cada campanha ao invés de reutilizar um rótulo amplo. - Use modelos de Utilidade para atualizações e modelos de Marketing apenas para clientes que deram opt-in. - Acompanhe sua avaliação de qualidade após cada campanha. Muitos bloqueios ou denúncias podem reduzir seu limite de mensagens. Solução de problemas Sintoma Causa provável O que fazer Não aparece WhatsApp em Campanhas Seu plano não inclui campanhas, ou você não é um administrador No Chatwoot Cloud, verifique se está no plano Business ou superior. Confira se está logado como administrador. Se ambos forem verdade e ainda não aparecer, entre em contato com o suporte Chatwoot. Minha caixa de entrada não está na lista É uma caixa Twilio ou 360dialog As campanhas exigem uma caixa de entrada WhatsApp Cloud API. Veja Escolha como conectar o WhatsApp Esta caixa não possui modelos aprovados que possam ser usados em campanha Sem modelos aprovados, ou não foram sincronizados Clique em Sincronizar Modelos . Veja Modelos e a janela de 24 horas Alguns contatos não receberam Sem número de telefone, rótulo ausente ou mensagem rejeitada pela Meta Abra Ver indicadores , filtre por Falhou ou Ignorado e veja o motivo. Para códigos de erro veja Não consigo editar a campanha Já começou a enviar Crie uma nova campanha Solução de problemas no WhatsApp
Pesquisas de CSAT no WhatsApp
Peça aos clientes para avaliar seu suporte quando uma conversa for resolvida, mesmo após a janela de 24 horas ter se encerrado. O Chatwoot cria o template do WhatsApp para você, envia para a Meta e envia assim que for aprovado. Plano & acesso - Todo plano que inclui WhatsApp (Startups e superiores, e o teste gratuito). Funciona com WhatsApp Cloud API e caixas de entrada Twilio. Veja Preços & Planos . - Administradores fazem a configuração. Configurando 1. Vá em Configurações › Caixas de entrada, abra sua caixa de entrada do WhatsApp e acesse a aba CSAT. 2. Ative Habilitar CSAT. 3. Preencha a Mensagem, o Texto do botão e o Idioma. A visualização mostra como ficará no WhatsApp. 4. Salve. O Chatwoot cria o template e envia para a Meta revisar. 5. Aguarde até o status mostrar Aprovado pelo WhatsApp. Opcional: clique em Verificar adequação de utilidade para ver se a Meta tende a tratar sua mensagem como Utilidade, com uma sugestão de reescrita. É apenas uma orientação, não uma garantia. Opcional: escolha quais conversas recebem a pesquisa usando regras de rotulagem. Teste: resolva uma conversa teste com seu próprio número. Você deverá receber a pesquisa com um botão que abre a página de avaliação. Status dos templates Status Significado Aguardando aprovação do WhatsApp A Meta está revisando o template Aprovado pelo WhatsApp As pesquisas são enviadas automaticamente quando as conversas são resolvidas Meta rejeitou o template A Meta recusou. Altere a mensagem e salve para reenviar. O que esperar - Uma pesquisa por conversa. - Enquanto o template não for aprovado, a pesquisa será enviada como mensagem comum apenas enquanto a janela de 24 horas estiver aberta. Se a janela estiver fechada, nenhuma pesquisa será enviada, e a conversa mostrará Pesquisa CSAT não enviada devido a restrições de mensagens de saída. - A Meta não permite editar templates aprovados. Quando você altera a mensagem, o texto do botão ou o idioma, o Chatwoot pede confirmação, exclui o template atual e envia um novo para aprovação. Até a aprovação da Meta, as pesquisas seguirão a regra acima. Se o salvamento falhar, tente novamente, pois o template anterior pode já ter sido excluído. Boas práticas - Mantenha a mensagem curta e amigável, com um texto claro no botão como "Avaliar agora". - Use regras de rotulagem para que apenas conversas relevantes recebam a pesquisa. - Altere o template raramente. Cada mudança pausa o envio das pesquisas até a aprovação do novo template pela Meta.
Chamada pelo WhatsApp
Clientes podem ligar para o seu negócio pelo WhatsApp, e os agentes atendem pelo navegador. Os agentes também podem ligar para clientes que concordaram em receber chamadas. Plano & acesso - Chatwoot Cloud: plano Business ou superior. Self-hosted: um plano pago com Enterprise Edition, a partir da v4.15.0. Instalar apenas a build do Enterprise Edition não habilita a função. Veja Preços & Planos. - Inbox: Apenas API do WhatsApp Cloud. Ambos os métodos de conexão funcionam, Configuração rápida e configuração manual. Não disponível para as inboxes WhatsApp Twilio ou 360dialog. - Seu número deve estar inscrito na API de Chamadas Empresariais do WhatsApp da Meta. - Administradores ativam a função. Agentes na inbox atendem e realizam chamadas. Como verificar se você possui: abra as configurações da inbox. Uma aba Chamadas significa que chamadas estão disponíveis para sua conta. Ativar chamadas Nova inbox: vá em Configurações › Inboxes › Adicionar Inbox › Chamada WhatsApp e complete a Configuração rápida. O Chatwoot ativa as chamadas durante a configuração. Inbox existente: 1. Vá em Configurações › Inboxes, abra sua inbox WhatsApp e acesse a aba Chamadas. 2. Ative a opção Habilitar chamadas WhatsApp. 3. Opcional: edite a Mensagem de solicitação de permissão de chamada que os clientes verão quando você pedir para ligar. 4. Opcional: altere as outras opções na aba Chamadas: - Permitir chamadas recebidas: se desativado, as chamadas recebidas são recusadas automaticamente, agentes não são notificados e nenhuma conversa é criada. Chamadas de saída continuam funcionando. - Gravar chamadas: anexa a gravação de cada chamada à conversa. - Transcrever gravações: aparece quando a gravação está ativada. Adiciona uma transcrição usando o Captain e requer a transcrição de áudio ativada na sua conta. Se você ver Não foi possível ativar chamadas de voz para este número, seu número ainda não está inscrito na API de Chamadas da Meta. Peça à Meta ou ao seu Provedor de Solução WhatsApp Business para inscrevê-lo e tente novamente. Antes da primeira chamada: cada agente deve permitir acesso ao microfone para o Chatwoot em seu navegador. Teste: de outro telefone, abra o WhatsApp, encontre sua empresa e toque em ligar. Uma notificação de chamada deve aparecer no Chatwoot. Atendendo e realizando chamadas - Recebida: uma janela de chamada mostra o nome do chamador, número e a caixa de entrada. Os agentes podem atender ou rejeitar a chamada. - Saída: em uma conversa, clique em Iniciar chamada WhatsApp. Se o cliente não tiver concordado em receber chamadas, o Chatwoot enviará uma solicitação de permissão: Solicitação de permissão de chamada enviada ao contato. Tente novamente após a aceitação. Assim que o cliente aceitar, faça a chamada novamente. - Estados da chamada exibidos na conversa: Chamada recebida, Chamada de saída, Chamada em andamento, Chamada encerrada, Chamada perdida, Sem resposta. - Gravações são anexadas à conversa quando disponíveis. Transcrições são adicionadas se sua conta tiver transcrição de áudio do Captain ativada. Quem recebe a chamada - Conversa atribuída: apenas a janela de chamada do responsável irá tocar, independentemente do status de disponibilidade dele. - Conversa não atribuída: agentes online da inbox tocam. - Ninguém online: todos os agentes da inbox e todos os administradores tocam. O primeiro agente a atender recebe a chamada. Se a conversa não tiver um responsável, o agente que atender será atribuído a ela. Quando um agente inicia uma chamada, a conversa é atribuída a ele se ainda não tiver responsável. Boas práticas - Peça permissão para ligar no início da conversa, não só quando precisar ligar. - Certifique-se de que os agentes que atendem chamadas estejam online, para não perder chamadas. Solução de problemas Sintoma Causa provável O que fazer Não existe aba Chamadas Seu plano não inclui chamadas (Business ou superior), ou a inbox não é WhatsApp Cloud API Verifique seu plano em Preços & Planos e o método de conexão em WhatsApp no Chatwoot Não foi possível ativar chamadas de voz O número não está inscrito na API de Chamadas da Meta Peça para a Meta ou seu provedor inscrevê-lo e tente novamente O agente não ouve ou não é ouvido O navegador não tem permissão de microfone Permita o acesso ao microfone para o Chatwoot nas configurações do navegador Solicitação de permissão de chamada já enviada recentemente O cliente ainda não respondeu à última solicitação Aguarde o cliente aceitar antes de tentar novamente
Gerencie seu número do WhatsApp
Veja a saúde do seu número, limite de mensagens e perfil comercial sem sair do Chatwoot. Plano & acesso - Todo plano que inclui WhatsApp (Startups e superiores, e o teste grátis), para caixas de entrada do WhatsApp Cloud API (Configuração rápida ou manual). Caixas de entrada do Twilio não têm esta aba. Confira Preços & Planos - Administradores. Abrir Saúde da Conta Vá em Configurações › Caixas de entrada, abra sua caixa do WhatsApp e escolha a aba Saúde da Conta. Clique em Ir para o Meta Business Manager para alterar qualquer coisa gerenciada pela Meta. O que você verá Seção O que informa Perfil comercial A descrição, endereço, e-mail e sites que os clientes veem no seu perfil do WhatsApp. Aqui é somente leitura: altere usando as ferramentas de gerenciamento do WhatsApp da Meta. Número de telefone Número exibido, nome de exibição no WhatsApp e status de revisão, status do número, se a Coexistência está ativa, e o ID do número de telefone Saúde e capacidade Classificação de qualidade (Verde, Amarelo, Vermelho), Limite de mensagens comerciais , modo da conta (Sandbox ou Produção) e throughput Conta comercial Nome e ID da Conta Comercial do WhatsApp, e o portfólio de negócios que a possui Configuração do webhook Se a URL de callback da Meta para este número aponta para esta caixa de entrada do Chatwoot. Webhook configurado com sucesso confirma apenas a configuração, não que as mensagens estão chegando. Se mostrar Webhook não configurado ou Incompatibilidade de URL do webhook , clique em Registrar webhook , depois envie uma mensagem teste para seu número e responda pelo Chatwoot. Limite de mensagens O Limite de mensagens comerciais é definido pela Meta: quantos clientes únicos você pode enviar mensagens fora da janela de 24 horas (com templates) em um período contínuo de 24 horas. É compartilhado por todos os números no seu portfólio comercial. A Meta aumenta conforme você envia mensagens de boa qualidade e pode diminuir se a qualidade cair. Nome de exibição Seu nome de exibição é o nome da empresa que aparece para os clientes. A Meta revisa esse nome. Status no Chatwoot Significado Aprovado Exibido no topo das conversas (um nome salvo pelo cliente pode aparecer no lugar) Ainda não revisado Salvo, mas os clientes podem ver seu número até a Meta revisar. A Meta inicia a revisão ao alcançar um limite maior de mensagens. Em revisão A Meta está revisando. Não altere novamente até o fim da análise. Não aprovado A Meta rejeitou. Altere no Meta Business Manager e envie novamente. Para ser aprovado na primeira tentativa: use o nome real da empresa ou marca, igual ao do seu site e do Meta Business Manager. Evite palavras genéricas ("Suporte", "Oficial"), emojis, símbolos, slogans e excesso de letras maiúsculas. Após mudar o nome de exibição, a Meta pode exigir que o número seja registrado novamente antes que as mensagens voltem ao normal. Veja Mensagens pararam de chegar em vTroubleshoot WhatsApp. Se a conexão precisar de atenção - Conexão do WhatsApp precisa ser atualizada (caixas de entrada de configuração rápida): clique em Reconectar WhatsApp na caixa de entrada, ou vá em Configuração e clique em Reconfigurar. É necessário acesso de administrador à Conta Comercial do WhatsApp. - Token de acesso do WhatsApp precisa de atenção (caixas de entrada com configuração manual): vá em Configuração e substitua o token de acesso por um token permanente válido.
Solucionar problemas do WhatsApp
Antes de mudar qualquer coisa: não exclua sua conta do WhatsApp, não remova sua Conta Comercial do WhatsApp nem desconecte um provedor como solução geral. A recuperação correta depende de como seu número está configurado hoje. Anote a mensagem de erro completa, qualquer código e a tela onde apareceu. Conexão Primeiro, saiba como seu número é usado hoje: um número novo, um número no aplicativo WhatsApp Business (use a Coexistência para manter o app), ou um número em outro provedor de API (estes usam caminhos diferentes). Veja Escolha como conectar o WhatsApp. O que você vê Código Meta O que significa e o que fazer Número não elegível, precisa de mais atividade no aplicativo WhatsApp Business 3441045 Uma verificação de elegibilidade da Coexistência. Continue usando o app normalmente com clientes reais e tente novamente mais tarde. A Meta não publica um mínimo. Não gere atividade falsa nem recrie a conta. Número não registrado no aplicativo WhatsApp Business 2655095, 2655048 Verifique o número e o código do país, e se está no app Business (não no WhatsApp pessoal). Para um número novo apenas API, utilize o caminho de novo número. Atualize o aplicativo 4563015 Instale o aplicativo WhatsApp Business mais recente e tente novamente. Empresa já compartilha essa conta com um parceiro 2655093 A Meta informa que essa Conta Comercial do WhatsApp já está associada a um parceiro. Isso não confirma se o outro provedor ainda está ativo. Não é possível trocar de parceiro neste fluxo. Fale com o suporte antes de desconectar qualquer coisa. Já registrado no produto ou desconecte sua plataforma comercial 3441049, 2655094 Uma conexão de plataforma existente deve ser tratada primeiro. Se você desconectar de propósito, a Meta exige uma espera de 15 minutos antes de tentar novamente. Número não associado à empresa selecionada 3441041 Escolha o portfólio de empresas que possui o número. Número vinculado a uma Página do Facebook 2655082 Verifique Meta Business Suite › Configurações › Contas › Páginas . Remova o vínculo com a Página (após confirmar com o administrador da Página) ou use outro número. Conta utiliza mensagens de marketing 3441047 Selecione outra Conta Comercial do WhatsApp. Tentar novamente não resolve. Empresa ou conta restrita 2655089, 3441040, 2388107 Abra o Meta Business Support Home , revise a restrição e faça recurso. Não crie novas contas para contornar. Verificação iniciada com outro parceiro 2494143 Continue com esse parceiro, ou solicite a Verificação Comercial da Meta diretamente. Recurso indisponível em sua região 3441042 Verifique o código do país. Se estiver correto, esse fluxo ainda não está disponível para o número. Código não pôde ser enviado ou verificado 2388091, 2388093 Verifique novamente o número e use um método que ele possa receber (fixos precisam de voz). Números de IVR não são suportados. Outros problemas de conexão - Conta ou portfólio ausente: faça login com a conta do Facebook que seja administrador do portfólio correto. "O usuário não tem permissão" significa que um administrador existente deve conceder acesso. - Conta do Facebook muito nova: aguarde algumas horas ou use uma conta já estabelecida com acesso comercial. - Verificação comercial em andamento: verifique em Meta Business Suite › Central de segurança. - Nome de exibição rejeitado: veja Nome de exibição em Gerencie seu número WhatsApp. - Limite de número de telefone atingido: escolha o número já listado, ou solicite um limite maior à Meta. Não exclua um número funcional. - "Você tentou adivinhar muitas vezes": aguarde cerca de 12 horas. "Solicitou seu código muitas vezes": siga o tempo de espera exibido pela Meta. - Prompt de coexistência ou código QR não funciona: use o app Business mais recente, mantenha o telefone online, mantenha a janela de cadastro aberta e verifique a permissão da câmera para códigos QR. - Janela Meta não abre ou trava: permita pop-ups, desative extensões de bloqueio, complete qualquer checagem de segurança da Meta e aguarde alguns minutos após um erro temporário. - Meta finalizou, mas não há inbox no Chatwoot: atualize e verifique Configurações › Caixas de entrada antes de tentar novamente. Não crie caixas de entrada duplicadas. - Histórico de chat de coexistência incompleto: mantenha o app aberto e online. A Meta sincroniza o histórico apenas dentro de 24 horas após conectar. Contate o suporte rapidamente em vez de reconectar. Recebendo e enviando mensagens Sintoma Causa provável O que fazer Mensagens pararam de chegar , mas o número aparece como Conectado e qualidade Verde Algo na conexão precisa de atenção: registro, permissões ou o webhook. Isso geralmente ocorre após uma alteração no nome de exibição ou perfil. Após qualquer correção, envie uma mensagem teste para seu número e responda no Chatwoot para confirmar os dois sentidos. Contate o suporte primeiro para que possamos verificar o registro, permissões e webhook no seu inbox existente. Se precisar registrar o número novamente, faça isso você mesmo na Meta, seguindo o processo da Meta. Não exclua o número nem crie nova inbox. Números de Coexistência precisam de um caminho de recuperação diferente, então contate o suporte antes de alterar qualquer coisa. Nenhuma mensagem chega após configuração Uma possível razão: o webhook não está registrado ou aponta para outro lugar Abra a Saúde da Conta . Se Configuração do Webhook mostrar Webhook não configurado ou URL do Webhook incompatível , clique em Registrar Webhook . Depois, teste: envie uma mensagem para seu número de outro telefone, verifique se chegou no Chatwoot, e responda do Chatwoot. Se mostrar como configurado mas ainda não chegam mensagens, contate o suporte. Para Twilio, verifique o Callback URL na Twilio (página 5). Você só pode responder usando uma mensagem modelo Mais de 24 horas desde a última mensagem do cliente Envie um modelo. Veja Templates e a janela de 24 horas Uma mensagem falha com o erro 131049 A Meta não entregou este modelo de marketing para preservar a qualidade do engajamento. O WhatsApp limita quantas mensagens de marketing cada pessoa recebe de todas as empresas. Não reenvie nem clique em Tentar novamente imediatamente. Aguarde pelo menos 24 horas antes de enviar outro modelo de marketing para esta pessoa. Modelos utilitários não são afetados. Se o cliente responder, mensagens de marketing dentro da janela de 24 horas não contam no limite. A conexão com o WhatsApp precisa ser atualizada / Reconectar WhatsApp A conexão de Configuração rápida expirou Clique em Reconectar WhatsApp . Veja Gerencie seu número WhatsApp Token de acesso do WhatsApp requer atenção O token da configuração manual expirou ou foi revogado Substitua na aba Configuração do inbox Templates Sintoma Causa provável O que fazer Um template não aparece no Chatwoot Ainda não aprovado, não sincronizado ou tipo não suportado pelo Chatwoot Verifique o status dele no WhatsApp Manager e clique em Sincronizar Templates . Veja os tipos suportados na página 7. Mensagens funcionam mas templates nunca sincronizam (Configuração rápida) A conexão perdeu a permissão para ler sua Conta Comercial do WhatsApp Adicione um token de Gerenciamento Comercial (página 7) Token de Gerenciamento Comercial: Token deve conceder permissão whatsapp_business_management whatsapp_business_management não foi selecionado Gere um novo token com essa permissão Token de Gerenciamento Comercial: sem permissão de acesso ou token inválido O usuário do sistema não tem acesso à conta WhatsApp, ou o token expirou ou pertence a outro app Verifique os ativos e app atribuídos ao usuário e gere um novo token Token aceito, templates ainda ausentes O token acessa outra Conta Comercial do WhatsApp Confirme que o usuário do sistema tem a exata conta usada pelo inbox, e que os templates existem ali Um template falha ao enviar, ou mídia não aparece Variáveis vazias, link de mídia privado ou quebrado, ou arquivo acima dos limites da Meta Preencha todas as variáveis, use link público, verifique formato e tamanho (página 7) Botão de URL dinâmica não funciona Problema conhecido com certos setups de botão de URL dinâmico Use uma URL estática no template Contatos e números de telefone Números aparecem diferentes no WhatsApp e no Chatwoot (Brasil, México, Argentina). Esses países mudaram os formatos de números móveis, e o WhatsApp pode usar o antigo: - Brasil: um 9 foi adicionado após o DDD (+55 11 9 8765-4321 vs +55 11 8765-4321). - Argentina: um 9 após o código do país pode ou não estar presente (+54 9 11 ... vs +54 11 ...). - México: o WhatsApp pode adicionar um 1 após o código do país (+52 1 ... vs +52 ...). O Chatwoot faz o ajuste automaticamente para o mesmo contato, então você não terá duplicatas. O número pode apenas aparecer diferente nos dois lugares. Contate o suporte Se ainda estiver com problemas, contate o suporte Chatwoot com: - A mensagem de erro completa e o código, e uma captura de tela - Em qual etapa ocorreu a falha e se o erro apareceu na Meta ou no Chatwoot - O link do seu inbox, o número comercial com código do país, e o horário da tentativa com fuso horário - Como o número é usado: novo, app WhatsApp Business ou outro provedor - Para Coexistência: versão do app, há quanto tempo é usado e se ainda funciona no telefone - Seu ID do portfólio comercial, ID da Conta Comercial do WhatsApp e ID do Número de Telefone, todos identificados Nunca compartilhe sua senha, token de acesso, código de verificação ou PIN em duas etapas. Oculte-os em capturas de tela. O Chatwoot não pode mediar decisões ou revisões da Meta.