Disparador de Reacción de WhatsApp

Esta guía explica cómo configurar y usar el Disparador de Reacción de WhatsApp en OneChat, con base en el proceso paso a paso a continuación:

Paso 1: Crear un nuevo disparador

Dentro de tu bot, navega a la sección de Triggers en OneChat:

• Ve a Automations en la barra lateral izquierda.
• Selecciona Triggers entre las opciones disponibles.

1. Haz clic en el botón New Trigger ubicado en la esquina superior derecha de la interfaz.

2. En la lista de opciones de disparador, selecciona WhatsApp Reaction.

Paso 2: Configurar el disparador de reacción de WhatsApp

En la ventana Trigger Configuration:

• Ingresa un nombre descriptivo para tu disparador (por ejemplo, WhatsApp Reaction Trigger).
• En la opción Save content to a user field, selecciona o crea un nuevo Custom User Field donde se almacenarán los datos de la reacción.

Para crear un nuevo campo de usuario:

• Haz clic en el botón + Create New Field.
• Asigna un nombre al campo (por ejemplo, WhatsApp Reaction Payload).
• Selecciona JSON como el tipo de campo.
• Guarda el nuevo campo.

1. De manera opcional, puedes agregar tags o notes a este disparador para una mejor organización.

2. Asegúrate de que el Trigger Activation Toggle esté en Activated (verde).

3. Haz clic en el botón Save para finalizar la configuración.

Paso 3: Vincular o crear un flujo para manejar reacciones

Después de configurar el Disparador de Reacción de WhatsApp, puedes:

• Seleccionar un flujo existente: Si ya tienes un flujo configurado para manejar reacciones de WhatsApp, simplemente conéctalo al disparador.
• Crear un flujo nuevo: Si todavía no tienes un flujo, puedes crear uno específicamente para procesar las reacciones.

El flujo puede diseñarse para capturar y procesar los datos de la reacción almacenados en el campo de usuario personalizado. Esto puede incluir:

• Identificar el tipo de reacción.
• Responder al usuario con un mensaje personalizado.
• Registrar la reacción para análisis o reportes.

Paso 4: Comprender la integración del payload en los nodos de mensaje

Al crear tu flujo, puedes utilizar el Custom User Field que contiene el payload de la reacción. Las capturas de pantalla proporcionadas muestran:

• Dónde se ubicará el Custom User Field (por ejemplo, WhatsApp Reaction Payload) dentro de un Node.
• Cómo se puede acceder a los datos de la reacción en formato JSON e integrarlos en el contenido de tu mensaje.

1. Esto te permite hacer referencia dinámicamente a los datos de la reacción y usarlos dentro del flujo.

Paso 5: Ver el payload en acción

Las capturas de pantalla también muestran un ejemplo de la reacción activándose en una conversación de chat en vivo:

• Verás la reacción almacenada en el Custom User Field con una estructura de payload clara, que incluye:

El ID del mensaje al que se reaccionó.

• La reacción en sí (por ejemplo, 👍 o ❤️).

1. Este ejemplo te ayuda a comprender el formato de los datos y cómo puede usarse para identificar y procesar la reacción en tu flujo.

Paso 6: Crear un flujo personalizado para reacciones

Con esta comprensión, ahora puedes crear o modificar tu flujo para:

• Identificar el tipo de reacción.
• Activar respuestas o acciones específicas según el tipo de reacción.
• Gestionar la interacción del usuario de una forma alineada con las necesidades de tu negocio.

1. La flexibilidad de Flow Builder en OneChat garantiza que puedas diseñar un proceso adaptado a tus requisitos.

Siguiendo estos pasos, puedes utilizar eficazmente el Disparador de Reacción de WhatsApp para capturar, comprender y responder a las reacciones de los usuarios, creando una experiencia personalizada y atractiva.

Guía adicional: Obtener el contenido de un mensaje usando el nodo Bot User API

#### Paso 1: Agregar un nodo Bot User API a tu flujo

1. Abre Flow Builder en OneChat.

2. Arrastra y suelta el Action Node en tu flujo y ve a Advanced Actions.

3. En Advanced Actions puedes seleccionar Bot User API.

#### Paso 2: Configurar el nodo Bot User API

1. Action Type: Selecciona Get Chat Messages.

2. Completa los campos requeridos:

• Bot User Ns (Solo prueba): Ingresa el User Ns de prueba (por ejemplo, f79795u1718...).
• Message Id: Ingresa el Message Id de prueba (por ejemplo, wamid.HBgMTN...). Más adelante, puedes reemplazar este valor estático por un Custom Field que contenga el Message ID dinámico.

#### Paso 3: Procesar la respuesta de la API

Probar la solicitud:

• Haz clic en Test Request para recuperar la respuesta JSON que contiene los datos del mensaje. El sistema devolverá el contenido del mensaje en formato JSON.

1. Mapear los datos:

En la sección Sample Data, localiza el valor deseado dentro de la respuesta JSON. Por ejemplo:

Usa el JSON Path para acceder al campo específico y guardar el texto del mensaje en un campo personalizado.

Guardar el resultado en un campo personalizado:

• En el campo Map Response to Custom Field, selecciona o crea un Custom Field para almacenar el resultado (por ejemplo, Message_content).
• Ingresa el JSON Path y haz clic en Add para confirmar.
• De forma opcional, puedes definir un Fallback Value en caso de que el JSON no devuelva los datos esperados.

Reemplazar el Message Id por una variable dinámica:

• Después de probar y mapear correctamente el JSON, reemplaza el campo estático Message Id por un Custom Field que almacene dinámicamente el Message ID.

Ejemplo: {{Message_ID}}.

Guardar tu configuración:

• Haz clic en Save para finalizar la configuración.

Resultado:

Con esta configuración, el texto del mensaje se guardará en el Custom Field definido, lo que te permitirá usar estos datos en otros nodos o mensajes dentro del flujo.

Si encuentras problemas, envía un ticket a ticket@onechat.com.au.