Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

react / unreact

Os dois valores de reaction.action: uma reação adicionada, ou uma reação removida.

v12.0

Versão da Graph API a partir da qual a Meta suporta angry, sad, wow, love, like, laugh e outras reações neste webhook.

No echo

A Meta não envia notificação quando a própria conta reage a uma mensagem de uma pessoa ou remove a reação.

Default

message_reactions está entre os campos a que um novo produto Instagram no painel da app começa subscrito.

100/sec

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:

A message_reactions notification, as Meta sends it
{
  "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.

The reaction object of an unreact
"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.

Reacting to a person's message
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.
Fazer isto com a EasyCoexistence

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