Cómo configurar la acción de envío de Webhook

Paso 1: Accediendo al módulo de administración de automatizaciones

En el menú lateral inferior izquierdo, haz clic en “Automatizaciones” para visualizar la lista.

Paso 2: Creando o editando una automatización

Haz clic en “Nueva Automatización” para crear una regla o selecciona una automatización existente para editar.

Paso 3: Definiendo entidad y evento

Selecciona la Entidad que será monitoreada (ej.: Pipeline Cards, Database Records, Tarefas o Usuários) y elige el Evento que activará la automatización:

• Crear
• Actualizar
• Eliminar
• Mover
• Tarea completada
• Todas las tareas completadas Cada entidad tiene eventos propios que pueden utilizarse según el contexto.

Paso 4: Seleccionando la acción

En el campo “Acción”, selecciona “Disparar Webhook”.

Paso 5: Aplicando condiciones (opcional)

Si es necesario, agrega condiciones para restringir cuándo se debe ejecutar el webhook. Configura:

• Campo
• Operador
• Valor

Paso 6: Configurando el Webhook

En la sección “Configuraciones”, completa los siguientes campos:

• Method: selecciona el método HTTP (GET, POST, PUT, DELETE).
• Endpoint: ingresa la URL del servicio externo que recibirá los datos.
• Headers: agrega encabezados de autenticación o parámetros adicionales si es necesario.
• Body: define el cuerpo de la solicitud. Puedes usar texto, JSON u otras estructuras.

Puedes utilizar variables dinámicas representadas por el ícono (x) junto al campo para personalizar automáticamente el contenido, incluyendo información como nombre del cliente, responsable del card o número de pedido.

Paso 7: Guardando la automatización

Después de revisar, haz clic en “Crear Automatización”. La regla quedará activa y ejecutará el webhook siempre que se cumplan el evento y las condiciones.

Buenas prácticas:

• Prueba el endpoint con herramientas como Postman antes de integrarlo.
• Utiliza variables para enviar datos dinámicos en el body.
• Configura headers de autenticación para conexiones seguras.
• Monitorea los logs del sistema externo para validar la recepción.

Conclusión:

Has aprendido cómo configurar la acción de Webhook en una automatización, definiendo método, endpoint, headers y body, además del uso de variables dinámicas. Este recurso amplía las posibilidades de integración de octapipe con sistemas externos. Si tienes alguna duda, contacta a nuestro equipo de soporte.