Integração com WhatsApp

Por Manuela Farias and 6 outros

• 11 artigos

Como conectar um número do WhatsApp sem coexistência (exclusivamente via API)

Quando usar - Você quer conectar um número ao Cloud Chat que funcionará exclusivamente via API, sem celular - Você está criando uma operação 100% digital, com atendimento via helpdesk ou automação - Você não precisa usar o número no WhatsApp Business App do celular - Você quer maior estabilidade, sem conflito entre dispositivos Pré-requisitos :::error Iniciar a integração sem validar os pontos abaixo pode resultar em perda do número, bloqueio pela Meta, erros no processo de verificação ou necessidade de refazer toda a configuração. ::: :::warning Migração de número existente? Leia o guia de migração primeiro — leitura obrigatória. Se o número que você quer conectar já está ativo em outra plataforma de atendimento ou em outro provedor (BSP), NÃO inicie o fluxo de integração no Cloud Chat antes de ler: Migrando o WhatsApp para o Cloud Chat a partir de outra plataforma de atendimento Pular essa etapa pode resultar em: - Falhas no processo de verificação e migração travada - Impossibilidade de liberar o número do provedor anterior - Necessidade de refazer toda a configuração do zero O guia de migração mostra todos os pré-requisitos da Meta (propriedade da WABA, Verificação em Duas Etapas, status do Business Manager, método de pagamento, histórico de mensagens) que precisam ser validados antes de realizar a integração no Cloud Chat. ::: :::warning Número já cadastrado no WhatsApp Business App do celular? A integração sem coexistência (este artigo) NÃO permite que o número continue funcionando no WhatsApp Business App. Para seguir por aqui, você terá que: 1. Excluir a conta do número no WhatsApp Business App (apagar o app ou remover a conta dentro dele) antes de iniciar o Cadastro Incorporado 2. Aceitar que o número deixará de funcionar no celular após a integração — todas as mensagens passarão a chegar exclusivamente no Cloud Chat Se você quer manter o número funcionando no WhatsApp Business App em paralelo ao Cloud Chat, NÃO siga este artigo. Use o método de coexistência: Como conectar um número do WhatsApp com coexistência (celular + API) ::: :::warning Número novo? É preciso aquecer antes de tentar integrar. A Meta avalia o histórico de uso do número antes de liberar a conexão via API. Números recém-criados, sem histórico no WhatsApp Business App, podem ser barrados logo no Cadastro Incorporado — a Meta retorna o erro: Seu número de telefone não está qualificado para se conectar à plataforma do WhatsApp Business. Mais atividades no app WhatsApp Business são necessárias para ajudar a determinar a qualificação. (#3441045) Como aquecer antes de integrar: - Use o número no WhatsApp Business App (celular) por alguns dias / semanas, recebendo conversas reais - Divulgue o número nos seus canais (site, redes sociais, e-mail) para gerar entrada orgânica - Responda dentro da janela de 24h, sem spam, sem mensagens repetidas, sem links suspeitos Depois do aquecimento, o número entra na API com tier e Quality Rating melhores e o Cadastro Incorporado passa sem o erro acima. Documentação oficial da Meta: Messaging Limits · Quality Rating. ::: :::warning Validando o Status do Portfólio Empresarial O Portfólio Empresarial (Business Portfolio) precisa estar com o status "Verificada" na Meta. Isso significa que a Meta reconheceu e validou a identidade da sua empresa. Por que isso importa? Sem a verificação, você está sujeito a limites muito baixos de envio (até 250 mensagens/dia), não pode migrar números de outros provedores e pode ter restrições em funcionalidades da API. A verificação é o primeiro requisito para uma operação saudável na plataforma da Meta. Como verificar: 1. Acesse ++business.facebook.com/settings/info++ 2. Verifique o campo Status da verificação 3. Deve estar como "Verificada" ✅ Se estiver como "Não verificada" ou "Pendente", clique em Iniciar verificação e siga o processo com documentos e domínio da empresa antes de continuar. ::: Passo a passo da integração sem coexistência :::info Com todos os pré-requisitos acima validados, você já pode iniciar a integração. Para isso, tenha em mãos: - Ser administrador da conta no Cloud Chat - Acesso de administrador ao Portfólio Empresarial na Meta (necessário para autorizar a conexão no fluxo de Embedded Signup) - Acesso ao número para receber o código de verificação por SMS ou ligação - Cartão de crédito habilitado para pagamento em dólar — obrigatório em migração de plataforma de atendimento ou para disparos proativos ::: Etapa 1 — Acessar as Configurações do Cloud Chat 1. No Cloud Chat, acesse Configurações 1. Vá até a seção Caixas de Entrada Etapa 2 — Iniciar a criação da caixa de entrada de WhatsApp 1. Clique em Adicionar Caixa de Entrada 1. Selecione WhatsApp 1. Na tela do Canal do WhatsApp, escolha o provedor Cadastro Incorporado (Embedded Signup) e preencha o nome desejado para a caixa de entrada. Depois, clique em Entrar via WhatsApp para iniciar o fluxo integrado Etapa 3 — Autenticar na Meta No pop-up da Meta que será aberto, faça login com a conta pessoal do Facebook da pessoa que tem acesso de administrador ao Portfólio Empresarial (Business Portfolio) da empresa na Meta. :::warning O login não é feito com um e-mail corporativo genérico nem com uma "conta da empresa" — é com o Facebook pessoal de quem é admin do portfólio empresarial da Meta. Sem essa permissão administrativa, o fluxo de Cadastro Incorporado não consegue autorizar a conexão e a integração trava nesta etapa. ::: 1. Após o login, clique em Continuar Etapa 4 — Selecionar Business Portfolio e iniciar conta WhatsApp 1. Escolha o Business Portfolio na Meta e clique em Avançar 1. Selecione Começar com um novo número de telefone WhatsApp e clique em Avançar :::info Se quiser conectar um número que já está no WhatsApp Business App (modo coexistência), interrompa este fluxo e siga o passo a passo de integração com coexistência. ::: 1. Selecione Criar uma Conta Comercial do WhatsApp e clique em Avançar Etapa 5 — Configurar a Conta Comercial e o número 1. Insira o nome da Conta Comercial do WhatsApp, o nome de exibição e escolha uma categoria válida 1. Selecione Adicionar um novo número, insira o número de telefone e verifique-o :::warning Se o número for um telefone fixo ou número digital, a verificação deverá ser feita por chamada telefônica, não SMS. ::: Etapa 6 — Concluir e configurar pagamento (se aplicável) :::error Quando o cadastro do método de pagamento é OBRIGATÓRIO: - Migração de número existente — sempre obrigatório, sem exceção. Sem método de pagamento válido, a Meta não conclui a migração da WABA. - Disparo proativo (template / campanha / mensagem unitária via API) — obrigatório, porque a Meta cobra por template enviado fora da janela de 24h. - Reabertura da janela de 24h da Meta — obrigatório. Para iniciar uma nova conversa com um cliente fora da janela ativa, é preciso disparar um template, e isso tem custo direto cobrado pela Meta no cartão cadastrado. - Pesquisa de satisfação (CSAT) — a mensagem de CSAT também é um template da Meta. Se ela for disparada fora da janela de 24h (caso comum quando o cliente não responde logo após o atendimento), sem método de pagamento cadastrado a CSAT não é enviada — o cliente não recebe a pergunta de avaliação e a métrica fica vazia. Sem cartão válido cadastrado na WABA, nenhuma mensagem proativa sai, nenhuma janela é reaberta e nenhum CSAT é entregue fora da janela — o número fica restrito a responder dentro das 24h após a última mensagem do cliente. ::: 1. Clique em Adicionar método de pagamento para ir adicionar o método de pagamento na WABA. Para atendimento puramente reativo (responder mensagens dentro da janela de 24h, sem disparos proativos e sem migração), clique em "Finish". Etapa 7 — Adicionar agentes à caixa de entrada 1. Configure os agentes que terão acesso à nova caixa de entrada 1. Clique em Adicionar agentes :::success A caixa de entrada está pronta para enviar e receber mensagens no WhatsApp. ✅ ::: Observações - Migração: se este é um número já em uso em outra plataforma, NÃO siga este artigo isolado — comece pelo Guia de Migração para validar os pré-requisitos da Meta antes do embedded signup - WhatsApp Business App: a integração via API não convive com o número ativo no WhatsApp Business App do celular — exclua a conta do app antes de seguir, ou use coexistência se quiser manter o celular ligado - Templates da Meta: para qualquer envio proativo ou reabertura da janela de 24h, é preciso ter cartão válido + template aprovado — veja Regras de templates do WhatsApp (Meta) e Como criar, editar e excluir templates de WhatsApp no Cloud Chat - Método de pagamento é obrigatório para migração, envios proativos e reabertura de janela de 24h — para atendimento reativo dentro da janela ativa, não é necessário no momento da integração - Para manter o número funcionando no celular em paralelo, use a integração com coexistência - Em caso de dúvida ou erro, acione o suporte antes de prosseguir — ajustes feitos incorretamente podem gerar bloqueio do número - Documentação oficial da Meta: Meta Developers — Embedded Signup

Última atualização em May 08, 2026

Como conectar um número do WhatsApp com coexistência (App + API)

Quando usar - Você já usa o número no WhatsApp Business App (celular) e quer continuar usando - Você quer testar a API e automações sem abrir mão do uso manual via celular - Seu time (vendedores, consultores, account managers) precisa continuar usando o celular - Você quer uma transição gradual para a API sem interromper a operação atual Limitação importante da coexistência: dispositivos não suportados A Meta tem uma limitação oficial no modelo de coexistência: mensagens trocadas pelo WhatsApp Desktop (Windows) ou pelo WhatsApp em WearOS não chegam ao Cloud Chat — mesmo que apareçam no celular e também não chegam ao destinatário. Essa limitação só afeta coexistência; no modelo sem coexistência (API exclusiva) o problema não existe. Relato típico do cliente: As mensagens enviadas pelo agente não estão chegando para o cliente. As mensagens do cliente aparecem no celular, mas não no Cloud Chat. :::info Detalhes técnicos na documentação oficial da Meta — em resumo, esses apps não disparam o webhook smb_message_echoes que a API usa pra espelhar a conversa. ::: Como contornar Migrar para o modelo SEM coexistência (API exclusiva): todas as mensagens passam pela API, não há mais conflito entre dispositivos, e o número deixa de funcionar no celular. Passo a passo: Como conectar um número do WhatsApp via API oficial (sem coexistência). Pré-requisitos :::error Iniciar a integração sem validar os pontos abaixo pode resultar em perda do número, bloqueio pela Meta, erros no processo de verificação ou necessidade de refazer toda a configuração. ::: :::warning Migração de número existente? Leia o guia de migração primeiro — leitura obrigatória. Se o número que você quer conectar já está ativo em outra plataforma de atendimento ou em outro provedor (BSP), NÃO inicie o fluxo de Cadastro Incorporado antes de ler: Migrando o WhatsApp para o Cloud Chat a partir de outra plataforma de atendimento Pular essa etapa pode resultar em: - Falhas no processo de verificação e migração travada - Impossibilidade de liberar o número do provedor anterior - Necessidade de refazer toda a configuração do zero O guia de migração mostra todos os pré-requisitos da Meta (propriedade da WABA, Verificação em Duas Etapas, status do Business Manager, método de pagamento, histórico de mensagens) que precisam ser validados antes de realizar a integração no Cloud Chat. ::: :::warning Número novo? É preciso aquecer antes de tentar integrar. A Meta avalia o histórico de uso do número antes de liberar a conexão via API. Números recém-criados, sem histórico no WhatsApp Business App, podem ser barrados logo no Cadastro Incorporado — a Meta retorna o erro: "Seu número de telefone não está qualificado para se conectar à plataforma do WhatsApp Business. Mais atividades no app WhatsApp Business são necessárias para ajudar a determinar a qualificação." (#3441045) Como aquecer antes de integrar: - Use o número no WhatsApp Business App (celular) por alguns dias / semanas, recebendo conversas reais - Divulgue o número nos seus canais (site, redes sociais, e-mail) para gerar entrada orgânica - Responda dentro da janela de 24h, sem spam, sem mensagens repetidas, sem links suspeitos Depois do aquecimento, o número entra na API com tier e Quality Rating melhores e o Cadastro Incorporado passa sem o erro acima. Documentação oficial da Meta: Messaging Limits · Quality Rating. ::: :::warning Validando o Status do Portfólio Empresarial O Portfólio Empresarial (Business Portfolio) precisa estar com o status "Verificada" na Meta. Isso significa que a Meta reconheceu e validou a identidade da sua empresa. Por que isso importa? Sem a verificação, você está sujeito a limites muito baixos de envio (até 250 mensagens/dia), não pode migrar números de outros provedores e pode ter restrições em funcionalidades da API. A verificação é o primeiro requisito para uma operação saudável na plataforma da Meta. Como verificar: 1. Acesse ++business.facebook.com/settings/info++ 2. Verifique o campo Status da verificação 3. Deve estar como "Verificada" ✅ Se estiver como "Não verificada" ou "Pendente", clique em Iniciar verificação e siga o processo com documentos e domínio da empresa antes de continuar. ::: :::warning Não usa WhatsApp Business App no celular? A coexistência foi feita pra quem mantém o número ativo no celular (WhatsApp Business App) em paralelo à API. Se você não vai usar o número no celular — só no Cloud Chat / API — esse modelo não faz sentido. Use o método sem coexistência: Como conectar um número do WhatsApp via API oficial (sem coexistência) ::: :::warning Número já cadastrado e ativo no WhatsApp Business App (celular) antes de iniciar — a coexistência só funciona se o número já estiver vinculado e em uso no app antes do Cadastro Incorporado. Se o número ainda não está no WhatsApp Business App, instale o app e cadastre o número. ::: Passo a passo da integração com coexistência :::info Com todos os pré-requisitos acima validados, você já pode iniciar a integração. Para isso, tenha em mãos: - Ser administrador da conta no Cloud Chat - Acesso de administrador ao Portfólio Empresarial na Meta (necessário para autorizar a conexão no fluxo de Embedded Signup) - Ter o celular com o WhatsApp Business App em mãos para ler o QR code na sincronização - Cartão de crédito habilitado para pagamento em dólar — obrigatório em migração de plataforma de atendimento ou para disparos proativos ::: Etapa 1 — Acessar as Configurações do Cloud Chat 1. No Cloud Chat, acesse Configurações 1. Vá até a seção Caixas de Entrada Etapa 2 — Iniciar a criação da caixa de entrada de WhatsApp 1. Clique em Adicionar Caixa de Entrada 1. Selecione WhatsApp 1. Na tela do Canal do WhatsApp, escolha o provedor Cadastro Incorporado (Embedded Signup) e preencha o nome desejado para a caixa de entrada. Depois, clique em Entrar via WhatsApp Etapa 3 — Autenticar na Meta No pop-up da Meta que será aberto, faça login com a conta pessoal do Facebook da pessoa que tem acesso de administrador ao Portfólio Empresarial (Business Portfolio) da empresa na Meta. :::warning O login não é feito com um e-mail corporativo genérico nem com uma "conta da empresa" — é com o Facebook pessoal de quem é admin do portfólio empresarial da Meta. Sem essa permissão administrativa, o fluxo de Cadastro Incorporado não consegue autorizar a conexão e a integração trava nesta etapa. ::: 1. Após o login, clique em Continuar Etapa 4 — Selecionar Business Portfolio e ativar coexistência 1. Escolha o Business Portfolio na Meta e clique em Avançar 1. Selecione Conectar WhatsApp Business App existente e clique em Avançar Etapa 5 — Verificar o número 1. Selecione Adicionar um novo número, insira o número de telefone e verifique-o :::warning Se o número for um telefone fixo ou número digital, a verificação deverá ser feita por chamada telefônica, não SMS. ::: Etapa 6 — Sincronizar com o WhatsApp Business App via QR code 1. Após a verificação, clique em Concluir para iniciar a sincronização com o WhatsApp Business App 2. Abra o WhatsApp Business no celular, leia o QR code e siga as instruções no aparelho Importação do histórico de contatos e mensagens No momento da integração, o celular receberá uma notificação solicitando a importação do histórico do número. Ao confirmar, a Meta sincroniza automaticamente o histórico de mensagens e contatos dos últimos 6 meses para o Cloud Chat. :::warning Embora a importação esteja prevista na documentação oficial da Meta, em integrações recentes observamos que a Meta pode não enviar o histórico completo no momento da sincronização. É comum que parte das mensagens ou alguns contatos não sejam importados. Esse comportamento é intermitente e fora do controle do Cloud Chat, pois depende da entrega da Meta. Mantenha registros paralelos se necessário. ::: Etapa 7 — Configurar pagamento (se aplicável) :::error Quando o cadastro do método de pagamento é OBRIGATÓRIO: - Migração de número existente — sempre obrigatório, sem exceção. Sem método de pagamento válido, a Meta não conclui a migração da WABA. - Disparo proativo (template / campanha / mensagem unitária via API) — obrigatório, porque a Meta cobra por template enviado fora da janela de 24h. - Reabertura da janela de 24h da Meta — obrigatório. Para iniciar uma nova conversa com um cliente fora da janela ativa, é preciso disparar um template, e isso tem custo direto cobrado pela Meta no cartão cadastrado. - Pesquisa de satisfação (CSAT) — a mensagem de CSAT também é um template da Meta. Se ela for disparada fora da janela de 24h (caso comum quando o cliente não responde logo após o atendimento), sem método de pagamento cadastrado a CSAT não é enviada — o cliente não recebe a pergunta de avaliação e a métrica fica vazia. Sem cartão válido cadastrado na WABA, nenhuma mensagem proativa sai, nenhuma janela é reaberta e nenhum CSAT é entregue fora da janela — o número fica restrito a responder dentro das 24h após a última mensagem do cliente. ::: 1. Clique em Adicionar método de pagamento para ir adicionar o método de pagamento na WABA. Para atendimento puramente reativo (responder mensagens dentro da janela de 24h, sem disparos proativos e sem migração), clique em "Finish". Etapa 8 — Adicionar agentes à caixa de entrada 1. Configure os agentes que terão acesso à nova caixa de entrada 1. Clique em Adicionar agentes :::success A caixa de entrada com coexistência está integrada e pronta para uso. ✅ ::: Observações :::error O Cloud Chat aparece no celular como dispositivo conectado, em WhatsApp Business App → Dispositivos Conectados Se alguém remover o Cloud Chat da lista de dispositivos no celular, a integração será desfeita e será necessário refazer todo o processo. ::: - Templates da Meta: para qualquer envio proativo ou reabertura da janela de 24h, é preciso ter cartão válido + template aprovado — veja Regras de templates do WhatsApp (Meta) e Como criar, editar e excluir templates de WhatsApp no Cloud Chat - Método de pagamento é obrigatório para migração, envios proativos e reabertura de janela de 24h — para atendimento reativo dentro da janela ativa, não é necessário no momento da integração - Documentação oficial da Meta: Meta Developers — Embedded Signup with Coexistence

Última atualização em May 08, 2026

Migrando o WhatsApp para o Cloud Chat a partir de outra plataforma de atendimento

Quando usar - Você está trocando de plataforma de atendimento (Zendesk, Intercom, Zenvia, Twilio, Take Blip, etc.) e precisa trazer o número junto. Pré-requisitos :::error Antes de iniciar a migração, confirme todos os itens abaixo. Pular qualquer um pode resultar em perda do número ou bloqueio pela Meta. ::: - Acesso ao número para receber SMS ou ligação de verificação - Acesso de administrador ao Portfólio Empresarial na Meta - Status do Portfólio Empresarial: "Verificada" - Status da WABA: "Aprovada" - Status do número: "Conectado" - Verificação de dois fatores desativada do número na WABA (etapa mais crítica — veja abaixo) - Cartão de crédito habilitado para pagamento em dólar — obrigatório em migração de plataforma de atendimento ou para disparos proativos Passo a passo da migração Etapa 1 — Confirmar status do Portfólio Empresarial Validando o Status do Portfólio Empresarial O Portfólio Empresarial (Business Portfolio) precisa estar com o status "Verificada" na Meta. Isso significa que a Meta reconheceu e validou a identidade da sua empresa. Por que isso importa? Sem a verificação, você está sujeito a limites muito baixos de envio (até 250 mensagens/dia), não pode migrar números de outros provedores e pode ter restrições em funcionalidades da API. A verificação é o primeiro requisito para uma operação saudável na plataforma da Meta. Como verificar: 1. Acesse business.facebook.com/settings/info 2. Verifique o campo Status da verificação 3. Deve estar como "Verificada" ✅ :::warning Se estiver como "Não verificada" ou "Pendente", clique em Iniciar verificação e siga o processo com documentos e domínio da empresa antes de continuar. ::: Etapa 2 — Confirmar propriedade da WABA e validar os pré-requisitos O que é a WABA? WABA significa WhatsApp Business Account — é a entidade criada pela Meta que representa a conta oficial do WhatsApp da sua empresa. É através da WABA que um número de telefone é conectado à API oficial e vinculado a um provedor de atendimento (como o Cloud Chat). A WABA fica sempre dentro de um Portfólio Empresarial (Business Portfolio) na Meta. Quem detém esse portfólio é, na prática, o dono da WABA. :::warning ⚠️ Em muitos casos, o provedor anterior criou e mantém a WABA no portfólio deles — e não no seu. Isso significa que você não tem controle administrativo sobre o seu próprio número. Antes de migrar, é fundamental confirmar onde a sua WABA está. ::: Como confirmar que você é o dono da WABA: 1. Acesse o Business Manager da Meta 2. No menu lateral, vá em Configurações → WhatsApp Accounts 1. Você pode localizar a WABA correspondente ao seu número na listagem ou utilizando a barra de busca. :::success Se ela aparecer no seu portfólio → você tem controle. Siga para a validação dos pré-requisitos abaixo. ::: :::warning Se ela não aparecer (ou estiver no portfólio do provedor anterior) → acione nosso time de suporte antes de continuar. Será necessário solicitar a transferência da WABA para o seu portfólio antes de migrar. ::: Validando o Status da WABA: "Aprovada" Com a WABA localizada no seu portfólio, confirme que o status dela está como "Aprovada": 1. Ainda no WhatsApp Manager, localize sua WABA :::success O status deve aparecer como "Aprovada" ✅. Além disso, deve existir uma forma de pagamento válida cadastrada em "Payment Settings". ::: :::warning Se estiver como "Restrita" ou "Sinalizada", a WABA tem pendências junto à Meta que precisam ser resolvidas antes da migração. ::: Validando o Status do número: "Conectado" O número que será migrado precisa estar com status "Conectado" na WABA: 1. Dentro da WABA, vá em WhatsApp Manager. Uma nova aba será aberta no seu navegador com a listagem dos números vinculados na WABA selecionada. :::success O número deve aparecer com o status "Conectado" ✅ ::: :::warning Se estiver como "Desconectado" ou "Offline", é necessário resolver essa situação antes de iniciar a migração. ::: Etapa 3 — Desativar a Verificação de Dois Fatores da WABA :::error Esta é a etapa mais crítica e a que mais causa problemas em migrações. ::: A verificação de dois fatores (Two-Step Verification) é um PIN de segurança configurado no número dentro da WABA. Enquanto estiver ativa, a Meta não permite que o número seja migrado para outro provedor. Como desativar: 1. Acesse o WhatsApp Manager 2. Selecione o número que será migrado 3. Clique em Configurações → Verificação em dois passos 1. Clique em Desativar :::warning ⚠️ Se o seu provedor atual controla o Two-Step Verification (situação comum quando a WABA foi criada pelo provedor), você precisará solicitar a eles que desativem. Sem isso, a migração não é tecnicamente possível. ::: Etapa 4 — Iniciar a integração com o Cloud Chat :::info Com todos os pré-requisitos validados, você já pode iniciar a integração. Para isso, tenha em mãos: - Acesso de administrador ao Portfólio Empresarial na Meta (necessário para autorizar a conexão no fluxo de Embedded Signup) - Acesso ao número para receber o código de verificação por SMS ou ligação - Cartão de crédito válido para pagamento em dólar — durante o processo, o Cloud Chat criará uma nova WABA vinculada ao seu portfólio com a Cloud Humans como parceira (Tech Provider) na Meta. Essa WABA precisará de uma forma de pagamento cadastrada ::: 📌 Como funciona a WABA criada pelo Cloud Chat? Ao integrar, o Cloud Chat cria uma WABA dentro do seu portfólio na Meta, com a Cloud Humans registrada como parceira (Tech Provider). Isso significa que você permanece dono da sua WABA — a Cloud Humans apenas opera como o canal técnico de conexão com a API. Você pode desvincular a qualquer momento sem perder o número. Escolha o modelo de integração e siga o passo a passo correspondente: - 👉 Integração SEM coexistência (API exclusiva) — número funciona exclusivamente via API, sem uso no celular - 👉 Integração COM coexistência (Celular + API) — número funciona no celular e na API simultaneamente :::warning Se ainda não sabe qual modelo de integração escolher (com ou sem coexistência), leia primeiro o ++Guia Mestre++. ::: Etapa 5 — Validar com o time da Cloud Antes de iniciar a conexão, envie para nosso time a confirmação de que todos os pré-requisitos foram validados. Isso garante suporte imediato em caso de qualquer intercorrência durante o processo. Observações - A migração pode levar de alguns minutos dependendo do provedor anterior e da resposta da Meta. - Após a migração, o histórico de mensagens do provedor anterior não é importado automaticamente — mensagens antigas ficam no sistema do provedor anterior. - Se precisar importar tickets antigos para o Cloud Chat, isso é possível via API. Consulte: Import de histórico de tickets. - Nunca faça ajustes se estiver em dúvida — um erro nesse processo pode gerar bloqueio do número. Acione o suporte antes de prosseguir. - Documentação oficial da Meta sobre migração entre provedores: Meta Developers — Migrating phone numbers.

Última atualização em May 08, 2026

Regras de templates do WhatsApp (Meta): categorias, estrutura e reprovações

Quando usar - Você está criando um template e quer saber como evitar reprovação pela Meta - Seu template foi reprovado e você precisa entender o motivo - Você quer entender a diferença entre Authentication, Utility e Marketing - Você quer um checklist final antes de submeter para aprovação Sobre este artigo Este guia explica as regras oficiais da Meta que impactam a aprovação de templates. Aqui você encontra: - Estrutura (Header, Body, Footer, Buttons) - Uso correto de variáveis (placeholders) - Diferença entre Authentication, Utility e Marketing - Principais motivos de reprovação - Checklist para aumentar chances de aprovação :::info Se você quer aprender como criar, editar ou excluir templates dentro do Cloud Chat (parte operacional, não regras), vá para Como criar, editar e excluir templates no Cloud Chat. ::: O que é um template Templates são mensagens pré-aprovadas pela Meta para envios iniciados pela empresa (notificações, atualizações transacionais, autenticação e campanhas), normalmente usados quando você precisa enviar mensagem após a janela de 24h de inatividade. Documentação oficial da Meta sobre categorização: Meta Developers — Template Categorization. Estrutura de um template (componentes) Um template é composto por até 4 blocos principais: Header (opcional) - Texto: até 60 caracteres, suporta 1 variável - Mídia: pode ser configurado como imagem, vídeo ou documento (ver seção "Anexos") Body (obrigatório) - Texto principal do template - Suporta variáveis - Limite: até 1.024 caracteres Footer (opcional) - Observações curtas (ex: "Não responda esta mensagem") - Limite: até 60 caracteres Buttons (opcional) - Templates podem ter até 10 botões (depende do tipo/categoria) :::warning Se houver mais de 3 botões, o WhatsApp pode mostrar apenas parte e agrupar o restante em "Ver todas as opções". ::: Variáveis (placeholders) — regras que mais reprovam As variáveis permitem personalizar o conteúdo (nome do cliente, número do ticket, status). Regras obrigatórias da Meta 1. Não pode começar ou terminar com variável A Meta bloqueia a criação quando o template inicia ou termina com um placeholder. :::success Correto: Olá {{nome}}, seu ticket {{ticket}} foi atualizado. ::: :::error Incorreto: - {{nome}} seu ticket foi atualizado. - Seu ticket foi atualizado: {{atualizacao}} ::: 2. Variável não pode ficar "solta" (sem contexto) Evite templates que sejam apenas um placeholder (ex: {{teste}}) ou com texto genérico demais. Aumenta muito o risco de rejeição por baixa qualidade. 3. Padrão de nome de variável Deve estar entre {{ }}, sem acentos e sem espaços. Use underline para separar palavras: :::success Correto: {{mes_de_referencia}} ::: :::error Incorreto: {{mês de referência}} ::: Categorias (regras oficiais da Meta) Ao criar o template, você escolhe uma das três categorias: Authentication, Utility ou Marketing. :::warning A Meta analisa conteúdo + intenção da mensagem. Ela pode: - Reclassificar automaticamente (ex: Utility → Marketing) - Rejeitar o template se a categoria não for compatível ::: Documentação oficial: Meta Developers — Template Categorization. Authentication (Autenticação) Use para códigos de verificação (OTP) e fluxos de autenticação. Deve conter: - Código de verificação - Informação de expiração - Contexto de login ou segurança :::error Não pode conter: promoção, oferta, upsell. ::: Exemplo correto: Seu código de verificação é {{codigo}}. Ele expira em {{tempo}} minutos. Utility (Utilidade / Transacional) Segundo a Meta, Utility deve: - Estar relacionado a uma ação prévia do usuário - Ser operacional ou informativo - Não conter conteúdo promocional - Não ter linguagem persuasiva - Não tentar gerar nova conversão Principais motivos de reprovação como Utility :::error Linguagem vaga - "Temos novidades para você" - "Confira essa atualização especial" ::: :::error Linguagem promocional disfarçada - "Aproveite sua próxima compra" - "Não perca essa oportunidade" ::: :::error Falta de contexto transacional — se não estiver claro qual ação o usuário realizou, a Meta tende a classificar como Marketing. ::: Boas práticas para aprovar como Utility :::success Mencione claramente o contexto — pedido, protocolo, ticket, agendamento, assinatura, pagamento, entrega. Inclua identificador claro — número do pedido, número do ticket, protocolo, ID da transação. Use linguagem objetiva e neutra. Foque em informar, não persuadir. ::: Exemplos :::success Utility aprovado (e-commerce): Olá {{nome}}! Seu pedido {{pedido_id}} foi enviado e está a caminho. Previsão de entrega: {{data_entrega}}. Utility aprovado (suporte): Olá {{nome}}, seu ticket {{ticket}} foi atualizado: {{texto_atualizacao}}. Se precisar complementar informações, responda por aqui. ::: :::error Pode ser reclassificado para Marketing: Olá {{nome}}! Seu pedido está pronto. Aproveite e confira nossas novas ofertas! ::: Marketing Inclui: - Promoções - Ofertas - Cupons - Reengajamento - Lançamentos - Cross-sell / Upsell :::info Regra prática: se a mensagem tenta gerar nova receita ou conversão → é Marketing. ::: Anexos no template (Header de mídia) | Tipo | Formatos | Limite | |------------|-------------------------|---------------------| | Imagem | JPEG, PNG | até 2 MB | | Vídeo | MP4, 3GP (H.264/AAC) | até 2 MB | | Documento | PDF | até 2 MB | | GIF | tratado como MP4 | ~3,5 MB (acima vira vídeo) | Checklist rápido antes de submeter - Body específico e contextual - Linguagem neutra se for Utility - Identificador transacional incluído - Sem termos promocionais (para Utility) - Header texto: até 60 caracteres e 1 variável - Formato e tamanho da mídia conferidos - Criado por idioma / locale - Placeholders validados (não começar nem terminar com variável) Dúvidas recorrentes Por que a Meta mudou minha categoria? A categorização é baseada em conteúdo + intenção. Se houver qualquer indício de promoção, persuasão ou tentativa de conversão, a mensagem pode ser classificada como Marketing — mesmo que você selecione Utility. Meu template foi reprovado como Utility. O que revisar primeiro? 1. Remova qualquer tom comercial 2. Inclua contexto claro de ação do usuário 3. Adicione identificador transacional 4. Torne o texto mais objetivo e menos genérico Observações - Para criar, editar ou excluir templates dentro do Cloud Chat: Como criar, editar e excluir templates no Cloud Chat. - Documentação oficial da Meta sobre categorização: Meta Developers — Template Categorization.

Última atualização em May 07, 2026

Templates de WhatsApp: criar, editar, excluir e usar o construtor

Visão geral O construtor de templates de WhatsApp do Cloud Chat ganhou um novo formulário com preview ao vivo, validação na hora e painel para templates rejeitados pela Meta. Agora dá pra montar mensagens com o leque completo de botões suportados pela Meta — resposta rápida, URL, telefone e o novo Copy Code (cupom que o cliente copia com 1 clique). Templates em revisão (status PENDING) também passam a ser editáveis, e anexos do tipo documento agora preservam o nome do arquivo no destinatário. A ideia é resolver os problemas mais comuns de template sem precisar abrir o Meta Business Manager — útil principalmente para times que não têm acesso ao painel da Meta porque ele fica sob gestão de outra área da empresa. :::info Este artigo cobre o uso do construtor de templates dentro do Cloud Chat. Para entender as regras oficiais da Meta sobre estrutura, categorias e motivos de reprovação, vá para Regras de templates do WhatsApp (Meta): categorias, estrutura e reprovações. ::: O que são templates do WhatsApp Templates são mensagens pré-aprovadas pela Meta que permitem que sua empresa inicie conversas com clientes. São necessários para: - Enviar promoções e campanhas - Confirmar pedidos e agendamentos - Enviar códigos de verificação - Notificar sobre entregas Pré-requisitos - Ser administrador da conta no Cloud Chat - Ter uma caixa de entrada de WhatsApp já configurada Onde fica Configurações → Caixas de entrada → escolha uma inbox de WhatsApp → aba Templates. Daqui você consegue: - Criar um template novo - Editar templates PENDING (em revisão) e APPROVED (aprovados) - Visualizar o motivo de rejeição de templates REJECTED - Excluir templates - Sincronizar manualmente o status com a Meta Como criar um template Como usar o construtor de templates de WhatsApp no Cloud Chat 1. Clique em Adicionar template. 2. Preencha as informações básicas (nome, categoria, idioma). 3. Monte os componentes do template (cabeçalho, corpo, rodapé, botões) — todos opcionais, exceto o corpo. 4. Acompanhe o preview ao vivo ao lado do formulário (ou abaixo, no celular) para ver como o template vai aparecer no WhatsApp. 5. Clique em Salvar. O template é enviado para a Meta e fica em estado PENDING até a revisão. :::info O botão Salvar fica desabilitado até todos os campos estarem válidos. Se ele estiver cinza, role o formulário para encontrar o campo com erro destacado em vermelho. ::: Informações básicas | Campo | Regras | | --- | --- | | Nome | Letras minúsculas, números e underscore. Sem espaços ou acentos. | | Categoria | Marketing, Utility ou Authentication. | | Idioma | Idioma do conteúdo (ex.: Português (Brasil), English, Español). | A categoria afeta as regras: templates Authentication não aceitam cabeçalho, rodapé, botões de URL nem Copy Code — só botões de resposta rápida. :::info Padrão de nome recomendado: categoria_proposito (ex.: pedido_confirmacao, promocao_black_friday). Evite acentos, espaços e maiúsculas — nomes como Promoção Black Friday não passam na validação. ::: Cabeçalho (opcional) Tipo único por template. Quatro opções: | Tipo | O que aparece | Limite | | --- | --- | --- | | Texto | Linha de texto em negrito acima do corpo | 60 caracteres, no máximo 1 variável | | Imagem | Imagem grande no topo da mensagem | JPG ou PNG, até 5 MB | | Vídeo | Vídeo reproduzido inline | MP4, até 16 MB | | Documento | Anexo (PDF, planilha etc.) com nome visível | PDF, até 100 MB | Para mídia (imagem, vídeo, documento), você faz upload do arquivo de exemplo — a Meta usa esse arquivo para revisar o template. Na hora de enviar uma campanha, você pode substituir pelo arquivo final. :::success O nome do arquivo enviado é preservado no destinatário em anexos do tipo Documento. ::: Corpo (obrigatório) O texto principal da mensagem. Aceita variáveis no formato {{...}} para personalização por destinatário. Dois formatos de variável: | Formato | Sintaxe | Uso recomendado | | --- | --- | --- | | Posicional | {{1}}, {{2}}, {{3}} | Templates simples, integrações via API por posição | | Nomeado | {{nome_cliente}}, {{cupom}} | Templates com muitas variáveis, mais legíveis | O formato é detectado automaticamente pelo conteúdo do corpo. Misturar os dois no mesmo template não é permitido. Regras: - Limite de 1024 caracteres - Variáveis em snake_case (letras minúsculas, números, underscore) - Não pode começar ou terminar com variável - Para cada variável, é preciso preencher um valor de exemplo (usado pela Meta na revisão) Rodapé (opcional) Texto curto abaixo do corpo, sem variáveis. - Limite de 60 caracteres - Útil para assinaturas, avisos legais ou instruções para "Responder STOP para sair" Botões (opcional) Até 10 botões no total. Quatro tipos disponíveis: | Tipo | O que faz | | --- | --- | | Resposta rápida | Envia um texto pré-definido como resposta ao apertar | | URL estática | Abre uma URL fixa | | Telefone | Inicia uma ligação para o número configurado | | Copy Code | Copia um código (cupom, voucher) para o clipboard ao apertar | Limites por categoria: - Marketing / Utility: até 10 botões. Pode misturar tipos. - Authentication: apenas botões de resposta rápida. Botão Copy Code Mostra um botão que, quando apertado, copia um código para o clipboard do destinatário. Ideal para cupons, vouchers, códigos promocionais. - Disponível para categorias Marketing e Utility - Versão atual usa código estático (mesmo código para todos os destinatários) Preview ao vivo Ao lado do formulário (ou abaixo dele em telas menores), aparece uma simulação de como o template vai chegar no WhatsApp: - Cabeçalho, corpo, rodapé e botões na ordem real - Variáveis aparecem com os valores de exemplo preenchidos - Anexos de mídia mostram a pré-visualização Estados do template Os templates aparecem na lista com um badge colorido: | Status | Cor | Significado | | --- | --- | --- | | APPROVED | Verde | Aprovado pela Meta — pronto para uso | | PENDING | Amarelo | Em revisão pela Meta — pode ser usado e também editado | | REJECTED | Vermelho | Rejeitado pela Meta — abra o template para ver o motivo | | PAUSED | Cinza | Pausado pela Meta (geralmente por baixa qualidade de uso) | :::info A revisão da Meta normalmente leva alguns minutos, mas pode demorar até 24h em casos raros. O Cloud Chat sincroniza o status automaticamente. ::: Quando um template é rejeitado Templates REJECTED mostram um painel dedicado no topo do modal de edição com: - Motivo da rejeição em pt-BR (traduzido a partir dos códigos da Meta) - CTA "Editar e reenviar" que abre o formulário para correção - Se o código de rejeição ainda não estiver mapeado, mostra um fallback genérico com o código original :::info Para entender por que a Meta rejeitou e como ajustar o conteúdo, consulte Regras de templates do WhatsApp (Meta). ::: Fluxo: 1. Abra o template rejeitado pela lista. 2. Leia o motivo no painel vermelho. 3. Clique em Editar e reenviar. 4. Ajuste o conteúdo conforme o motivo apontado. 5. Salve — o template volta para PENDING e a Meta refaz a revisão. Editar templates em revisão (PENDING) Templates em PENDING ficam editáveis. Ao salvar, a revisão da Meta reinicia. :::warning O badge amarelo no campo de status traz um lembrete: editar um template PENDING reinicia a revisão. Use quando perceber um erro logo após criar o template. ::: Como excluir um template 1. Encontre o template na lista. 2. Clique em Excluir. 3. Digite o nome exato do template para confirmar. 4. Clique em Sim, Deletar. :::error A exclusão não pode ser desfeita — e a Meta retém o nome do template por 30 dias antes da exclusão definitiva. Nesse período, não dá pra criar outro template com o mesmo nome. ::: Perguntas frequentes Posso usar variáveis em qualquer parte do template? No corpo, sim — desde que não estejam no começo ou no fim. No cabeçalho de texto, até 1 variável. Rodapé não aceita variáveis. Posso misturar variáveis posicionais ({{1}}) e nomeadas ({{nome}}) no mesmo template? Não. O Cloud Chat detecta o formato pelo conteúdo do corpo e força consistência — o que estiver no corpo precisa também estar nos botões e cabeçalho. O que acontece se eu editar um template aprovado? Ele volta para PENDING e passa por nova revisão. Templates em uso por campanhas continuam funcionando enquanto a revisão acontece. A Meta limita edições em templates aprovados a 1 por dia e 10 por mês por template — se passar do limite, o salvamento falha até a janela renovar. O Copy Code permite código diferente por destinatário? Nesta versão, não — o código é estático e definido no template. Suporte a código único por envio está planejado para uma fase futura. Por que meu template foi rejeitado mesmo passando na validação do Cloud Chat? A validação do Cloud Chat cobre as regras estruturais da Meta (tamanhos, formatos, sintaxe). A Meta também aplica critérios de qualidade de conteúdo (linguagem promocional, formatação, contexto) que só podem ser avaliados na revisão final. O painel de rejeição mostra o motivo específico. Para detalhes sobre cada motivo de reprovação, veja Regras de templates do WhatsApp (Meta). Posso criar templates Authentication com botão Copy Code? Não. Templates Authentication aceitam apenas botões de resposta rápida. Para enviar códigos OTP, considere usar a categoria Utility. Erros comuns "Nome já existe" Já existe um template com esse nome — inclusive nomes em período de retenção de 30 dias após exclusão. Escolha um nome diferente. "Formato inválido do nome" O nome tem caracteres especiais, espaços ou maiúsculas. Use apenas letras minúsculas, números e underscore. "Limite de edições atingido" A Meta limita edições em templates APPROVED a 1 por dia e 10 por mês (por template). Aguarde a janela renovar. "Template não pode ser editado" Aparece quando a Meta ainda não liberou a janela de edição (geralmente em PAUSED). Sincronize manualmente para garantir o status atualizado e tente de novo. Boas práticas :::success Use o preview ao vivo como checklist visual. Antes de salvar, olhe o preview e pergunte: a mensagem está clara? Variáveis estão nos lugares certos? O botão tem o texto esperado? ::: :::info Preencha exemplos realistas nas variáveis. A Meta usa esses valores para revisar — exemplos genéricos como "teste" ou "abc" aumentam a chance de rejeição. ::: :::warning Templates Marketing têm critério mais rígido. Se possível, classifique como Utility quando a mensagem for transacional (confirmação de pedido, lembrete de consulta, atualização de status). ::: Documentação oficial da Meta Para regras detalhadas sobre estrutura de templates, categorias e motivos de rejeição, consulte a documentação da Meta: - Meta Developers — Message Templates

Última atualização em May 27, 2026

Como evitar bloqueios e banimentos no WhatsApp

Quando usar - Você está prestes a iniciar uma operação de mensagens em massa pelo WhatsApp e quer reduzir risco de banimento - Já teve um número banido pela Meta e quer entender o que mudar antes de subir um novo - Sua taxa de denúncia (spam) está alta e o tier de envio está regredindo - Você está fazendo "warm-up" de um número novo e precisa do checklist correto Sobre este artigo O WhatsApp adota critérios rígidos para identificar comportamentos suspeitos, com o objetivo de proteger usuários contra spam, golpes e conteúdos indesejados. Este guia compila aprendizados de campo da Cloud Humans com milhares de contas operadas, traduzidos em práticas concretas para reduzir risco de bloqueio. Resumo rápido - Evite enviar mensagens para muitos contatos diferentes logo no início - Peça opt-in antes de campanhas promocionais ("Quero receber novidades") - Use mensagens personalizadas e que incentivem resposta - "Aqueça" o número antes de começar (use normalmente por alguns dias) - Evite repetir padrões de número anterior banido (nome, foto, texto) - Nunca envie mensagens sem oferecer opt-out - Acima de 3% de denúncias por spam, o número pode ser banido - O algoritmo muda; a única estratégia infalível é se adaptar continuamente Principais motivos de banimento 1 — Alta rotatividade de destinatários O WhatsApp detecta como suspeito quando um número tenta enviar mensagens para muitos contatos diferentes em pouco tempo — especialmente se essas pessoas nunca interagiram com esse número antes. :::info Dica prática. Comece devagar. Envie mensagens em ritmo crescente, priorizando contatos que já tenham interagido com você. ::: 2 — Conteúdo suspeito ou mensagens padronizadas demais O conteúdo das mensagens é analisado por algoritmos de machine learning. Palavras como boleto, PIX, cartão — ligadas a transações financeiras — aumentam o risco, principalmente sem contexto ou interação real. :::info Dica prática. Evite mensagens genéricas para uma base grande. Prefira abordagens personalizadas e com incentivo à resposta. Frases que convidam o cliente a interagir reduzem as chances de bloqueio. ::: 3 — Números novos e sem histórico Contas recém-ativadas que já começam enviando em massa tendem a ser banidas mais rapidamente, mesmo se o envio for manual ou via WhatsApp Web. :::info Dica prática. Use o número normalmente por alguns dias antes de iniciar campanhas. Envie mensagens para contatos conhecidos, interaja pelo app e preencha o perfil com nome, foto e descrição. ::: 4 — Reutilização de padrões após bloqueio É comum reativar um novo número após o anterior ser banido e repetir exatamente a mesma estratégia (foto, nome, mensagens). Isso facilita a associação entre os perfis e leva ao banimento quase imediato. :::info Dica prática. Altere foto de perfil, nome e estilo de comunicação. Mude também o padrão de horários e destinatários iniciais. O objetivo é não parecer continuação direta do número anterior. ::: 5 — Reclamações e marcações como spam :::error Se mais de 3% dos destinatários de uma campanha marcarem sua mensagem como spam, o número pode ser suspenso ou banido. ::: :::info Dica prática. Sempre ofereça uma forma clara de descadastramento (ex: "Responda 2 para sair da lista") e monitore os retornos para excluir esses contatos automaticamente. ::: Estratégias adicionais que funcionam Faça a maturação do número Antes de qualquer automação, use o número de forma orgânica. Converse com contatos reais, participe de grupos, responda mensagens. Peça opt-in antes de promoções Só envie mensagens promocionais para quem explicitamente autorizou o envio — via formulário, checkbox ou pelo próprio WhatsApp ("Quero receber promoções"). Comece pelo WhatsApp Web Use o número primeiro no WhatsApp Web antes de conectar à plataforma. Isso ajuda a sinalizar que há um humano por trás da conta. Varie o conteúdo das mensagens Use atributos dinâmicos (nome do cliente, dados de compra, data) ou embaralhe sentenças para evitar repetições idênticas. Evite picos repentinos de envio Para escalar uma campanha, distribua o volume ao longo do dia ou da semana. Plataformas com filas automáticas ajudam a controlar esse ritmo. O que não funciona (ou funciona menos do que você imagina) :::warning Mitos comuns que parecem soluções, mas raramente resolvem: - Rotação constante de IPs — pode ajudar em casos pontuais, mas não resolve se o problema for conteúdo ou comportamento do número. - Números reciclados — o histórico anterior conta. Um número usado para spam no passado pode ser banido mesmo com poucas mensagens enviadas. - Mudar de número sem mudar a abordagem — repetir padrões anteriores gera rastreamento automático pelo algoritmo da Meta. ::: Conclusão Não existe fórmula mágica — o algoritmo do WhatsApp está em constante evolução. O que realmente importa é: - Qualidade da base de contatos - Contexto e personalização das mensagens - Interação real com os usuários Empresas que constroem relacionamento com o cliente, respeitam consentimento e mantêm uma frequência saudável têm taxas de bloqueio próximas de zero. Observações - Para entender o sistema de tiers e como o volume permitido evolui com a qualidade: Tiers de envio do WhatsApp: o que são e como evoluir. - Para o catálogo completo de erros que aparecem em mensagens não entregues: Por que minha mensagem não está sendo enviada? Guia Completo de Erros. - Documentação oficial da Meta sobre políticas comerciais: Meta Developers — WhatsApp Business Policy.

Última atualização em May 07, 2026

Qual é o limite de números de WhatsApp conectados e como aumentá-lo

Quando usar - Você atingiu o limite de números conectados na sua WABA e precisa adicionar mais - Sua operação tem múltiplas marcas, países ou departamentos e precisa de mais linhas - Você quer entender quais critérios da Meta influenciam esse limite O que é o limite de números na WhatsApp Business Platform Quando você usa a API oficial do WhatsApp (WABA), sua conta tem um limite de quantos números de telefone podem ser adicionados e conectados. Esse limite é controlado pela Meta com base em critérios técnicos e reputacionais. Limite inicial - Business Portfolio não verificado → limite padrão: 2 números por WABA - Business Portfolio verificado → limite pode ser elevado para até 20 números (mas não automaticamente) :::warning Mesmo após a verificação da empresa, a Meta pode manter o limite em 2, 5, 10 ou outro valor inferior a 20, dependendo de uma combinação de critérios. Para mais de 20 linhas, é necessário abrir um chamado direto com a Meta para aprovar a exceção. ::: Critérios que influenciam o limite Além da verificação da empresa, a Meta também considera: Técnicos e reputacionais - Histórico de uso da API (estabilidade, volume de mensagens) - Conformidade com as políticas comerciais - Qualidade das mensagens e da experiência do usuário - Ausência de bloqueios, denúncias ou comportamentos abusivos - Capacidade de suporte e operação de múltiplos números Subjetivos / comportamentais - Relevância do uso de múltiplos números para o modelo de negócio (franquias, departamentos) - Tipo de operação (multimarcas, países diferentes) - Nível de estrutura da empresa ou agência parceira :::info Conclusão: a verificação do Business Portfolio é necessária, mas não garante automaticamente os 20 números. O desbloqueio depende também de reputação e consistência da operação. ::: Como saber se sua conta está verificada 1. Acesse business.facebook.com/settings/info 2. Verifique o campo Status da verificação :::success Se estiver como "Verificada" ✅, você cumpriu o primeiro pré-requisito. ::: :::warning Se ainda não estiver verificada, clique em Iniciar verificação e siga o processo com documentos e domínio da empresa. ::: Como solicitar aumento do limite Caso 1 — Conta ainda não verificada 1. Conclua a verificação do Business Portfolio 2. A conta será analisada e o limite poderá ser ajustado automaticamente — ou mantido com restrição Caso 2 — Conta já verificada, mas: - Você está com limite ainda em 2 ou 5 números, ou - Você já atingiu os 20 números e precisa de mais Você precisará abrir um chamado direto com a Meta. Como abrir o chamado para solicitar aumento :::info O caminho mais rápido é via Account Manager da Meta — se você já tem um, abra o ticket direto com essa pessoa. ::: Se não tiver Account Manager (ou ele não responder), acesse: Meta Business Help. Modelo de mensagem: Assunto: Solicitação de aumento no limite de números conectados à WABA Olá, Gostaria de solicitar o aumento do número de linhas que podemos adicionar à nossa conta de WhatsApp Business (WABA). Nosso Business Portfolio está verificado e estamos utilizando o limite atual. A operação justifica o uso de mais números por conta do nosso modelo (multimarcas, países, departamentos distintos). ID do Business Portfolio: [insira aqui] ID da WABA: [insira aqui] Agradecemos o suporte e ficamos à disposição. Observações - Para entender a relação com tiers de envio (limite de mensagens, não de números): Tiers de envio do WhatsApp: o que são e como evoluir. - Verificação do Business Portfolio - Central de Ajuda da Meta para WhatsApp Business - Abrir chamado de suporte na Meta - Guia de adição de números à WABA - Meta Developers — Messaging Limits

Última atualização em May 07, 2026

Por que minha mensagem não está sendo enviada? Guia completo de erros (WhatsApp, Twilio e e-mail)

Quando usar - Sua mensagem aparece com erro no Cloud Chat e você quer entender o significado - Você quer um catálogo de referência dos códigos de erro mais comuns - Você precisa decidir se reenvia, ajusta o template ou aciona o suporte Sobre este artigo Algumas vezes a sua mensagem pode não ser enviada e aparecer um código de erro. Mapeamos os casos mais comuns usando o detalhamento da documentação oficial da Meta sobre o que fazer em cada caso. Como o erro aparece no Cloud Chat A mensagem fica com a borda em vermelho e exibe um link Ver detalhes que abre uma modal com o código: Clique em Ver detalhes para ver o detalhamento do erro: O Cloud Chat exibe o detalhamento de todos os códigos de erro da Meta — para o catálogo completo: Meta Developers — Error Codes. Erros mais comuns — WhatsApp 131049 — Policy Violation :::error Message not delivered to maintain healthy ecosystem engagement. ::: - O que significa — O WhatsApp bloqueou a entrega por violação de política - Causas comuns: - Conteúdo considerado spam ou de baixa qualidade - Alta taxa de bloqueios / denúncias de usuários - Falta de opt-in válido - Ação recomendada: - Revisar templates aprovados e a linguagem usada - Melhorar a coleta de opt-ins - Monitorar métricas de qualidade no Meta Business Manager - Ver: Como evitar bloqueios e banimentos no WhatsApp 131026 — Message Undeliverable (genérico) :::warning Message Undeliverable. ::: - O que significa — A mensagem não pôde ser entregue, sem detalhes específicos - Causas comuns: - Número inválido, desativado ou bloqueado - Usuário desinstalou o app - Erro temporário na infraestrutura da Meta - Ação recomendada: - Validar números antes do envio - Garantir opt-in atualizado - Reprocessar envios em caso de erro transitório 131048 — Spam Rate Limit Hit :::warning Spam rate limit hit. ::: - O que significa — A conta ultrapassou o limite de envio permitido - Causas comuns: - Volume de disparos acima do tier de qualidade - Conta com reputação baixa - Ação recomendada: - Segmentar envios - Acompanhar métricas de reputação - Solicitar revisão de limites se necessário - Ver: Tiers de envio do WhatsApp: o que são e como evoluir 130472 — User Not Eligible :::warning User's number is part of an experiment / not eligible. ::: - O que significa — O número do usuário não pode receber mensagens no momento - Causas comuns: - Número em sandbox / teste da Meta - Usuário não habilitado para receber mensagens comerciais - Ação recomendada: - Confirmar elegibilidade do número - Escalar ao provedor se recorrente 131042 — Business Eligibility Issue :::error Payment or account not allowed. ::: - O que significa — A conta não está apta a enviar mensagens - Causas comuns: - Empresa em categoria restrita - Falta de verificação no Business Portfolio - Pendência de pagamento - Ação recomendada: - Resolver billing - Verificar elegibilidade no Meta Business Manager - Confirmar verificação do Business Portfolio 131047 — Re-engagement Failed :::warning 24h window exceeded — Re-engagement message failed. ::: - O que significa — Mensagem enviada fora da janela de 24h sem uso de template - Causas comuns: - Resposta enviada depois do limite permitido - Ação recomendada: - Usar templates aprovados para reengajamento - Configurar alertas para respeitar a janela de 24h - Ver: Regras de templates do WhatsApp (Meta) Erros multicanal 63024 — Generic API Error (Twilio / Email / WhatsApp) :::warning Generic WhatsApp Cloud API error code. ::: - O que significa — Erro genérico da API, sem detalhamento da causa - Causas comuns: - Timeout ou falha na rede - Payload inválido - Erro transitório na API - Ação recomendada: - Implementar retry automático - Validar payloads - Escalar para suporte do provedor em caso de repetição #100 — Invalid Action (Facebook / Graph API) :::warning Invalid action (not owner of topic / invalid API call). ::: - O que significa — A chamada feita não é válida - Causas comuns: - Endpoint incorreto - Token sem permissão - Parâmetros inválidos - Ação recomendada: - Revisar payloads e permissões - Conferir documentação da Graph API Erros adicionais por canal E-mail | Código | Significado | |-----------------|--------------------------------------------------| | 451 4.7.1 | Rate Limit atingido no servidor de e-mail | | 535-5.7.8 | Falha de autenticação SMTP | | 003 | Timeout de rede no envio | | 2603 | Rede inacessível | Twilio | Código | Significado | |-----------------|--------------------------------------------------| | 21617 | Mensagem excede 1.600 caracteres | | 63007 | Canal "From" inválido | | 63018 | Rate Limit | | 63049 / 63032 / 63016 | Erros genéricos de provedor | Observações - Para o catálogo completo de erros WhatsApp da Meta: Meta Developers — Cloud API Error Codes. - Para entender o sistema de tiers e como ele influencia o erro 131048: Tiers de envio do WhatsApp. - Para reduzir o risco de erros relacionados a qualidade (131049, 131048): Como evitar bloqueios e banimentos no WhatsApp.

Última atualização em May 07, 2026

Como reconectar sua inbox de WhatsApp no Cloud Chat

Quando usar - A conexão da sua inbox de WhatsApp foi perdida e você parou de enviar ou receber mensagens - Você recebeu um e-mail informando que a inbox foi desconectada - Você precisa atualizar as credenciais do WhatsApp na inbox Pré-requisitos - Ser administrador da conta no Cloud Chat - Ter acesso à conta da Meta (Facebook) vinculada à WABA do número Passo a passo da reconexão Etapa 1 — Acessar a inbox no Cloud Chat 1. No menu lateral, vá em Configurações → Caixas de Entrada 2. Clique na inbox de WhatsApp que deseja reconectar 3. Vá até a aba Configurações avançadas Etapa 2 — Iniciar a reconexão 1. Na seção Reconectar WhatsApp, clique no botão Reconectar 2. Uma janela da Meta (Facebook) será aberta — faça login se necessário 3. Selecione a WABA e o número de telefone que deseja reconectar 4. Confirme a autorização e aguarde a janela fechar :::success Quando aparecer a mensagem "WhatsApp reconectado com sucesso", a integração foi restabelecida e a inbox volta a operar normalmente. ::: Observações - O processo leva apenas alguns segundos. - Após a reconexão, as etapas internas de integração rodam automaticamente em segundo plano. - Se ocorrer algum erro, tente novamente. Se o problema persistir, acione o suporte. - Se você suspeitar que a desconexão foi causada por remoção manual do dispositivo (em integração com coexistência), confirme no celular se o Cloud Chat ainda aparece em WhatsApp Business App → Dispositivos Conectados antes de reconectar.

Última atualização em May 07, 2026

Tiers de envio do WhatsApp: o que são e como evoluir

Quando usar - Você quer entender o limite de mensagens proativas que pode enviar pela WABA - Sua conta atingiu o limite e você quer saber como subir de tier - Você está planejando uma campanha e precisa dimensionar o tier necessário - Seu tier regrediu e você quer entender por quê Sobre este artigo Os tiers (níveis) de envio são os limites de mensagens iniciadas pela empresa que você pode disparar em uma janela de 24h. São controlados pela Meta e se aplicam apenas a templates (mensagens proativas). :::info Os tiers não limitam mensagens recebidas nem respostas dentro da janela de 24h. O limite se aplica apenas a conversas iniciadas pela empresa usando templates. ::: Tabela de tiers | Tier | Limite de conversas por 24h | Como chegar aqui | |-------------|------------------------------|-------------------------------------------------| | Tier 1 | 1.000 conversas | Ponto de partida de toda conta nova verificada | | Tier 2 | 10.000 conversas | Avanço automático com base em qualidade e volume | | Tier 3 | 100.000 conversas | Avanço automático com base em qualidade e volume | | Tier 4 | Ilimitado | Avanço automático com base em qualidade e volume | :::warning Contas não verificadas começam com um limite ainda menor (250 conversas por 24h) e só avançam após a verificação do Business Portfolio na Meta. ::: Como o tier avança automaticamente A Meta aumenta seu tier quando detecta os seguintes sinais: 1. Volume crescente — você está iniciando muitas conversas e se aproximando do limite atual 2. Alta qualidade — baixa taxa de bloqueios e denúncias de spam pelos usuários 3. Consistência — uso regular sem picos suspeitos de volume O processo é automático: você não precisa solicitar o avanço, ele acontece em até 24h quando os critérios são atingidos. Por que meu limite aumentou? A Meta avaliou que sua conta tem volume crescente + boa reputação de qualidade. Isso é positivo — significa que você pode escalar suas campanhas com mais folga. Por que meu limite não está avançando? As causas mais comuns: - Taxa de bloqueio elevada — usuários marcando suas mensagens como spam. Acima de 3% de denúncia, o avanço é bloqueado e o tier pode até regredir - Volume ainda baixo — você está longe do limite atual e a Meta não enxerga necessidade de ampliar - Qualidade ruim dos templates — templates com linguagem promocional excessiva ou sem contexto transacional claro tendem a gerar mais denúncias - Business Portfolio não verificado — sem verificação, o limite máximo é 250 conversas/24h e não avança Como acompanhar seu tier atual 1. Acesse o WhatsApp Manager 2. Selecione o número desejado 3. Clique em Insights ou Phone Number Settings 4. Você verá o tier atual e o limite de conversas por 24h O que fazer se eu precisar de mais de 1.000 conversas logo no início? :::warning Não é possível "pular" tiers por solicitação direta. A única forma é crescer organicamente com qualidade. ::: Algumas práticas que ajudam: - Comece com uma base de contatos que já interagiu com você — essas pessoas têm menor chance de marcar como spam - Use templates bem estruturados com contexto claro (pedido, ticket, protocolo) - Monitore as métricas de qualidade no WhatsApp Manager semanalmente - Evite disparar para listas frias sem opt-in explícito Tiers e limite de números conectados são a mesma coisa? Não — são duas coisas diferentes: - Tier de envio: quantas conversas por dia você pode iniciar com um número específico - Limite de números: quantos números de WhatsApp você pode conectar na sua WABA Para entender o limite de números: Qual é o limite de números de WhatsApp conectados e como aumentá-lo? Observações - O tier pode regredir se a qualidade cair — cuide da reputação do número com atenção contínua - Os tiers são por número de telefone, não por conta ou WABA — cada número tem seu próprio tier - Para evitar bloqueios e manter a qualidade do número: Como evitar bloqueios e banimentos no WhatsApp - Documentação oficial da Meta: Meta Developers — Message Sending Limits

Última atualização em May 07, 2026

FAQ — Integração com WhatsApp: perguntas frequentes

Quando usar - Você tem uma dúvida pontual sobre integração de WhatsApp e quer resposta rápida - Você está em pré-onboarding e quer ter na mão respostas frequentes do time - Quer mapear caminhos alternativos antes de abrir um chamado de suporte Sobre o número e a conta Preciso de um chip físico ou celular para integrar? Não necessariamente. Para a integração sem coexistência (API exclusiva), você não precisa de chip físico — pode usar um número virtual. Para a integração com coexistência, você precisa do celular com o WhatsApp Business App instalado no momento da configuração. O que é um número virtual? Onde compro? Um número virtual é um número de telefone que funciona sem chip físico, contratado online. O Cloud Chat recomenda a BR DID para quem precisa de um número virtual para usar na API. Posso usar meu número pessoal de WhatsApp? Não recomendamos. A WhatsApp Business API é voltada para números empresariais. Além disso, ao integrar sem coexistência, o número para de funcionar no app do celular — o que causaria problemas se for seu número pessoal. Posso ter dois números de WhatsApp diferentes conectados no Cloud Chat? Sim. Cada número fica em uma caixa de entrada separada. Por padrão, uma conta verificada pode ter até 20 números conectados. Detalhes: Qual é o limite de números de WhatsApp conectados? Posso conectar o mesmo número em duas ferramentas ao mesmo tempo (ex: Cloud Chat e outra plataforma)? :::warning Não. Um número só pode estar conectado a um provedor de API por vez. Para migrar para o Cloud Chat, é necessário desconectar do provedor anterior primeiro. ::: Sobre a migração Vou perder o histórico de mensagens ao migrar? O histórico de mensagens do provedor anterior não é migrado automaticamente — fica acessível apenas na plataforma antiga. Se precisar importar tickets antigos, isso é possível via API do Cloud Chat: Import de histórico de tickets. Em integração com coexistência, o histórico dos últimos 6 meses do WhatsApp Business App é sincronizado — mas apenas parcialmente, sem garantia de completude (limitação da Meta). Meu provedor atual não quer liberar o número. O que faço? Acione o time de suporte da Cloud Humans — existem caminhos alternativos que dependem de análise do caso. Antes, confirme: a WABA está no seu Business Portfolio Meta ou no portfólio do provedor? Se estiver no seu, você tem controle administrativo e pode migrar independentemente. Preciso desativar o Two-Step Verification antes de migrar. Como faço se não sei a senha? - Se você é o dono da WABA → acesse o WhatsApp Manager e desative diretamente - Se o provedor anterior controla o Two-Step Verification → solicite a eles que desativem :::error Sem desativar o Two-Step Verification, a migração não é tecnicamente possível. ::: Sobre coexistência O que é coexistência? Coexistência é a funcionalidade da Meta que permite usar o mesmo número simultaneamente no celular (WhatsApp Business App) e na API oficial (Cloud Chat). Detalhes: O que é a coexistência no WhatsApp. Se eu usar coexistência, o que acontece se o celular ficar sem bateria ou internet? O Cloud Chat continua funcionando normalmente via API. A coexistência não depende do celular estar ativo. :::warning Se alguém remover manualmente o Cloud Chat da lista de dispositivos conectados no app do celular, a integração será interrompida e precisará ser refeita. ::: Minhas mensagens do WhatsApp Desktop (Windows) não aparecem no Cloud Chat. Por quê? O WhatsApp Desktop para Windows e o WhatsApp WearOS não são suportados pela Meta para espelhamento via API em modo coexistência. As mensagens ficam visíveis no celular, mas não geram webhook e por isso não chegam ao Cloud Chat. O WhatsApp Web (navegador) funciona normalmente. Detalhes: Mensagens de WhatsApp não chegam ao Cloud Chat? Entenda a limitação da coexistência. Posso usar grupos do WhatsApp no Cloud Chat? Não. A API oficial da Meta não suporta grupos. Os grupos continuam visíveis apenas no celular (em modo coexistência), mas não aparecem no Cloud Chat. Sobre templates e envios O que são templates e quando preciso deles? Templates são mensagens pré-aprovadas pela Meta, usadas para iniciar conversas com clientes ou para enviar mensagens após a janela de 24h de inatividade. Para respostas dentro de 24h após o último contato do cliente, você não precisa de template. Por que meu template foi reprovado como Utility? A Meta reclassifica templates de Utility para Marketing quando detecta linguagem promocional, falta de contexto transacional ou texto muito genérico. Para reverter: - Inclua identificador claro (número de pedido, ticket, protocolo) - Use linguagem objetiva - Remova qualquer tom comercial Detalhes: Regras de templates do WhatsApp (Meta): categorias, estrutura e reprovações. Por que não consigo enviar mensagens para muitos contatos de uma vez? Provavelmente você atingiu o limite do seu tier de envio. Cada conta começa no Tier 1 (1.000 conversas/24h) e avança automaticamente conforme volume e qualidade crescem. Detalhes: Tiers de envio do WhatsApp: o que são e como evoluir. Troubleshooting rápido O Cloud Chat parou de receber mensagens do WhatsApp. O que verificar? 1. Verifique se a caixa de entrada está ativa em Configurações → Caixas de Entrada 2. Se usar coexistência, verifique no celular se o Cloud Chat ainda aparece em Dispositivos Conectados 3. Se o dispositivo foi removido, reconecte: Como reconectar sua inbox WhatsApp no Cloud Chat 4. Se o problema persistir, acione o suporte Minha mensagem aparece com erro. O que significa? Consulte o guia completo com causas e ações para cada código: Por que minha mensagem não está sendo enviada? Guia Completo de Erros. Observações - Para escolher o modelo de integração: Guia Mestre — Como conectar seu número de WhatsApp ao Cloud Chat. - Documentação oficial da Meta sobre WhatsApp Business Platform: Meta Developers — WhatsApp Business Platform.

Última atualização em May 07, 2026