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.ticketId: obtenha-o pelo webhook do canal (ticket.id) ou pela listagem de atendimentos (listTickets).
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.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.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
Button Template
Generic Template (Cards)
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.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:
ERR_API_NOT_MESSENGER.
