Agregar Webchat ID

La operación Agregar Webchat ID permite asociar un ID de una sesión de webchat a un registro de persona existente en Hablla. Esta acción es el punto central para conectar a un visitante, a menudo anónimo, de su sitio con un perfil de contacto conocido en su CRM.

Cuando un visitante inicia una conversación en el webchat, recibe un ID único de sesión. Si, durante la conversación, ese visitante se identifica (por ejemplo, proporcionando un correo electrónico), puede usar esta operación para vincular permanentemente esa sesión de chat al perfil del contacto.

Esto enriquece el perfil de la persona con todo el historial de conversaciones y permite que los agentes tengan una visión completa del cliente en interacciones futuras.

Cómo Configurar

1. En Hablla Studio, agregue el bloque "Personas" a su flujo de automatización.

2. En el campo "Operación", seleccione la opción "Agregar Webchat ID".

3. En el campo "ID de la Persona" (personId), ingrese el identificador del contacto al cual se asociará el webchat ID.

4. En el campo "Webchat ID", ingrese la variable que contiene el ID de la sesión de chat.

5. En el campo "Conexión", seleccione cuál de sus conexiones de webchat se está usando.

---

Parámetros

Campo	Tipo	¿Obligatorio?	Descripción
ID de la Persona	Texto	✅ Sí	El ID único de la persona (contacto) que será vinculada a la sesión de chat.
Webchat ID	Texto	✅ Sí	El identificador único de la sesión de webchat, generalmente proporcionado por el trigger del chatbot.
Conexión (connections)	Lista de Opciones	✅ Sí	La conexión de webchat específica que originó la conversación.

Exportar a las Hojas de Cálculo

---

Estructura (Usando JSON)

El cuerpo de la petición JSON debe contener el webchat_id de la sesión y la connection correspondiente.

JSON

{
  "webchat_id": "session_uuid_a1b2c3d4e5",
  "connections": [
    "connection_id_xyz987"
  ]
}

---

🚀 Ejemplo de Caso de Uso

Objetivo: Cuando un visitante anónimo en el webchat informa su correo electrónico a un chatbot, identificar el contacto en Hablla y asociar la conversación a su perfil.

1. El flujo del chatbot está programado para pedir el correo electrónico del visitante en un determinado punto de la conversación.

2. Cuando se proporciona el correo electrónico, el chatbot dispara un trigger de "Evento Personalizado" en Hablla, enviando el webchat_id de la sesión y la email recopilada.

3. El flujo en Hablla comienza con este trigger.

4. Use la operación "Buscar Persona por Correo Electrónico" para encontrar el personId correspondiente al correo electrónico recibido.

5. Agregue una Condición (If) para verificar si se encontró una persona.

6. Si es así, agregue el bloque "Personas" con la operación "Agregar Webchat ID".

   • ID de la Persona: Use el ID encontrado en la búsqueda ({{steps.4.result.id}}).

   • Webchat ID: Use el ID proveniente del trigger ({{trigger.body.webchat_id}}).

   • Conexión: Seleccione la conexión de webchat de su sitio.

Con este flujo, transforma una interacción anónima en un punto de contacto registrado en el historial del cliente, permitiendo que cualquier agente que asuma la conversación tenga el contexto completo de la relación de ese cliente con su empresa.