Mensagem de Reação

O tipo REACTION permite reagir a uma mensagem existente com um emoji. A reação aparece vinculada à mensagem original, como nas reações nativas do WhatsApp.

Payload

{
  "channelId": "uuid-do-canal",
  "content": {
    "type": "REACTION",
    "to": {
      "type": "WHATSAPP",
      "number": "5511999999999"
    },
    "emoji": "\ud83d\udc4d",
    "targetMessageId": "20CFBA298FAB68AA75D3B369EDB5C805"
  }
}

Campos

string

required

Deve ser "REACTION".

Address

required

Endereço do destinatário (dono da mensagem que será reagida). Veja formatos de endereço.

string

required

Emoji da reação. Deve ser um emoji Unicode válido. Para remover uma reação, envie uma string vazia "".

string

required

ID da mensagem que receberá a reação. Este ID é recebido nos webhooks de mensagem.

boolean

default:"false"

Indica se a mensagem alvo (a que está sendo reagida) foi enviada pelo próprio canal. Use true ao reagir a uma mensagem que você mesmo enviou e false ao reagir a uma mensagem recebida.

string

Autor da mensagem alvo. Obrigatório ao reagir, dentro de um grupo, a uma mensagem enviada por outro participante (ou seja, quando targetFromMe é false). Fora de grupos pode ser omitido. Em grupos, use o LID do autor (ex.: 252780317044848@lid, recebido em content.from.lid nos webhooks) — com o JID a reação pode não ser vinculada à mensagem correta.

Exemplos

Reagir com emoji

curl -X POST https://api-dev.messagefy.io/api/v1/message/SendMessage \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: sua-api-key-aqui" \
  -d '{
    "channelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "content": {
      "type": "REACTION",
      "to": {
        "type": "WHATSAPP",
        "number": "5511999999999"
      },
      "emoji": "\ud83d\udc4d",
      "targetMessageId": "20CFBA298FAB68AA75D3B369EDB5C805"
    }
  }'

import requests

response = requests.post(
    "https://api-dev.messagefy.io/api/v1/message/SendMessage",
    headers={
        "Content-Type": "application/json",
        "X-API-KEY": "sua-api-key-aqui"
    },
    json={
        "channelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "content": {
            "type": "REACTION",
            "to": {
                "type": "WHATSAPP",
                "number": "5511999999999"
            },
            "emoji": "\ud83d\udc4d",
            "targetMessageId": "20CFBA298FAB68AA75D3B369EDB5C805"
        }
    }
)
print(response.json())

const response = await fetch(
  "https://api-dev.messagefy.io/api/v1/message/SendMessage",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-KEY": "sua-api-key-aqui",
    },
    body: JSON.stringify({
      channelId: "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      content: {
        type: "REACTION",
        to: {
          type: "WHATSAPP",
          number: "5511999999999",
        },
        emoji: "\ud83d\udc4d",
        targetMessageId: "20CFBA298FAB68AA75D3B369EDB5C805",
      },
    }),
  }
);
const data = await response.json();
console.log(data);

Emojis comuns para reações

Emoji	Unicode	Uso comum
Curtir	`\ud83d\udc4d`	Confirmação, aprovação
Coração	`\u2764\ufe0f`	Aprovação entusiástica
Risada	`\ud83d\ude02`	Humor
Surpresa	`\ud83d\ude2e`	Surpresa
Tristeza	`\ud83d\ude22`	Empatia
Oração	`\ud83d\ude4f`	Agradecimento
Check	`\u2705`	Confirmação, tarefa concluída

Remover uma reação

Para remover uma reação previamente enviada, envie o campo emoji como string vazia:

{
  "channelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "content": {
    "type": "REACTION",
    "to": {
      "type": "WHATSAPP",
      "number": "5511999999999"
    },
    "emoji": "",
    "targetMessageId": "20CFBA298FAB68AA75D3B369EDB5C805"
  }
}

Cada usuário pode ter apenas uma reação por mensagem. Ao enviar uma nova reação para a mesma mensagem, a reação anterior é automaticamente substituída.

Reação em mensagem de grupo

Para reagir, em um grupo, a uma mensagem enviada por outro participante, informe targetParticipant com o LID do autor da mensagem alvo e mantenha targetFromMe como false:

{
  "channelId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "content": {
    "type": "REACTION",
    "to": {
      "type": "WHATSAPP",
      "jid": "120363402110764959@g.us"
    },
    "emoji": "\u2705",
    "targetMessageId": "A5B4C3D2E1F09876543210ABCDEF1234",
    "targetFromMe": false,
    "targetParticipant": "252780317044848@lid"
  }
}

Em grupos, sem o targetParticipant correto o WhatsApp n\u00e3o consegue vincular a rea\u00e7\u00e3o \u00e0 mensagem certa. Informe sempre o LID do autor da mensagem alvo (recebido em content.from.lid nos webhooks) ao reagir a mensagens de terceiros.

Reações são uma forma leve de interagir sem enviar uma mensagem completa. Use-as para confirmar recebimento, aprovar solicitações ou sinalizar leitura de mensagens importantes.

Resposta

{
  "packageId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Recebimento

Quando um contato reage a uma mensagem, você recebe um webhook com content.type igual a REACTION. O conteúdo carrega o emoji da reação e o targetMessageId da mensagem reagida, além do envelope comum de mensagem recebida.

{
  "packageId": "019a1234-5678-7abc-def0-123456789ac3",
  "channelId": "019a1258-177c-7286-b060-9ee02a0800c7",
  "correlationId": null,
  "content": {
    "type": "REACTION",
    "emoji": "👍",
    "targetMessageId": "3EB08209536937A66D8434",
    "targetFromMe": true,
    "targetParticipant": null,
    "from": {
      "type": "WHATSAPP",
      "jid": "5511999998888@s.whatsapp.net",
      "number": "5511999998888",
      "name": "Cliente"
    },
    "to": {
      "type": "WHATSAPP",
      "jid": "5511988887777@s.whatsapp.net",
      "number": "5511988887777",
      "name": "Minha Empresa"
    },
    "messageId": "3EB08209536937A66D8436",
    "isFromMe": false,
    "isGroupMessage": false,
    "isForwarded": false,
    "isStatusMessage": false,
    "isHistoryMessage": false,
    "timestamp": "2026-07-23T14:37:00+00:00"
  },
  "timestamp": "2026-07-23T14:37:00.100+00:00",
  "providerMetadata": null
}

string

Emoji da reação recebida. Uma string vazia "" indica que o contato removeu uma reação anterior.

string

ID da mensagem que recebeu a reação. Corresponde ao messageId de uma mensagem enviada ou recebida anteriormente.

boolean

Indica se a mensagem reagida foi enviada pelo próprio canal (true) ou por outro participante (false).

string

JID do autor da mensagem alvo. Presente principalmente em grupos, quando a mensagem reagida não é sua.

Address

Endereço de quem reagiu. Para WhatsApp inclui jid, number e name (e lid quando disponível).

Address

Endereço do chat/destinatário (o próprio número em conversas individuais ou o JID do grupo).

string

ID desta mensagem de reação.

boolean

true quando a reação foi originada pelo próprio canal (por exemplo, eco de uma reação enviada por você).

boolean

true quando a reação ocorreu em um grupo.

boolean

true se a reação foi enviada para uma lista de transmissão (broadcast list).

boolean

true se a reação foi enviada para um grupo de avisos da comunidade.

boolean

true se a reação foi enviada para o grupo de avisos da comunidade.

true se a reação foi enviada para um canal/newsletter.

O envelope do webhook (packageId, channelId, correlationId, timestamp, providerMetadata) é comum a todos os tipos. Veja o formato completo em Recebendo Eventos.

Início

Contas

API Keys

Canais

WhatsApp Oficial

Tipos de Mensagem

Operações de Mensagem

Sessão e Conexão

Consultas

Interação

Mensagem de Reação

Mensagem de Reação

Payload

Campos

Exemplos

Reagir com emoji

Emojis comuns para reações

Remover uma reação

Reação em mensagem de grupo

Resposta

Recebimento

​Mensagem de Reação

​Payload

​Campos

​Exemplos

​Reagir com emoji

​Emojis comuns para reações

​Remover uma reação

​Reação em mensagem de grupo

​Resposta

​Recebimento

Mensagem de Reação

Payload

Campos

Exemplos

Reagir com emoji

Emojis comuns para reações

Remover uma reação

Reação em mensagem de grupo

Resposta

Recebimento