Conteúdo técnico sobre a API oficial do WhatsApp

O passo a passo completo da conexão: criar o número no painel, escolher o portfólio empresarial, chip novo ou aplicativo existente, escanear o QR code e cadastrar a forma de pagamento na BM.

Gerenciar modelos, categoria, cabeçalho com imagem, corpo com variáveis e exemplo obrigatório, botões e envio para análise. E o que a categoria faz no seu custo.

Por link ou por identificador, no mesmo endpoint de mensagens. Legenda na imagem, nome no documento, e o que faz o áudio virar bolha de voz em vez de anexo.

Listar os templates aprovados, montar o corpo com nome, idioma e componentes, e o erro que todo mundo pega no template com imagem no cabeçalho.

A mídia chega criptografada da Meta e a URL do webhook dá erro de autenticação. Uma chamada em GET /media/{id} devolve a URL pronta, válida por 30 dias.

Uma tela parecida com o WhatsApp Web usando a API oficial: interface, duas tabelas, webhook por túnel, mídia, envio, tempo real e a troca da URL na publicação.

A Datafy é um proxy da API oficial da Meta: muda o domínio e o token, o resto do payload é igual. O GET /me, o token no cabeçalho e o playground da documentação.

Campanha, planilha CSV com a coluna telefone, template aprovado, mapeamento de variáveis e agendamento. E a mensagem de erro real da Meta quando ela não entrega.

A partir de 1º de outubro de 2026 cada número tem 1.000 mensagens de serviço grátis por mês e a Meta cobra da 1.001ª. A utilidade na janela deixa de ser isenta.

As causas de bloqueio observadas na base de clientes da Datafy: prospecção sem template, template sem resposta, número novo, categoria falsificada e nicho proibido.

O user_id identifica a relação entre a pessoa e a sua empresa, não a pessoa. Para responder por ele, o campo to dá lugar a recipient, com o valor de messages.

Conectar o número em coexistência, cadastrar o webhook com os dois eventos, responder pela API dentro da janela de 24 horas e ver a falha chegar no webhook.

A Meta cobra por mensagem entregue, pela categoria e pelo país: R$ 0,32 marketing e R$ 0,035 utilidade. A janela de 24 horas, a franquia e o plano por número.

Na coexistência a sincronização não é automática: são duas chamadas, uma vez cada, em até 24 horas depois de conectar. Como contatos e conversas chegam no webhook.

O bate-papo do painel da Datafy abre um log ao vivo e mostra o webhook exato de cada mensagem. O que ele entrega, o que ele não mostra e onde ele acaba.

Caixa de entrada do tipo API no Chatwoot, a URL de webhook gerada pela aba Chatwoot da Datafy, e os quatro valores que ligam as duas pontas nos dois sentidos.

Nó de webhook para receber, nó HTTP Request para enviar pela Datafy API, e o filtro que impede o fluxo de responder aos status e entrar em laço exponencial.