¿Qué es la acción Enviar HTTP Request?
Enviar HTTP Request es una acción de las plantillas de Workflow que permite que Buk se comunique automáticamente con sistemas externos (por ejemplo, otros softwares o plataformas internas) cada vez que se gatilla una solicitud de esa plantilla, que puede ser de manera manual o automática según como lo configures.
En simple: cuando una automatización o una solicitud se ejecuta (por ejemplo, un alta, baja o movimiento de trabajo), Buk puede enviar información básica del colaborador y de la empresa a otro sistema para avisar que ocurrió ese cambio.
Esto permite, por ejemplo, actualizar sistemas internos, sincronizar datos de personas, disparar procesos en herramientas de TI o RR. HH., registrar eventos en sistemas externos o mantener integradas distintas plataformas, sin que nadie tenga que hacerlo manualmente.
Esta acción está pensada para integraciones técnicas. Su configuración debe realizarse junto al equipo de TI o el área experta de tu organización, responsable del sistema externo y de su seguridad.
Buk no configura ni valida sistemas externos, ya que estos dependen de la infraestructura, reglas y definiciones de cada empresa.
Esta acción está disponible solo en plantillas de tipo Flexible, tanto en automatizaciones como en plantillas manuales.
¿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.