Webhook de respuesta de mensaje

​

¿Cómo funciona?

Cuando un usuario responde a un mensaje, podemos configurar un webhook para que se active y se envíe una solicitud HTTP a tu endpoint configurado en Treble. Este webhook es uno de los mas importantes para implementar casos de uso complejos, como la automatización de procesos o la integración con otras aplicaciones.

Por ejemplo, puedes configurar un webhook para capturar la respuesta de un cliente cuando se le pide su número de identificación. Treble enviará una solicitud HTTP a tu endpoint configurado en Treble con la respuesta del cliente la cual puedes procesar en tu aplicación. Posteriormente, puedes incluso devolver información a la conversación (flujo) de Treble para mostrar información dinámica obtenida por tu servidor, o encaminar la conversación por otro camino.

​

Diagrama de flujo de webhook de respuesta de mensaje

En este ejemplo, el cliente responde a un mensaje de WhatsApp con su número de identificación. Treble envía una solicitud HTTP a tu endpoint configurado en Treble con la respuesta del cliente con el número de identificación. Tu servidor la procesa y devuelve información a Treble para continuar la conversación.

​

¿Cómo configurar un webhook de respuesta de mensaje?

​

Tutorial Avanzado - Respuesta de tu servidor

En el paso a paso anterior, vimos cómo configurar un webhook de respuesta de mensaje en Treble. Ahora, vamos a ver cómo procesar la respuesta del cliente en tu servidor. Para esto, es necesario que tu servidor tenga un endpoint público al que se pueda enviar la solicitud HTTP.

​

Paso a Paso

1. Configura tu servidor: Asegúrate de que tu servidor esté configurado para recibir solicitudes HTTP. Puedes usar un framework como Express en Node.js para facilitar este proceso.

2. Crea un endpoint para el webhook: Define un endpoint en tu servidor que pueda recibir las solicitudes del webhook.

3. Procesa la solicitud: Extrae la información relevante de la solicitud y realiza las acciones necesarias, como verificar si el usuario existe.

4. Envía una respuesta a Treble: Devuelve una respuesta a Treble con la información procesada, como el estado de autenticación del usuario. La respuesta debe ser un JSON con el siguiente formato:

   Copy

   Ask AI

    {
        "user_session_keys":[
            {
                "key":"servidor_usuario_valid",
                "value":"si"
            }
        ]
    }
   

Los user_session_keys es un arreglo de objetos que contiene la clave y el valor de la respuesta. Para este ejemplo, la clave debe ser servidor_usuario_valid y el valor debe ser si si el usuario existe o no si no existe. Sin embargo, puedes enviar de regreso a Treble cualquier información que necesites para continuar la conversación. Dicha respuesta puede contener mas variables que se puedan usar en el flujo.

Ejemplo:

{
    "user_session_keys":[
        {
            "key":"nombre_usuario",
            "value":"Juan Perez"
        },
        {
            "key":"fecha_ultima_compra",
            "value":"2025-01-01"
        }
    ]
}

​

Ejemplo de Código

Aquí tienes un ejemplo básico de cómo podrías implementar esto en Node.js:

const express = require('express');
const app = express();
app.use(express.json());

app.post('/webhook', (req, res) => {
    // Extrae la identificación del usuario de los user_session_keys
    const identificacion = req.body.user_session_keys.find(key => key.key === 'id_cliente')?.value;

    // Simula la verificación del usuario
    const usuarioExiste = verificarUsuario(identificacion);

    // Prepara la respuesta para Treble
    const resp_servidor = usuarioExiste ? 'si' : 'no';

    // Envía la respuesta de vuelta a Treble con la estructura correcta
    res.json({
        user_session_keys: [
            {
                key: "servidor_usuario_valid",
                value: resp_servidor
            }
        ]
    });
});

function verificarUsuario(identificacion) {
    // Lógica para verificar si el usuario existe
    // Aquí puedes consultar una base de datos o un servicio externo
    return identificacion === '12345'; // Ejemplo de verificación
}

app.listen(3000, () => {
    console.log('Servidor escuchando en el puerto 3000');
});

5. De regreso en tu conversación (flujo) en Treble, conectamos un bloque de condiciones para evaluar la respuesta del servidor. Nota como la variable servidor_usuario_valid es una variable de sesión que se guarda en el flujo y es la respuesta que se envía al servidor. El bloque de condiciones es un bloque de tipo “Si” y evalua si la variable servidor_usuario_valid es igual a si. Si es así, se continúa por el camino de usuario autenticado. Si no, se continúa por otro camino.

​

Ten en cuenta

• Debes configurar el webhook de respuesta para cada respuesta (flecha ) que sale de un bloque de mensaje. Si lo configuras en una única respuesta o la primera, únicamente se activará para la primera respuesta.

En la siguiente imagen, se ve cómo debes configurar el webhook de respuesta para cada una de las 3 respuestas que salen de un bloque de mensaje.