Integraciones
Envía un webhook o llama a una API desde una automatización.
Última actualización el
Estos pasos están en el grupo Integraciones. Una entrega fallida continúa por Fallido. Para las demás acciones, lee Cuando un paso falla.
Enviar webhook
Entrega un mensaje propio a uno de los endpoints de webhook de tu organización. Es útil para avisar a otro sistema, por ejemplo tu sistema de caja o tu sitio web.
| Campo | Qué rellenas |
|---|---|
| Endpoint | Elige uno de tus endpoints de webhook. Los reconoces por su dirección. Obligatorio |
| Nombre del evento | El nombre que acompaña al mensaje para que el destinatario lo reconozca, por ejemplo automation.invoice_unpaid. Obligatorio |
| Carga útil | El contenido del mensaje, como JSON. Las variables se rellenan antes de enviar el mensaje. Obligatorio |
Los endpoints los creas y gestionas en el menú del perfil, en Desarrolladores. El endpoint debe existir y estar activado. Si no es así, el paso falla y la ejecución se detiene.
El mensaje se firma con la clave propia del endpoint, igual que los demás webhooks que recibe el endpoint. Tillor lo intenta varias veces más si tu servidor no responde correctamente. El endpoint no tiene que seguir el nombre de tu evento: el mensaje llega de todos modos.
El paso tiene dos salidas:
| Salida | Cuándo |
|---|---|
| Correcto | Tu servidor respondió con un estado de éxito |
| Fallido | La entrega falló tras todos los intentos. Después, el mensaje se sigue intentando en segundo plano, igual que un webhook normal |
La plantilla Enviar reservas a otro sistema usa Fallido para crear una tarea y que alguien se ocupe.
Una carga útil puede verse así:
{
"reservation": "{reservation.displayId}",
"checkIn": "{reservation.checkIn}",
"adults": {reservation.numberOfAdults},
"customer": {
"firstName": "{reservation.customer.firstName}",
"email": "{reservation.customer.email}"
}
}Pon el texto entre comillas y los números sin comillas. Las fechas pasan en JSON como fecha y hora internacionales, por ejemplo 2026-10-05T08:00:00.000Z. Lee Variables y plantillas para los detalles. La parte técnica, como la estructura del mensaje, está en Desarrolladores > Automatizaciones.
Solicitud a una API
Llama a la API de Tillor de tu propia organización, o a otra dirección de internet. Con ello puedes hacer casi todo lo que hace Tillor, y buscar datos para usarlos después.
En Enviar a eliges entre Tillor API y URL personalizada. En Método eliges GET (consultar), POST (crear), PUT o PATCH (modificar) o DELETE (eliminar).
Tillor API
| Campo | Qué rellenas |
|---|---|
| Ruta | La parte de la dirección que va después de la API de tu organización, por ejemplo /tasks o /tasks/{task.id}. Debe empezar por /. Obligatorio |
| Cuerpo | Los datos que envías, como JSON. Déjalo vacío si no envías nada |
Encima del campo está Elige un endpoint de la API. Haz clic y busca en la lista, por ejemplo tasks. Al elegir un endpoint, Tillor rellena el método y la ruta. Si el Cuerpo aún está vacío, también obtienes un ejemplo de lo que espera el endpoint. Sustituye los nombres entre llaves de la ruta por variables de pasos anteriores. Si hay parámetros de consulta, los ves debajo del campo.
La llamada se hace como el usuario Flujo de trabajo y nunca puede salir de tu propia organización. Una automatización no puede gestionar automatizaciones, así que se rechazan las llamadas que afecten a automatizaciones o a sus ejecuciones.
URL personalizada
| Campo | Qué rellenas |
|---|---|
| URL | La dirección. Debe empezar por https://. Obligatorio |
| Cabeceras | Datos adicionales para el destinatario, por ejemplo una clave. Haz clic en Añadir cabecera y rellena el Nombre y el Valor |
| Cuerpo | Los datos que envías, como JSON. Déjalo vacío si no envías nada |
Se aplican estas reglas:
- Las direcciones sin
https://se rechazan - Las direcciones privadas e internas se rechazan, incluso si un nombre normal apunta a ellas
- No se siguen las redirecciones. Si el servidor responde con una redirección, cuenta como Fallido
- Las cabeceras se guardan cifradas. Por tanto, puedes poner en ellas una clave o un token
- Con GET y DELETE no se envía cuerpo
Salidas y respuesta
La solicitud tiene dos salidas: Correcto (el servidor respondió con un estado de éxito) y Fallido (el servidor respondió con un estado de error). Si Tillor no llega al servidor, por ejemplo por un tiempo de espera agotado tras 15 segundos o una dirección rechazada, la ejecución se detiene con el estado Fallida.
Para los pasos posteriores hay tres variables:
| Variable | Contenido |
|---|---|
{response.status} | El código de estado, por ejemplo 200 |
{response.body} | La respuesta como texto, recortada a los primeros 4000 caracteres |
{response.data} | La respuesta como datos, para que puedas sacar campos de ella con {response.data.items.0.id} |
Cómo usarlo está en Usar una respuesta de API. Un ejemplo completo con una búsqueda está en Revisión de una caravana de alquiler.