La acción Enviar HTTP Request permite conectar tus plantillas flexibles de workflow con sistemas externos.
Cada vez que ocurra el evento configurado en tu automatización, Buk enviará automáticamente una request HTTP al endpoint que tú definas, con el método, autenticación y datos que necesites.
Esta acción está disponible solo en plantillas de tipo Flexible, igual que el resto de acciones de automatización.
¿Para qué sirve Enviar HTTP Request?
Esta acción te permite integrar Buk con otros sistemas que utilicen APIs.
Por ejemplo, puedes:
Avisar a un sistema externo cuando un colaborador cambió de área.
Mantener actualizadas bases de datos o sistemas internos.
Notificar a herramientas externas de onboarding o IT.
Enviar información relevante cada vez que se crea o modifica un trabajo.
En simple: cada vez que tu automatización se gatille, Buk enviará información al sistema externo que tú elijas. También puedes configurar la acción en plantillas manuales (no automáticas)
¿Qué necesitas antes?
Tener Workflow y API habilitado (Exclusivos con el plan Plataforma Pro)
Tener el permiso Workflow > Plantillas y Solicitudes en Modificación
Tener permiso de API> Accesos API > Webhooks en Si
Contar con el endpoint externo al que quieras enviar la información y saber qué método, autenticación y formato requiere.
¿Cómo configurar la acción Enviar HTTP Request?
Dentro de la etapa final de tu plantilla flexible:
1. Selecciona la acción
Haz clic en Añadir acción y elige Enviar Request HTTP.
Aparecerá un modal con los campos necesarios para configurar la request.
2. Configura el método y la URL
Método HTTP: selecciona el método que tu sistema externo necesite:
GET
POST
PUT
PATCH
DELETE
URL: escribe la dirección del endpoint externo al que enviaremos la request. Ejemplo de formato: https://tudominio.cl
Esta request se enviará automáticamente cada vez que el evento de la automatización se active.
3. Define el tipo de autenticación (opcional según tu API)
En la pestaña Auth, elige cómo se autenticará tu request:
Sin autenticación
Basic Auth (usuario + contraseña)
Bearer Token
API Key (incluida en header o en parámetros de la URL, segun lo que requiera tu API externa)
Completa los campos según lo que solicite el servicio externo.
4. Construye el Body (contenido del mensaje)
En la pestaña Body puedes definir el contenido que Buk enviará en la request.
URL del tenant
Fecha
Tipo de evento
Estado de empleo
ID del colaborador
Nombre completo
Email corporativo
RUT / DNI / RFC / CPF según país
Nombre de la empresa
ID del área
Cargo
ID del workflow
Estos valores se completarán automáticamente según el colaborador y la solicitud que gatilló la automatización.
Por ahora, so se puede escribir texto libre ni agregar campos personalizados: el conjunto de campos está definido.
Body JSON:
Los campos disponibles en el Body son:
- **tenant_url**: URL del tenant
- **date**: Fecha
- **event_type**: Tipo de evento
- **employment_status**: Estado de empleo
- **employee** (datos del colaborador):
- **employee_id**: ID del colaborador
- **full_name**: Nombre completo
- **email_corporate**: Email corporativo
- **rut** (u otro identificador según país)
- **organization** (datos de la organización):
- **company_name**: Nombre de la empresa
- **area_id**: ID del área
- **job_role**: Cargo
- **metadata**:
- **workflow_id**: ID del workflow
Un ejemplo de body JSON es:
```json
{
"tenant_url": "chile",
"date": "2025-12-11T13:28:51-03:00",
"event_type": "workflow_action",
"employment_status": "activo",
"employee": {
"employee_id": 2758,
"full_name": "Rodrigo Contreras",
"email_corporate": "rodrigo@correo.cl",
"rut": "20.202.020-2"
},
"organization": {
"company_name": "LRE MEDIPASS-INTEGRAMDEDICA",
"area_id": 200,
"job_role": "Product Owner"
},
"metadata": {
"workflow_id": 2292
}
}
¿Qué ocurre al ejecutarse la automatización?
Cada vez que el evento configurado se cumpla, Buk enviará automáticamente la request con:
El método seleccionado
La URL definida
La autenticación elegida
Los valores del body completados con la información del colaborador, la organización y el workflow
Si la request falla (por ejemplo, por un endpoint caído o un error de autenticación), la solicitud flexible mostrará el estado Error en su ejecución, indicando que la acción externa no pudo completarse.
Buenas prácticas
Verifica que la API externa acepte el método seleccionado.
Asegúrate de que tu API externa pueda trabajar con el formato de datos que envía Buk
Prueba tu endpoint con herramientas externas antes de configurarlo en Buk.
Mantén tus tokens o credenciales actualizados para evitar errores de autenticación.