AnyLinga
ES
Iniciar sesión Prueba gratis

Centro de ayuda/Agente de IA

Cómo puede el agente de IA agregar reacciones y recibir las del cliente

Actualizado: 2026-11-13

Para que el agente de IA agregue o quite una reacción, envía una solicitud a /api/connect/react con el id del mensaje y el emoji. Para que el flujo de n8n reciba las reacciones del cliente, activa Avisar a la IA de las reacciones del cliente en los ajustes de la pasarela de IA.

Cómo agregar o quitar una reacción

Envía POST /api/connect/react con el encabezado Authorization: Bearer <token>. El token es el valor del campo Token de callback en la página Conecta tu IA. Es el mismo token que se usa para responder al cliente.

Incluye message_id y emoji en el cuerpo. Puedes reaccionar tanto a un mensaje del cliente como a uno enviado por el propio agente.

Para quitar una reacción, envía una cadena vacía: "emoji": "".

POST https://app.anylinga.com/api/connect/react
Authorization: Bearer <Token de callback>
Content-Type: application/json

{
  "message_id": "6a1f3c2e-9b7d-4e5a-8c21-0d4b7e9f2a13",
  "emoji": "👍"
}
El límite es de 60 solicitudes por minuto.

Dónde obtener el message_id

message_id es el id del mensaje en AnyLinga. Para reaccionar a un mensaje del cliente, toma el campo message_id del mensaje entrante que recibió el flujo.

Para reaccionar al texto del agente, toma el campo message_id de la respuesta de AnyLinga al callback o a /api/connect/send. Si solo se enviaron plantillas, sin texto, la respuesta no incluye el campo message_id.

En qué canales funcionan las reacciones

El agente de IA puede agregar reacciones en WhatsApp conectado por código QR, WhatsApp Business API y un bot de Telegram.

En los demás canales —Telegram personal, Instagram, Facebook, TikTok, MAX, LinkedIn y chat web—, AnyLinga devuelve 422 reactions_not_supported. En Telegram personal, los bots de Telegram para empresas no tienen permiso para agregar reacciones.

El asesor ve la reacción del agente en el chat de Kommo, en el mismo mensaje, como una reacción de un empleado. Si se replica correctamente, la respuesta es {"ok": true, "crm_mirrored": true}.

Si no se pudo replicar la reacción en Kommo, la respuesta incluye "crm_mirrored": false. Aun así, la reacción se envió al cliente.

Qué significan las respuestas de la API

Revisa el código de respuesta y el valor de crm_mirrored para distinguir entre el envío de la reacción al cliente y su visualización en Kommo.

RespuestaQué significa
200La reacción se envió al cliente; crm_mirrored indica si apareció en Kommo.
400message_id no parece un id de mensaje o emoji contiene más de un emoji.
401El Token de callback es incorrecto.
404 message_not_foundEl mensaje no existe o pertenece a otra cuenta.
422 reactions_not_supportedAnyLinga no agrega reacciones en este canal.
422 no_messenger_idEl mensaje no tiene id en el servicio de mensajería, por lo que no se le puede agregar una reacción.
502 send_failedEl servicio de mensajería no aceptó la reacción, por ejemplo, si el valor de emoji no es un emoji.

Cómo activar las notificaciones de reacciones del cliente

Antes de activarlas, asegúrate de que el flujo revise el campo event: los mensajes normales del cliente no incluyen este campo.

1. Abre los ajustes de la pasarela de IA

  • Ve a Herramientas y ajustes → Pasarela de IA, a la página Conecta tu IA.

2. Activa las notificaciones de reacciones

  • Debajo del interruptor Activar pasarela, busca Avisar a la IA de las reacciones del cliente y actívalo.
  • El ajuste se guarda en cuanto haces clic. No necesitas hacer clic en Guardar.
El interruptor está desactivado de forma predeterminada. Es visible con cualquier CRM.

Cómo procesar el evento client_reaction

Cuando el cliente agrega o quita una reacción, el evento client_reaction llega a la misma URL del webhook de n8n con la misma firma X-AnyLinga-Signature. No necesitas responder mediante callback; el webhook debe responder con 2xx. Los filtros de oportunidades no se aplican al evento.

Distingue el evento de un mensaje del cliente mediante el campo event. Usa message_id para identificar a qué mensaje reaccionó el cliente.

CampoContenido
eventclient_reaction.
conversation_idConversación.
channelCanal.
contact_idContacto en Kommo o null.
message_idMensaje al que reaccionó el cliente: el mismo id que aparece en el mensaje entrante o en la respuesta del callback.
message_directioninbound si la reacción es a un mensaje del cliente; outbound si es a un mensaje de la empresa.
emojiEmoji de la reacción.
actionreact si el cliente agregó una reacción; unreact si la quitó.
tsHora.
Un cambio, un evento: si el servicio de mensajería envía la misma reacción varias veces, el flujo la recibe una sola vez. Al quitar una reacción, llega unreact con el emoji que el cliente quitó. Una reacción a un mensaje antiguo que no existe en AnyLinga no genera ningún evento.

Qué campos recibe el flujo, cómo trabajan el agente de IA y el asesor en un mismo chat, cómo conectar un agente de IA mediante n8n.

¿Te resultó útil este artículo?

¿Tienes preguntas?

Respondemos en horario laboral.

¿Ya usas AnyLinga?

Cuéntanos tu pregunta y te respondemos por WhatsApp o email.

¿Aún no tienes cuenta?

Pruébalo tú mismo o lo conectamos por ti al pagar el primer mes.

Consultar conexión

Qué necesitas