Los nodos activadores de webhook permiten que los sistemas externos se comuniquen con SleekFlow enviando datos para iniciar flujos. Al usar un activador relacionado con webhooks, puedes inscribir contactos en un flujo automáticamente cuando SleekFlow recibe una solicitud de webhook que coincide con tu configuración.
ℹ️ Obtén más información sobre los activadores de flujo en este artículo: Descripción general de los activadores de flujo
Esto es especialmente útil para integrarte con plataformas de terceros, sistemas internos o herramientas personalizadas que necesitan activar flujos de trabajo en SleekFlow en tiempo real.
Carga útil de webhook recibida
⚠️ El activador “Carga útil de webhook recibida” solo está disponible para los usuarios de los planes Premium y Enterprise.
El activador “Carga útil de webhook recibida” te permite inscribir contactos en un flujo cuando SleekFlow recibe un webhook entrante que coincide con la configuración establecida en el formulario del nodo activador.
Configura el formulario del nodo activador “Carga útil de webhook recibida” siguiendo estos pasos:
- Selecciona el nodo activador de webhook recibido
- Configura tu webhook
- Especifica el identificador de contacto
Configurar el nodo activador “Carga útil de webhook recibida”
- Haz clic en el nodo activador Carga útil de webhook recibida para abrir su formulario, que aparecerá en el lado derecho de la pantalla
- El formulario del nodo contiene los siguientes campos para configurar el activador.
- Pestaña Configuración
- Esta sección proporciona toda la información que necesitas para conectar tu sistema externo a SleekFlow. Cuando se configura correctamente, permite que SleekFlow reciba una solicitud de webhook e inscriba al contacto correspondiente en el flujo.
- URL del webhook: esta es la URL a la que tu sistema externo debe enviar el webhook para que SleekFlow lo reciba
- ID del activador de webhook: este ID permite que el sistema de SleekFlow asocie el webhook con el flujo, lo que garantiza que los contactos se inscriban correctamente. Inclúyelo en el encabezado del webhook
- Token de webhook: esto permite que el sistema de SleekFlow verifique que el webhook proviene de ti. Inclúyelo en el encabezado del webhook
- Solicitud POST de ejemplo del webhook: se proporciona un ejemplo prellenado que puedes usar para hacer pruebas o como referencia durante la implementación.
Especifica el identificador del cliente
En la sección “Información de configuración”, también encontrarás la sección “Identificador del cliente”. Esta sección te permite configurar cómo el sistema asociará los webhooks que recibe con los contactos correspondientes que se inscriben en el flujo.
Esta sección tiene 2 campos que debes completar:
- Tipo de identificador: este menú desplegable te permite seleccionar con qué propiedad de contacto el sistema comparará el identificador de contacto especificado dentro de los registros de contacto de tu cuenta de SleekFlow. Elige entre 3 opciones:
- ID de contacto (es decir, el UUID único de cada contacto proporcionado por SleekFlow)
- Número de teléfono
- Correo electrónico
💡Nota sobre contactos inexistentes:
Puede haber casos en los que el identificador de contacto proporcionado en la carga útil JSON del webhook no corresponda a un contacto existente en tu cuenta de SleekFlow.
Cuando seleccionas “Número de teléfono” o “Correo electrónico” como “Tipo de identificador”, se proporciona una opción adicional (“Inscripción de nuevo cliente”) para gestionar estos casos.
Si “Inscripción de nuevo cliente” está activada, cuando un número de teléfono o correo electrónico proporcionado en la carga útil del webhook no coincida con ningún contacto existente en SleekFlow, se creará automáticamente un nuevo registro de contacto con el identificador de contacto proporcionado. Ese contacto recién creado se inscribirá luego en el flujo.
- Clave de la carga útil de contacto: este campo te permite especificar qué variable dentro de la carga útil JSON del webhook recibida por el sistema debe usarse para comparar con los registros de contacto en SleekFlow. Te recomendamos usar una variable que sea un identificador único de contacto, por ejemplo, el ID de contacto, el número de teléfono o el correo electrónico. Usa la notación de punto JSON aquí para especificar qué campo de la carga útil del webhook debe extraer y referenciar el sistema.
💡Explicación de la notación de punto JSON
La notación de punto JSON es una forma de especificar un campo o valor determinado dentro de una estructura de datos anidada como JSON. Te permite recorrer la estructura indicando la ruta hacia el campo deseado mediante claves separadas por puntos.
Formato:
La notación de punto JSON comienza con $., seguido de todos los nombres de campo en orden secuencial para recorrer la estructura de datos anidada hasta llegar al campo deseado. Cada nombre de campo especificado en la notación se separa con un punto (por ejemplo, $.clave1.clave2.clave3)
Ejemplo:
Para la carga útil que se muestra a continuación, el campo del número de teléfono se representaría con la notación de punto JSON de la siguiente manera: $.data.profile.phone
{
"data": {
"id": "12345",
"name": "Bob Chan",
"profile": {
"email": "bob@sleekflow.io",
"phone": "85298007899"
}
}
Pega una carga útil de respuesta de ejemplo
Después de configurar tu webhook y especificar el identificador de contacto, puedes ir a la pestaña “Variable”. En esta pestaña defines cómo SleekFlow debe interpretar y extraer los datos de la carga útil del webhook entrante. Te permite obtener una vista previa y configurar las variables que se pueden usar en todo tu flujo.
Guía paso a paso:
- Pega una carga útil JSON de ejemplo
Copia una carga útil representativa de la solicitud de webhook desde tu sistema externo y pégala en el cuadro de texto proporcionado. Debe ser un objeto JSON sin procesar que refleje la estructura y el contenido que tu sistema enviará realmente cuando se active el webhook.
⚠️ Los datos que pegues aquí se usan únicamente para analizar las rutas de las variables y no se almacenarán en SleekFlow después del análisis.
- Haz clic en “Analizar datos”
Una vez que hayas pegado tu JSON, haz clic en el botón Analizar datos. SleekFlow extraerá automáticamente todos los campos de nivel superior y anidados de la carga útil, y los convertirá en variables utilizables.
- Usa las variables analizadas
Después del análisis, estas variables estarán disponibles en todo tu flujo. Podrás hacer referencia a ellas en plantillas de mensajes, ramas de condición o cualquier otro nodo que admita variables dinámicas.