Os cinco canais, em duas linhas cada
Meta Cloud API (Oficial)
A API da Meta, com número verificado e conta de empresa. É o canal que aceita mais coisa: é o
único com formulário, catálogo e template. Em troca, tem a janela de 24
horas.
WhatsApp Web
A conexão por leitura de QR code, com o celular pareado. Não tem janela nem template: você
escreve a qualquer hora. Alguns recursos de loja exigem que o número seja uma conta WhatsApp
Business com produtos cadastrados.
Instagram e Messenger
Conversa de direct. Aceitam texto, mídia e botões, e param aí: não têm localização, contato nem
lista de opções. Os dois têm janela de 24 horas.
Telegram
Um bot. Aceita quase tudo e não tem janela, mas fala outro idioma: o que no WhatsApp é um tipo de
mensagem, lá às vezes é um botão de teclado.
Como ler a tabela
⚠️ nunca significa “vai que funciona”. Significa que funciona e nós sabemos em qual condição — e
a condição está escrita por extenso aqui embaixo, e também na página de cada endpoint, embaixo da
tabelinha dele.
O dia a dia da conversa
Texto e mídia são o chão comum: funcionam nos cinco, com o mesmo corpo. É daí para cima que os canais
começam a discordar.
Quando o cliente responde tocando
Botão rápido é o que volta como resposta do cliente, e existe em todo canal. Botão de ação é o que o
aparelho executa: abrir um link ou ligar. O link funciona em todos; ligar, só onde a plataforma tem
botão de telefone.
Loja e pedido
Mensagem de loja depende de existir uma loja. No WhatsApp o catálogo mora na conta de empresa; no
Instagram e no Messenger a API de mensagens não alcança o catálogo; no Telegram não há catálogo, e o
que existe é a cobrança avulsa.
Template pré-aprovado
Template é a mensagem que a Meta aprova antes para você poder escrever primeiro, fora da janela. Só
existe onde existe janela: Meta Cloud API e Messenger. Nos outros canais você escreve quando quiser,
então ele não faria falta.
As ressalvas, uma por uma
Sticker no Instagram e no Messenger
Nos dois você não manda o seu arquivo. O Instagram aceita só o sticker de coração; o Messenger aceita só os stickers públicos do catálogo da Meta, escolhidos por identificador, mais o joinha. Um.webp do seu time passa no WhatsApp e no Telegram, e é recusado nesses dois.
O que fazer: nesses canais, mande a mesma arte como imagem. O cliente vê a figura; só não vem com
fundo transparente.
Fonte: Sticker API do Messenger.
Botão de ação no Instagram e no Telegram
Botão de ação é o par “abrir link” e “ligar”. Nesses dois, só o link funciona: o template de botões do Instagram aceita apenas link e resposta, e o teclado do Telegram não tem botão de telefone. O que fazer: troque o botão de ligar por um botão de link comtel: no destino quando o canal
permitir, ou escreva o telefone no texto da mensagem.
Catálogo, produto e pedido no WhatsApp Web
Funcionam, mas por um caminho diferente: passam pela compatibilidade com a Z-API e só saem se o número conectado for uma conta WhatsApp Business com produtos cadastrados. Número pessoal não tem catálogo, então não há o que enviar. O que fazer: se a loja é a parte importante da sua integração, use a Meta Cloud API. No Web, trate o catálogo como um extra que depende de como o cliente configurou o número dele. Fontes: produto, catálogo e pedido na Z-API.Multi-produto só na plataforma oficial
Mandar vários produtos numa mensagem só existe na Meta Cloud API. Na conexão não oficial dá para mandar um produto por vez, e nos outros canais não há equivalente.Detalhes do pedido no Messenger e no Telegram
Os dois têm algo parecido, e a diferença importa:- Messenger: o comprovante de pedido mostra itens, total e forma de pagamento, mas é o registro de uma compra já feita. Não tem botão de pagar.
- Telegram: a fatura cobra dentro do app, e para isso exige um provedor de pagamento configurado no bot.
Pedir localização no Telegram
Funciona, só não é um tipo de mensagem: é um botão de teclado que pede a localização (request_location). Para o cliente dá no
mesmo, ele toca e a localização chega. Marcamos ✅ porque o resultado é o mesmo.
Reação no Messenger
Aqui a resposta honesta é: não sabemos. A reação que o cliente manda chega para você pelo webhook, mas não achamos na documentação da Meta a confirmação de que a empresa pode reagir a uma mensagem. O changelog cita isso, a referência do endpoint não descreve o campo. No Instagram, a reação está documentada e funciona. O que fazer: não construa um fluxo que depende de reagir no Messenger sem testar antes. Assim que confirmarmos, esta página muda.Template no Instagram
Não é decisão da Meta, é consequência de como conectamos: omessage_templates do Graph API existe
apenas no node Page, e o Omni Z-API conecta o Instagram via Instagram Login, que não expõe essa
edge. Detalhes em Conectar Instagram.
Quando o canal não aceita: o que mandar no lugar
A janela de 24 horas, em uma frase
O content.type de cada recurso
Alguns desses endpoints ainda estão em desenvolvimento. A página de cada um avisa no topo, e o
playground mostra quais já respondem de verdade.
Próximos passos
Enviar a primeira mensagem
O corpo mínimo, e o que volta.
Janela de conversa
Quando você pode escrever primeiro, e quando precisa de template.
Ciclo de vida do canal
Criar, conectar, assinar, desconectar e remover.
Limitações da API Oficial
O que a Z-API clássica tem e a oficial não.