WhatsApp e Meta — guia prático (passo a passo detalhado)

Actualizado el 30 de septiembre de 2026

Este guia responde as dúvidas mais comuns de configuração do WhatsApp Business na Meta, com os endereços exatos e o caminho completo, e reúne a solução dos problemas que mais aparecem ao conectar, receber e enviar (códigos de erro da Meta incluídos). Use-o junto com a página "WhatsApp no FlakeDesk".

Como criar um modelo (template) de mensagem na Meta

Modelos são obrigatórios para iniciar conversa ou responder fora da janela de 24 horas. Eles são criados no painel da Meta e aprovados por ela antes de poderem ser enviados.

Acesse o WhatsApp Manager: https://business.facebook.com/wa/manage/message-templates — faça login com a conta que administra o negócio. (Caminho alternativo: https://business.facebook.com → menu ☰ → WhatsApp Manager → Ferramentas da conta → Modelos de mensagem.)
Se você administra mais de um negócio/conta do WhatsApp, confira no topo da página se o portfólio empresarial e a conta do WhatsApp Business (WABA) selecionados são os corretos.
Clique em Criar modelo.
Escolha a categoria — a Meta revisa se a categoria bate com o conteúdo:
- Marketing: promoções, ofertas, novidades, reengajamento.
- Utilidade: confirmações, atualizações de pedido/conta, lembretes de agendamento — precisa se referir a uma transação/relacionamento existente.
- Autenticação: envio de códigos de verificação (formato fixo da Meta).
Defina o nome do modelo: só letras minúsculas, números e underscore (_), sem espaços nem acentos — ex.: confirmacao_agendamento. Anote esse nome exatamente — ele será usado no FlakeDesk.
Escolha o idioma (ex.: Português (BR) → código pt_BR). O idioma também precisa bater com o cadastro no FlakeDesk.
Monte o conteúdo:
- Cabeçalho (opcional): texto (pode ter 1 variável {{1}}) ou mídia (imagem, vídeo ou documento — nesse caso o arquivo é anexado a cada envio, não fica fixo no modelo).
- Corpo (obrigatório, até 1.024 caracteres): o texto da mensagem, com variáveis numeradas {{1}}, {{2}}... — ex.: Olá {{1}}, seu horário está confirmado para {{2}}.
- Rodapé (opcional, até 60 caracteres): assinatura curta, sem variáveis.
- Botões (opcional): respostas rápidas, botão de URL (o final do link pode ser variável) e/ou botão de telefone.
Preencha os exemplos das variáveis quando solicitado — a Meta usa os exemplos para avaliar o modelo; sem eles a análise é rejeitada.
Clique em Enviar para análise. A aprovação costuma sair em minutos até 24 horas (pode chegar a 48h). O status aparece na própria lista de modelos: Em análise → Aprovado ou Rejeitado.
Se for rejeitado, abra o modelo para ver o motivo. Causas comuns: conteúdo promocional em modelo de categoria Utilidade (troque para Marketing), variáveis no início/fim do corpo ou coladas uma na outra, texto com erros que parecem spam, e falta de exemplos. Corrija e reenvie.

Depois de aprovado: cadastrar o modelo no FlakeDesk

No FlakeDesk, abra Comunicação → Templates de Mensagem → novo template com canal WhatsApp.
Informe exatamente o mesmo nome (ex.: confirmacao_agendamento) e mesmo idioma (pt_BR) do modelo aprovado — é assim que o FlakeDesk diz à Meta qual modelo enviar.
Reproduza o corpo com as mesmas variáveis {{1}}, {{2}}... O FlakeDesk preenche cada variável na hora do envio (dados do contato/organização ou valor digitado).
Se o modelo tem cabeçalho de mídia, marque o tipo (imagem/vídeo/documento) — o arquivo será pedido a cada envio. Cabeçalho de texto com variável e botões de URL dinâmica também são suportados.
Para enviar: numa conversa fora da janela de 24h, a inbox oferece o envio por template; escolha o modelo e confira o preenchimento das variáveis.

Como redefinir o PIN de verificação em duas etapas do número

Necessário quando o FlakeDesk pede um "PIN de 6 dígitos" para concluir o registro do número e você não o conhece.

Acesse https://business.facebook.com/wa/manage/phone-numbers e selecione a WABA correta.
Na linha do seu número, abra Configurações (ícone de engrenagem).
Entre em Verificação em duas etapas → Alterar PIN e defina um novo PIN de 6 dígitos. Anote-o em local seguro.
Volte ao FlakeDesk (Administração → Configurações → WhatsApp), digite o PIN novo no campo indicado e clique em Registrar número.

Como adicionar forma de pagamento (e por que precisa)

Sem forma de pagamento cadastrada na Meta, o envio de templates falha assim que o número sai da faixa gratuita — as respostas dentro da janela de 24h não são cobradas pela Meta, mas mensagens de modelo (Marketing/Utilidade/Autenticação fora da janela) são tarifadas por mensagem entregue.

Acesse o WhatsApp Manager → Configurações da conta → Forma de pagamento (ou https://business.facebook.com/billing_hub/accounts, selecionando a conta do WhatsApp).
Adicione um cartão de crédito e defina o limite/fuso/moeda quando solicitado.
Os valores por mensagem variam por categoria e país — tabela oficial: https://developers.facebook.com/docs/whatsapp/pricing

Janela de 24 horas — a regra de ouro do WhatsApp

Cada mensagem recebida do cliente abre/renova uma janela de 24 horas.
Dentro da janela: respostas em texto livre e mídia, sem custo da Meta.
Fora da janela: somente templates aprovados (tarifados). O FlakeDesk indica na conversa quando a janela fechou e oferece o envio por template.
Mensagens vindas do widget do site não abrem a janela (a Meta exige uma mensagem real de WhatsApp do cliente) — a primeira resposta nesses casos é por template.

Antes de conectar: o que a Meta exige do número

O número não pode estar ativo no aplicativo WhatsApp (pessoal ou Business) do celular. A API oficial e o app do celular não funcionam ao mesmo tempo com o mesmo número. Se o número já é usado no app, você tem duas opções: usar outro número (um fixo ou um chip novo — o número recebe um código por SMS ou ligação, não precisa de celular dedicado) ou excluir a conta do app antes de conectar (app → Configurações → Conta → Excluir conta; o histórico do celular é perdido — faça backup/exportação antes). Se você conectar sem excluir, a Meta recusa o registro ou o número fica sem receber.
Você precisa ser administrador do Portfólio empresarial (Business Manager) que vai ser dono da conta do WhatsApp Business. Funcionário/analista não consegue concluir o cadastro.
Cartão de crédito na Meta só é necessário para enviar templates (respostas dentro das 24 h são gratuitas). Pode ser adicionado depois, mas até lá os templates falham com "Cobrança da conta não configurada".
Nome de exibição do número: a Meta analisa e pode rejeitar nomes genéricos ("Vendas"), com caixa alta, símbolos, ou que não batam com a empresa. Use o nome comercial real.
Verificação da empresa (documentos) não é obrigatória para começar, mas sem ela o número fica com o limite inicial de conversas e o nome de exibição pode ficar "pendente".

Problemas ao conectar (Conexão rápida com a Meta)

A janela da Meta não abre. O navegador bloqueou o popup. Clique no ícone de popup bloqueado na barra de endereço, permita para o FlakeDesk e tente de novo. Bloqueadores de anúncio e extensões de privacidade também interferem — desative-os para o site do FlakeDesk. Se a mensagem "Verifique bloqueadores de anúncio" aparecer, é isso.

"Você fechou a janela antes de concluir." O cadastro da Meta foi interrompido. Repita e siga até a tela final ("Concluir"). Se a Meta chegou a criar a conta do WhatsApp Business, na próxima tentativa ela aparece para ser reaproveitada — selecione-a em vez de criar outra.

"Sessão expirada. Entre novamente." Sua sessão no FlakeDesk venceu enquanto o popup estava aberto (o cadastro na Meta pode demorar). Entre novamente e refaça. A conexão exige que você (administrador da organização) esteja logado no FlakeDesk — o FlakeDesk identifica a organização pela sua sessão.

"Não foi possível concluir a conexão com a Meta. WHATSAPP_NO_WABA_GRANTED" (ou "NO_PHONE_GRANTED"). A Meta terminou o cadastro sem conceder ao FlakeDesk uma conta do WhatsApp Business com número. Acontece quando você pula a etapa do número ou escolhe uma conta existente sem marcar o número no diálogo. Repita e, na etapa "Selecionar conta/número", marque a conta e o número que quer conectar.

"Este número já está conectado a outra organização." Cada número oficial só pode receber em uma organização do FlakeDesk. Se a sua empresa tem mais de uma organização, desconecte o número na outra antes (Administração → Configurações → WhatsApp → Desconectar). Se você não reconhece a outra organização, fale com o suporte.

Conectei, mas era outro número. Se a sua conta do WhatsApp Business tem vários números, a Conexão rápida conecta o primeiro número da primeira conta concedida. Para escolher outro, desconecte e refaça o cadastro marcando apenas o número desejado no diálogo da Meta — ou use o modo avançado informando o Phone Number ID exato.

"Quase lá: informe o PIN de duas etapas." O número já tinha verificação em duas etapas ativa na Meta. Digite o PIN de 6 dígitos que a sua empresa definiu. Se ninguém lembra, redefina (seção "Como redefinir o PIN" acima) e volte à tela para Registrar número. Erro "Falha ao registrar o número: … (133005)" significa PIN incorreto — redefina e tente de novo.

"Falha ao registrar o número" com outra mensagem. Causas frequentes: o número ainda está ativo no app do celular (exclua a conta no app e tente em alguns minutos); o número acabou de ser adicionado e a Meta ainda não concluiu a verificação por SMS/ligação (conclua no WhatsApp Manager → Números de telefone); conta do WhatsApp Business restrita por violação de política (veja o aviso no WhatsApp Manager).

"Recurso indisponível" ou "Login do Facebook indisponível para este app" dentro do popup. Mensagem do lado da Meta sobre o aplicativo da plataforma, não sobre a sua conta. Avise o suporte do FlakeDesk informando o horário — não há nada a corrigir na sua conta.

Modo avançado: "A Meta não validou as credenciais. Revise IDs, token, permissões e versão da API." Confira: o token é de usuário do sistema com papel de administrador e as permissões whatsapp_business_management e whatsapp_business_messaging; o Phone Number ID pertence à conta do WhatsApp Business (WABA) informada ("O número não pertence a esta conta do WhatsApp Business" indica troca de IDs); o token não expirou (tokens temporários do painel duram 24 h — gere um permanente).

Modo avançado: a Meta não aceita a URL de callback. A URL e o token de verificação exibidos na tela precisam ser colados exatamente; o token de verificação só é mostrado no momento em que você salva/rotaciona — se perdeu, rotacione e cadastre o novo. Assine o campo messages do webhook.

Mensagens não chegam no FlakeDesk

Confira nesta ordem:

A conta segue conectada? Administração → Configurações → WhatsApp deve mostrar o número e "Conectado". Se aparecer erro de registro, conclua o Registrar número (PIN).
Você testou pela página da Meta ("Enviar mensagem de teste") ou do próprio número? Mensagens enviadas pelo próprio número chegam como eco sem conteúdo e o FlakeDesk as ignora de propósito (não criam lead nem conversa). Teste sempre a partir de outro celular, escrevendo para o número conectado.
A mensagem era enquete, mensagem editada, visualização única ou figurinha animada? A API da Meta não entrega esse conteúdo. A conversa mostra "Conteúdo não suportado pela API do WhatsApp Business — veja no aplicativo do celular". Não há correção possível do nosso lado.
O remetente está bloqueado ou é um grupo? A API não entrega mensagens de grupos nem de contatos bloqueados na Meta.
O número está ativo no app do celular ao mesmo tempo? Se alguém reinstalou o WhatsApp no celular com esse número, o registro na API cai e as mensagens vão para o celular. Exclua a conta no app e clique em Registrar número no FlakeDesk.
Você mexeu na conta pela Meta? Excluir e recriar o número, trocar de Portfólio empresarial, remover o FlakeDesk em "Integrações comerciais" ou trocar a verificação em duas etapas invalida a conexão. Reconecte pela Conexão rápida (renova tudo).
Sua organização está no limite de contatos do plano? Novos leads acima do limite nascem bloqueados: a conversa é gravada, mas não gera aviso (sino/som) e o bot não responde. Libere contatos ou faça upgrade em Plano e cobrança.
É um membro com visibilidade restrita? Membros que só veem os próprios contatos não veem conversas de leads não atribuídos a eles. Peça a um administrador para conferir e atribuir.
A mídia veio sem arquivo ("Mídia recebida. O arquivo ainda não está disponível")? Arquivos acima de 25 MB ou que a Meta já expirou não são baixados; o texto e o remetente ficam registrados. Peça ao cliente para reenviar em tamanho menor.

Erros ao enviar (mensagem, mídia e template)

"A janela de atendimento de 24 horas está encerrada." Regra da Meta: texto livre e mídia só até 24 h após a última mensagem do cliente. Use Enviar template. Lembre que mensagens vindas do widget do site não abrem a janela.

"A conexão com a Meta/WhatsApp parece expirada ou sem permissão." O token perdeu acesso ao número (permissão removida, usuário do sistema excluído, Portfólio alterado, ou app removido em Integrações comerciais). Um administrador deve reconectar pela Conexão rápida (ou, no modo avançado, gerar um token novo e salvar).

Outras mensagens que a inbox pode mostrar no envio (cada uma corresponde a um código da Meta da tabela abaixo): "A Meta recusou o envio por excesso de mensagens em pouco tempo" (130429 — aguarde segundos); "A Meta limitou os envios deste número por qualidade…" (131048/131056 — reduza volume, revise conteúdo); "A conta do WhatsApp Business está restrita ou bloqueada pela Meta" (131031/368 — WhatsApp Manager → solicitar revisão); "O número não está registrado na API" (131045 — Configurações → WhatsApp → Registrar número); "O número de destino não tem WhatsApp, é inválido ou bloqueou o seu número" (131026); "A Meta pausou ou desativou este template por baixa qualidade" (132015/132016).

"Não foi possível enviar a mensagem pelo WhatsApp." genérico — abra a mensagem: o motivo da Meta aparece abaixo dela. Se não houver motivo, confira conexão/registro do número e tente novamente em instantes.

Mensagem enviada e depois "Falha na entrega" — o motivo da Meta vem embaixo da mensagem:

Código da Meta	O que significa	O que fazer
131042 Cobrança da conta não configurada	Conta sem país/moeda ou sem forma de pagamento; só afeta templates	WhatsApp Manager → Central de cobrança: definir país/moeda e adicionar cartão
131026 Mensagem não entregue	Destinatário sem WhatsApp, número inválido/inexistente ou que bloqueou o seu número	Confira DDD/dígitos; se o cliente bloqueou, não há como entregar
131047 Fora da janela de 24 h	Enviou texto livre depois do prazo	Use template aprovado
131049 Meta limitou a entrega de marketing	O cliente recebeu muitas mensagens de marketing (de qualquer empresa) recentemente — a Meta segura para proteger a experiência	Tente mais tarde; prefira templates de Utilidade para avisos operacionais
131048 ou 131056 Limite por qualidade/spam	Seu número foi marcado como spam ou está enviando demais para o mesmo destinatário	Reduza volume, revise a lista (só quem pediu), melhore o conteúdo; acompanhe a qualidade em Números de telefone
130429 Muitas requisições	Pico de envios acima do que a Meta aceita por segundo	Aguarde alguns segundos e reenvie; espace disparos em massa
131031 Conta bloqueada / 368 Bloqueio temporário	Violação de política ou denúncias	Leia o aviso no WhatsApp Manager → Visão geral e siga o processo de revisão da Meta
131045 Número não registrado	O registro (PIN) caiu ou nunca foi concluído	Administração → Configurações → WhatsApp → Registrar número
131053 / 131052 Falha ao transferir mídia	Instabilidade ou arquivo inválido	Reenvie em alguns instantes; converta o arquivo para um formato aceito
131009 / 100 Arquivo recusado	Formato ou tamanho não aceito pela Meta	Veja "Limites de mídia" abaixo
132001 Template não encontrado	Nome ou idioma diferente do aprovado	Nome idêntico ao da Meta (minúsculas/underscore) e idioma igual (ex.: `pt_BR`)
132000 / 132012 / 131008 / 100 Parâmetros do template	Quantidade ou formato das variáveis diferente do aprovado	Corrija o corpo cadastrado no CRM; ver "Templates" abaixo
132015 / 132016 Template pausado ou desativado	A Meta pausou o template por baixa qualidade (muitos bloqueios/denúncias)	Edite e reenvie o template ou crie outro; acompanhe "Qualidade" na lista de modelos

Quando o código não estiver na tabela, o FlakeDesk mostra o texto original da Meta. A lista oficial completa: https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes

Templates — checklist quando o envio falha

Status na Meta é Aprovado (não "Em análise", "Rejeitado", "Pausado" nem "Desativado")?
Nome cadastrado no FlakeDesk é idêntico ao da Meta e o idioma escolhido no envio é o mesmo da versão aprovada?
A quantidade de variáveis no corpo cadastrado bate com a aprovada? O FlakeDesk consulta a definição aprovada na Meta e monta as variáveis no formato aprovado (numeradas ou nomeadas) — se a consulta falhar, ele usa a cópia local, que precisa estar igual.
Template com cabeçalho de mídia exige anexar o arquivo em todo envio, do mesmo tipo aprovado (imagem, vídeo ou documento) — "Este template exige um arquivo de cabeçalho" e "tipo do arquivo não corresponde" apontam isso.
Template editado na Meta volta para análise; até aprovar de novo, a versão antiga pode ser recusada.
Categoria trocada pela Meta (de Utilidade para Marketing) muda a cobrança e pode acionar o limite de marketing (131049).
Sem forma de pagamento, o template é aceito mas não entregue (131042).

"O recebimento está ativo, mas o envio precisa do access token e do app secret." A conta foi configurada só para receber (modo avançado incompleto). Um administrador deve completar as credenciais ou reconectar pela Conexão rápida.

Limites de mídia (envio pela inbox)

Imagens: JPEG, PNG e WebP até 5 MB.
Áudio: AAC, MP4, MP3 e OGG até 16 MB.
Vídeo: MP4 até 16 MB.
Documento: PDF até 16 MB.
Não aceitos no envio pela inbox: GIF, DOC/DOCX, XLS/XLSX, PPT, ZIP, figurinhas. Converta para PDF/MP4/JPEG ou envie um link.
Legenda vale para imagem, vídeo e documento (áudio não tem legenda).
Recebimento: até 25 MB por arquivo; acima disso a mensagem chega sem o arquivo.

Qualidade, limites e restrições da conta

Qualidade do número (verde/amarela/vermelha): WhatsApp Manager → Números de telefone. Cai com bloqueios e denúncias dos destinatários. Vermelha por vários dias reduz o limite de conversas iniciadas e pode levar a "Sinalizado" (Flagged).
Limite de conversas iniciadas/dia: 250 (sem verificação da empresa) → 1.000 → 10.000 → 100.000 → ilimitado. Sobe automaticamente quando você usa ~50% do limite em 7 dias com boa qualidade. Conversas iniciadas pelo cliente não contam.
Verificação da empresa: https://business.facebook.com/settings/security → Verificação da empresa. Necessária para nome de exibição definitivo e para elevar limites. Documentos: CNPJ, comprovante de endereço/telefone, site com o nome da empresa.
Conta restrita / desativada: aparece no topo do WhatsApp Manager com o motivo e a opção "Solicitar revisão". Enquanto restrita, o envio falha (131031). Respostas dentro das 24 h também podem ser bloqueadas.
Boas práticas que evitam tudo isso: enviar só para quem consentiu, oferecer "responda SAIR", personalizar as variáveis, evitar disparos repetidos para o mesmo destinatário, usar Utilidade para avisos operacionais e Marketing só para promoções.

Cobrança da Meta

Respostas dentro das 24 h são gratuitas (conversas de serviço). Templates de Marketing, Utilidade fora da janela e Autenticação são cobrados por mensagem entregue, direto no cartão cadastrado na sua conta do WhatsApp Business — a Meta cobra você, não o FlakeDesk.
Sem cartão: templates falham com 131042. Com cartão mas limite de gastos atingido: mesma falha até você elevar o limite na Central de cobrança.
Valores por categoria e país: https://developers.facebook.com/docs/whatsapp/pricing

Widget do site

O botão não aparece no site. Confira se o script foi colado antes do </body> e se a página está publicada (não em editor visual). Se o console do navegador mostrar erro 404 no script, a chave do widget foi rotacionada (cole o snippet novo) ou a organização voltou ao plano Free ("widget indisponível no plano atual").
O botão ficou fora de lugar. O widget tem IDs de CSS estáveis; para mover/estilizar, use regras CSS do seu site com !important (os estilos do widget são inline).
Visitante enviou pelo site e não consigo responder em texto livre. Mensagem do site não abre a janela de 24 h — a primeira resposta é por template (o cliente responde no WhatsApp e a janela abre).
"Telefone inválido" no widget: o visitante precisa informar um número com DDD (8 a 15 dígitos).

Chatbot no WhatsApp: quando ele não responde

Chatbot ativo e canal WhatsApp ligado (Administração → Configurações → Chatbot)? 2) Horário de atendimento em modo "somente fora do horário" e estamos no expediente? 3) Alguém da equipe já respondeu esta conversa (isso silencia o bot; use Devolver ao bot)? 4) Limite de 20 respostas por conversa por hora atingido (proteção contra loops)? 5) Cota mensal do plano esgotada (aba Consumo)? 6) Lead bloqueado pelo limite de contatos do plano? 7) A mensagem veio pelo widget do site com o canal "Chat do site" desligado? 8) O bot aguarda cerca de 8 segundos após a última mensagem do cliente para responder (junta mensagens seguidas) — não é falha.

Boas práticas de teste

Teste a partir de um celular diferente do número conectado; nunca pelo botão "Enviar mensagem de teste" do painel da Meta (ele gera eco ignorado pelo FlakeDesk).
Primeiro teste: cliente escreve → resposta em texto livre. Segundo: envio de template (exige cartão na Meta). Terceiro: mídia (imagem ≤ 5 MB).
Na conversa, passe o mouse nos ícones de status: relógio (aguardando envio ou "Aceita pela Meta", quando a Meta recebeu e ainda não confirmou a entrega), um check (enviado), dois checks (entregue), azul (lido), vermelho (falhou — o motivo aparece embaixo).

Endereços úteis (favoritar)

O quê	URL
WhatsApp Manager (visão geral)	https://business.facebook.com/wa/manage/home
Modelos de mensagem	https://business.facebook.com/wa/manage/message-templates
Números de telefone (PIN, qualidade, limites)	https://business.facebook.com/wa/manage/phone-numbers
Faturamento / forma de pagamento	https://business.facebook.com/billing_hub/accounts
Configurações do negócio / verificação da empresa	https://business.facebook.com/settings
Tabela de preços por mensagem	https://developers.facebook.com/docs/whatsapp/pricing
Códigos de erro da Cloud API (lista oficial)	https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes
Integrações comerciais autorizadas na sua conta (remover/revisar)	https://www.facebook.com/settings?tab=business_tools
Política de mensagens do WhatsApp Business	https://business.whatsapp.com/policy

Veja também

WhatsApp no FlakeDesk: Inbox, janela de 24 horas e avisos de mensagem nova.
Chatbot de atendimento: Atendente virtual com IA no WhatsApp e no site.
Instagram Direct e Messenger: Conexão, regras e problemas dos dois canais.
Dúvidas frequentes: Respostas rápidas às perguntas mais comuns.