Webhook message_reactions do Instagram: o payload de reagir e remover reação
O campo message_reactions do Instagram avisa uma app quando uma pessoa reage a uma mensagem na sua conversa com uma conta profissional, ou remove a reação. O evento aparece no array messaging, com um objeto reaction: mid, o ID da mensagem a que se reagiu; action, react ou unreact; e, apenas em react, reaction, como love, e emoji, o próprio emoji.
O easyCoexistence subscreve cada conta do Instagram ligada a comments, messages e mentions, e encaminha esses eventos para o seu endpoint HTTPS à medida que chegam, assinados com o segredo dessa conta, cada mensagem com o seu mid.
Os dois valores de reaction.action: uma reação adicionada, ou uma reação removida.
Versão da Graph API a partir da qual a Meta suporta angry, sad, wow, love, like, laugh e outras reações neste webhook.
A Meta não envia notificação quando a própria conta reage a uma mensagem de uma pessoa ou remove a reação.
message_reactions está entre os campos a que um novo produto Instagram no painel da app começa subscrito.
Chamadas por segundo à Send API por conta, para texto, links, reações e autocolantes.
Quando dispara message_reactions?
Quando uma pessoa reage a uma mensagem na sua conversa com a conta profissional, e de novo quando remove essa reação, desde que a app e a conta estejam subscritas ao campo. O guia de mensagens do Instagram da Meta é explícito na outra direção: quando a própria conta reage ou remove uma reação, não é enviada notificação, e messages também não entrega eco para ela.
Como é uma notificação de reação?
Um POST com object definido como instagram, cuja entry contém um array messaging. Ao contrário de uma mensagem direta, o evento não traz um objeto message: a reação fica no seu próprio objeto reaction, ao lado de sender, recipient e timestamp. Exemplo da Meta para o Instagram Login:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "react",
"reaction": "love",
"emoji": "\u{2764}\u{FE0F}"
}
}
]
}
]
}O que significa cada campo?
Os campos que a Meta documenta para um evento de reação, de fora para dentro:
- entry[].id e recipient.id: a conta profissional. sender.id: o ID com âmbito Instagram da pessoa que reagiu.
- timestamp: quando o evento foi disparado, em milissegundos nos exemplos da Meta; entry[].time é quando a Meta enviou a notificação.
- reaction.mid: o ID da mensagem a que se reagiu, o mesmo mid que essa mensagem tinha no seu evento messages.
- reaction.action: react quando uma reação é adicionada, unreact quando é removida.
- reaction.reaction: o nome da reação, como love; a Meta lista angry, sad, wow, love, like, laugh e other.
- reaction.emoji: o emoji como string Unicode, como \u{2764}\u{FE0F} para love.
- Em unreact, reaction e emoji ficam de fora.
Como é um unreact?
O mesmo evento com action definido como unreact e sem reaction nem emoji, já que não resta nada a nomear. Associe-o à reação que remove através de reaction.mid e sender.id, e retire a reação dessa pessoa na mensagem dos seus registos.
"reaction": {
"mid": "<MESSAGE_ID>",
"action": "unreact"
}Para que mensagem aponta o mid?
Para a mensagem a que a pessoa reagiu, com o mesmo mid que tinha no evento messages, incluindo os ecos das mensagens da própria conta. Um handler que guarde mids pode associar a reação à linha certa da conversa. A Meta assinala uma limitação: uma reação a uma imagem de uma publicação em carrossel indica a primeira imagem do carrossel, que pode não ser a escolhida.
Como é que uma conta reage a uma mensagem?
Com POST /<IG_ID>/messages: recipient.id definido como o ID com âmbito Instagram da pessoa, sender_action definido como react, e um payload com message_id e reaction, um emoji ou a sua forma UTF-8. Repetir o pedido com outro emoji altera a reação, e sender_action definido como unreact, apenas com message_id, remove-a. Nenhuma das chamadas produz um webhook.
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"recipient": { "id": "<IGSID>" },
"sender_action": "react",
"payload": {
"message_id": "<MESSAGE_ID>",
"reaction": "<EMOJI>"
}
}Do que precisa message_reactions?
Com o Instagram Login, instagram_business_basic e instagram_business_manage_messages, e Advanced Access para contas que o programador não possui nem gere. Um novo produto Instagram no painel da app começa subscrito a message_reactions, e cada conta é subscrita através de POST /<IG_ID>/subscribed_apps. O guia Send Messages da Meta indica-o como messaging_reactions, mas a sua tabela de campos, as predefinições do painel e a referência do webhook dizem message_reactions.
O easyCoexistence reencaminha reações?
Não. A app da easyCoexistence e cada conta ligada estão subscritas apenas a comments, messages e mentions, pelo que os eventos message_reactions não são reencaminhados para o seu endpoint. Os ecos a que as reações apontam pelo seu mid chegam ao seu endpoint, assinados com o segredo da conta.
Erros comuns
- Procurar a reação dentro de message. Um evento de reação não tem objeto message; leia o objeto reaction ao lado de sender e recipient.
- Ler reaction ou emoji sem verificar action. Ambos ficam de fora em unreact, pelo que o código que os assume falha quando uma reação é removida.
- Esperar um webhook depois de a conta reagir. A Meta não envia nenhum para as reações da própria conta, nem sequer um eco, por isso registe-as quando a sua app as enviar.
- Copiar o nome messaging_reactions do guia Send Messages da Meta. O campo na sua tabela de campos, nas predefinições do painel e na referência do webhook é message_reactions.
O seu agente responde a uma pessoa com send_social_dm dentro da janela de 24 horas. US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que adiciona ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Porque é que uma reação numa publicação em carrossel aponta para a primeira imagem?
A Meta indica a primeira imagem do carrossel quando alguém reage a uma das imagens, que pode não ser a imagem escolhida pela pessoa.
O Instagram envia um webhook quando a empresa reage a uma mensagem?
Não. A Meta não envia nenhuma notificação message_reactions nem eco quando a conta reage ou remove a reação a uma mensagem.
Que reações pode o webhook do Instagram reportar?
O guia de mensagens do Instagram da Meta lista angry, sad, wow, love, like, laugh e other a partir da Graph API v12.0, com o próprio emoji em reaction.emoji.
O campo do webhook é message_reactions ou messaging_reactions?
message_reactions. O guia Send Messages da Meta escreve messaging_reactions, mas a tabela de campos, as predefinições do painel da app e a referência do webhook usam todos message_reactions.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em