Enviar reacción

POST

api

message

reaction

:instance

Enviar reacción

curl --request POST \
  --url https://api.example.com/api/message/reaction/:instance \
  --header 'Content-Type: <content-type>' \
  --header 'token: <token>' \
  --data '
{
  "number": "<string>",
  "messageId": "<string>",
  "reaction": "<string>",
  "fromMe": true,
  "participant": "<string>",
  "source": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {token: '<token>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    number: '<string>',
    messageId: '<string>',
    reaction: '<string>',
    fromMe: true,
    participant: '<string>',
    source: '<string>'
  })
};

fetch('https://api.example.com/api/message/reaction/:instance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/api/message/reaction/:instance"

payload = {
    "number": "<string>",
    "messageId": "<string>",
    "reaction": "<string>",
    "fromMe": True,
    "participant": "<string>",
    "source": "<string>"
}
headers = {
    "token": "<token>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: no

Descripción

Agrega o elimina una reacción (emoji) en un mensaje existente. El campo reaction acepta el emoji ("👍", "❤️", "😂", etc.) o la cadena literal "remove" para eliminar la reacción. En chats 1-a-1, messageId + fromMe es suficiente. En grupos, cuando el mensaje original no fue enviado por la instancia (fromMe: false), debes proporcionar participant con el JID del autor original, sin él, WhatsApp no puede localizar el objetivo. Las reacciones no soportan delay, replyTo ni mention.

Ejemplos

Reaccionar en un chat 1-a-1

fromMe: false indica que el mensaje objetivo fue recibido (no enviado) por la instancia.

curl -X POST "https://ryzeapi.cloud/api/message/reaction/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number":    "5511999999999",
    "messageId": "3EB08FCF27E532F1B0F5",
    "reaction":  "👍",
    "fromMe":    false
  }'

await fetch(`https://ryzeapi.cloud/api/message/reaction/${process.env.Instance_Name}`, {
  method: "POST",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    number:    "5511999999999",
    messageId: "3EB08FCF27E532F1B0F5",
    reaction:  "👍",
    fromMe:    false
  })
});

import os, requests

requests.post(
    f"https://ryzeapi.cloud/api/message/reaction/{os.environ['Instance_Name']}",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={
        "number":    "5511999999999",
        "messageId": "3EB08FCF27E532F1B0F5",
        "reaction":  "👍",
        "fromMe":    False
    }
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{
        "number":    "5511999999999",
        "messageId": "3EB08FCF27E532F1B0F5",
        "reaction":  "👍",
        "fromMe":    false
    }`)
    req, _ := http.NewRequest("POST", "https://ryzeapi.cloud/api/message/reaction/"+os.Getenv("Instance_Name"), body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

Reaccionar en un grupo (mensaje de otro participante)

En grupos, cuando reaccionas a un mensaje que no es tuyo (fromMe: false), el participant con el JID del autor original es requerido. Sin él el servidor retorna 400 missing_participant.

curl -X POST "https://ryzeapi.cloud/api/message/reaction/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number":      "120363406289005073@g.us",
    "messageId":   "3EB08FCF27E532F1B0F5",
    "reaction":    "❤️",
    "fromMe":      false,
    "participant": "5511888888888@s.whatsapp.net"
  }'

await fetch(`https://ryzeapi.cloud/api/message/reaction/${process.env.Instance_Name}`, {
  method: "POST",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    number:      "120363406289005073@g.us",
    messageId:   "3EB08FCF27E532F1B0F5",
    reaction:    "❤️",
    fromMe:      false,
    participant: "5511888888888@s.whatsapp.net"
  })
});

import os, requests

requests.post(
    f"https://ryzeapi.cloud/api/message/reaction/{os.environ['Instance_Name']}",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={
        "number":      "120363406289005073@g.us",
        "messageId":   "3EB08FCF27E532F1B0F5",
        "reaction":    "❤️",
        "fromMe":      False,
        "participant": "5511888888888@s.whatsapp.net"
    }
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{
        "number":      "120363406289005073@g.us",
        "messageId":   "3EB08FCF27E532F1B0F5",
        "reaction":    "❤️",
        "fromMe":      false,
        "participant": "5511888888888@s.whatsapp.net"
    }`)
    req, _ := http.NewRequest("POST", "https://ryzeapi.cloud/api/message/reaction/"+os.Getenv("Instance_Name"), body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

Eliminar una reacción

Envía reaction: "remove" para limpiar una reacción colocada anteriormente en el mensaje.

curl -X POST "https://ryzeapi.cloud/api/message/reaction/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number":    "5511999999999",
    "messageId": "3EB08FCF27E532F1B0F5",
    "reaction":  "remove",
    "fromMe":    true
  }'

await fetch(`https://ryzeapi.cloud/api/message/reaction/${process.env.Instance_Name}`, {
  method: "POST",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    number:    "5511999999999",
    messageId: "3EB08FCF27E532F1B0F5",
    reaction:  "remove",
    fromMe:    true
  })
});

import os, requests

requests.post(
    f"https://ryzeapi.cloud/api/message/reaction/{os.environ['Instance_Name']}",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={
        "number":    "5511999999999",
        "messageId": "3EB08FCF27E532F1B0F5",
        "reaction":  "remove",
        "fromMe":    True
    }
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{
        "number":    "5511999999999",
        "messageId": "3EB08FCF27E532F1B0F5",
        "reaction":  "remove",
        "fromMe":    true
    }`)
    req, _ := http.NewRequest("POST", "https://ryzeapi.cloud/api/message/reaction/"+os.Getenv("Instance_Name"), body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

Respuesta exitosa

El messageId retornado es el de la propia reacción (no el del mensaje reaccionado, ese permanece en replyTo.messageId). content carga el emoji aplicado, o una cadena vacía cuando la reacción fue eliminada.

200 OK

{
  "success": true,
  "message": "Reaction sent successfully",
  "status":  "sent",
  "data": {
    "messageId":   "3EB08FCF27E532F1C2C2",
    "direction":   "sent",
    "messageType": "reaction",
    "content":     "👍",
    "source":      "api",
    "timestamp":   "2026-04-30T14:30:00Z",
    "chat": {
      "jid":     "5511999999999@s.whatsapp.net",
      "isGroup": false
    },
    "sender": {
      "jid":      "5511777777777@s.whatsapp.net",
      "instance": "my-instance"
    },
    "replyTo": {
      "messageId": "3EB08FCF27E532F1B0F5"
    }
  }
}

Cuando la reacción se elimina (reaction: "remove"), el message retornado se vuelve "Reaction removed successfully" y content está vacío. La reacción aparece en el destinatario anclada al mensaje original, si reaccionas de nuevo con otro emoji, WhatsApp reemplaza la reacción anterior.

Parámetros de ruta

string

requerido

Nombre de la instancia (p. ej., $Instance_Name).

Cabeceras

string

requerido

TokenAccount o TokenInstance.

string

requerido

application/json

Cuerpo de la solicitud

string

requerido

Chat donde vive el mensaje objetivo: teléfono (5511999999999) o JID (@s.whatsapp.net, @lid, @g.us).

string

requerido

ID del mensaje que recibirá la reacción.

string

requerido

Emoji de reacción (p. ej., "👍", "❤️", "😂", "🔥") o la cadena literal "remove" para limpiar una reacción existente.

boolean

predeterminado:"false"

true cuando el mensaje original fue enviado por la propia instancia; false cuando fue recibido de otro contacto/participante. WhatsApp usa esta flag junto con participant para localizar el objetivo.

string

JID del autor del mensaje original (p. ej., 5511888888888@s.whatsapp.net). Requerido en grupos cuando fromMe: false, sin él el servidor retorna 400 missing_participant. En chats 1-a-1 o cuando fromMe: true, se ignora.

string

predeterminado:"api"

Identificador de origen para trazabilidad (p. ej., crm, support-bot, n8n). Guardado en el registro del mensaje y propagado a los webhooks.

Notas

Las reacciones no soportan delay, replyTo, replyPrivate, mention ni mentionAll, solo los campos listados arriba.
Para cambiar una reacción existente, simplemente envía una nueva con otro emoji. WhatsApp la reemplaza automáticamente.
En grupos, sin el participant correcto la reacción falla con missing_participant aunque el messageId exista en la base de datos.
fromMe debe reflejar el lado real del mensaje. Si está invertido, WhatsApp puede fallar en localizar el objetivo y la reacción desaparece silenciosamente en la app del destinatario.

Errores

HTTP	Status interno	Mensaje
400	,	`Instance name is required`
400	,	`Invalid request body: <detail>`
400	,	`Number is required`
400	,	`MessageID is required`
400	,	`Reaction is required`
400	`invalid_number`	`Invalid phone number format: <detail>`
400	`invalid_message_id`	(motivo de messageId inválido)
400	`missing_participant`	`Participant is required for group reactions when fromMe=false`
404	,	`Instance not found`
500	`send_failed`	`Failed to send reaction: <reason>`
503	`disconnected`	`Instance is not connected to WhatsApp`

Envoltorio de error:

{
  "success": false,
  "error": { "message": "Reaction is required" }
}

Introducción

Instancia

Eventos

Mensajes

Llamadas

Grupos

Comunidades

Newsletter

Perfil

Chat

Chatwoot

Typebot

Observabilidad

Enviar reacción

Descripción

Ejemplos

Reaccionar en un chat 1-a-1

Reaccionar en un grupo (mensaje de otro participante)

Eliminar una reacción

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Notas

Errores

​Descripción

​Ejemplos

​Reaccionar en un chat 1-a-1

​Reaccionar en un grupo (mensaje de otro participante)

​Eliminar una reacción

​Respuesta exitosa

​Parámetros de ruta

​Cabeceras

​Cuerpo de la solicitud

​Notas

​Errores

Descripción

Ejemplos

Reaccionar en un chat 1-a-1

Reaccionar en un grupo (mensaje de otro participante)

Eliminar una reacción

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Notas

Errores