Pular para o conteúdo principal
Canais de Instagram e Messenger usam os recursos de mensageria interativa da própria Meta (Send API do Messenger Platform). Estes endpoints espelham o formato oficial da Meta para cada tipo de template, além de endpoints de configuração de canal (ice breakers, menu persistente, saudação e personas). Todas as requisições exigem o cabeçalho Authorization: Bearer {BearerToken}.
A coleção oficial do Postman usa, nas pastas de Instagram e Messenger, nomes de variável diferentes ({{BASE_URL}}, {{API_TOKEN}}, {{apiId}}) dos nomes padrão ({{BaseUrl}}, {{BearerToken}}, {{ApiID}}). Preencha com os mesmos valores, com uma diferença: {{BASE_URL}} leva o domínio com https://, e {{BaseUrl}} vai sem. Veja Autenticação: Coleção do Postman. Nesta página usamos a notação padrão {BaseUrl} / {ApiID}, como no restante da referência.
Todos os endpoints de envio abaixo endereçam o destinatário por ticketId: obtenha-o pelo webhook do canal (ticket.id) ou pela listagem de atendimentos (listTickets).
As rotas de Instagram exigem uma API ligada a um canal do Instagram, e as de Messenger, uma API ligada a um canal do Messenger (a Sessão escolhida ao criar a API em Configuração → API). Com outro tipo de canal, a resposta é 400 com ERR_API_NOT_INSTAGRAM ou ERR_API_NOT_MESSENGER, inclusive nas rotas de configuração (action: "get", "list"). Veja Respostas e erros.

Instagram

Quick Reply

Envia uma mensagem com botões de resposta rápida (quick replies), incluindo o tipo especial de solicitação de telefone.

Button Template

Envia até 3 botões de ação (postback ou web_url) abaixo de uma mensagem.

Generic Template (Cards)

Envia um carrossel de cards horizontais, cada um com imagem, título, subtítulo e botões próprios.

Ice Breakers (get / set / delete)

Gerencia as perguntas de atalho (“ice breakers”) exibidas antes da primeira interação do contato com o perfil no Instagram.
Definir os ice breakers (action: "set"):
Para action: "get" ou action: "delete", envie apenas o campo action: os demais campos não se aplicam. Em canal do Instagram conectado pelo Login Unificado (sem Página do Facebook), a rota responde 409 com ERR_IG_UNIFIED_FEATURE_UNAVAILABLE: os ice breakers ainda não estão disponíveis nesse login.

Persistent Menu (get / set / delete)

Gerencia o menu persistente exibido no composer de mensagens do Instagram.
Definir o menu (action: "set"):
Em canal do Instagram conectado pelo Login Unificado (sem Página do Facebook), a rota responde 409 com ERR_IG_UNIFIED_FEATURE_UNAVAILABLE: o menu persistente ainda não está disponível nesse login.

Messenger

Quick Reply

Mesmos campos do Quick Reply do Instagram.

Button Template

Mesmos campos do Button Template do Instagram.

Generic Template (Cards)

Mesmos campos do Generic Template do Instagram.

Media Template

Envia uma imagem ou vídeo acompanhado de botões de ação.

Receipt Template (Recibo)

Envia um recibo de pedido formatado, com itens, quantidades, preços e total.

Message Tag (Marketing / Utility)

Envia uma mensagem fora da janela padrão de 24 horas usando uma tag de mensagem da Meta, permitida apenas para determinadas categorias de conteúdo.

Customer Feedback Template (NPS / CSAT)

Envia uma pesquisa de satisfação nativa do Messenger (CSAT, NPS ou CES).

Greeting Text (get / set / delete)

Gerencia o texto de saudação exibido na tela inicial da conversa, antes do primeiro contato.

Personas (list / create / delete)

Gerencia personas: identidades de exibição (nome e foto) que podem ser atribuídas a mensagens enviadas por diferentes agentes ou bots, para que o contato veja de quem está recebendo a resposta.
Criar uma persona (action: "create"):

Respostas e erros

A resposta de sucesso segue o padrão geral da API: success: true e os dados em data. Em personas com action: "list", a resposta traz os IDs das personas, usados depois em personaId para excluir. Se a API usada não estiver ligada a um canal do tipo exigido, a resposta é 400 só com o campo error (sem success), inclusive nas rotas de configuração:
Nas rotas de Messenger, o erro é ERR_API_NOT_MESSENGER.