Guías
Enviar cambios a tu propio sistema
La API no tiene webhooks. Para mantener otro sistema sincronizado con Filmo sin sondeos, deja que un workflow llame a tu endpoint cuando ocurra algo.
Antes de empezar
Nada de esto es una plantilla: usa un trigger de evento y un paso HTTP. Todos los datos son ficticios y el endpoint está en un dominio de ejemplo reservado. Sustitúyelo por el tuyo.
Constrúyelo
Enlace a esta sección: ConstrúyeloCrea el workflow
«Nuevo workflow», «Configura un trigger». En la paleta, en «Filmo», abre Pedidos y elige el evento "Pedido reservado".
Añade un filtro para tus propias escrituras
En el trigger, define «Solo cuando»: Origen «es distinto de» API. Sin él, un pedido que reservas por la API REST dispara este workflow, que publica de vuelta en tu sistema, que puede volver a escribir. El filtro es una sola condición, así que no puede excluir también MCP, y un cambio hecho en la app no lleva origen: haz una prueba desde la app y comprueba en el visor de runs que el filtro la deja pasar.
Añade el paso HTTP
Sumar «Enviar petición HTTP». Método POST, URL
https://. En el cuerpo, construye un objeto con los campos que necesites e inserta las variables del trigger: el número de pedido, el estado, el contacto y las fechas.example. com /filmo-hook Declara la respuesta
En Respuesta, declara una estructura con el campo que devuelve tu endpoint (por ejemplo
received, true/false). Una respuesta que no coincida hace fallar el paso, que es lo que quieres si tu sistema responde con una página de error.Publicar y activar
«Publicar y activar». A partir de ahora, cada pedido que se reserve envía una petición.
Qué recibe tu endpoint
Enlace a esta sección: Qué recibe tu endpoint{
"event": "order.reserved",
"orderNumber": "P-2026-0042",
"status": "reserved",
"customer": "Example Productions",
"startsAt": "2026-10-20T08:00:00.000Z",
"endsAt": "2026-10-22T18:00:00.000Z"
}La petición es un POST con Content-Type: application, un User-Agent de filmo-workflows y una cabecera Idempotency-Key formada a partir de la ejecución y el paso.
Haz que tu endpoint sea seguro de repetir
Enlace a esta sección: Haz que tu endpoint sea seguro de repetir- Filmo puede enviar una petición dos veces si un worker muere después de la llamada y antes de registrar el paso. Trata la
Idempotency-Keycomo la clave de la petición: si ya la has visto, responde 2xx sin volver a hacer el trabajo. - Tu endpoint tiene que ser accesible desde internet público: las direcciones privadas están bloqueadas (consulta la página de peticiones HTTP).
- Responde rápido. El paso se rinde tras 15 segundos sin actividad.
- Una respuesta que no sea 2xx hace fallar el run, y Filmo no reintenta la petición por sí solo. Fíjate en el aviso de fallo, corrige tu endpoint y pulsa Reintentar en el run: vuelve a enviar, desde el paso que falló.
- Si el resto del workflow debe continuar aunque tu sistema esté caído, pon el paso HTTP dentro de un paso Intentar. Después, comprueba el resultado del Intentar y, si falló, crea una tarea o avisa a alguien con el mensaje de error. Sin esa comprobación el fallo es silencioso. Consulta el paso Intentar.
Pon un secreto en una cabecera solo si aceptas que cualquiera que pueda abrir el workflow puede leerlo, y que aparece en todas las versiones (los administradores todavía pueden abrir un workflow privado). Haz el workflow privado y usa un token que solo funcione para este endpoint.
Cuando también necesitas lo contrario
Enlace a esta sección: Cuando también necesitas lo contrarioPara iniciar un workflow desde tu sistema, consulta Iniciar un workflow desde tu propio sistema. Para leer datos en bloque, o para recoger lo que se le escapó a un push, usa la API como se describe en Sincronizar datos.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasConstruir
Peticiones HTTP
El paso HTTP llama a una URL desde una ejecución: para enviar un cambio a tu propio sistema, o para leer de uno. Es deliberadamente simple, y esa simplicidad tiene consecuencias que conviene conocer antes de construir sobre él.
Construir
Triggers
Un trigger decide cuándo se ejecuta un workflow. Cada workflow tiene exactamente uno, y puedes cambiarlo en el editor en cualquier momento (hasta que publiques, nada cambia para las ejecuciones).
Guías
Sincronizar datos
Filmo v1 no envía webhooks, así que mantienes otro sistema sincronizado consultando periódicamente: lee lo que cambió en ventanas de tiempo semiabiertas y ejecuta un barrido aparte para encontrar lo que se eliminó. No sigas el cursor de paginación para decidir qué cambió o qué desapareció.
¿Te ha resultado útil esta página?