Reaccionar a cambios sin webhooks
La API de Filmo no envía webhooks. Mantén otro sistema al día preguntando qué ha cambiado, o con un workflow.
Un webhook es una forma de que un sistema llame a otro en el momento en que pasa algo, como que se crea un pedido. La API de Filmo no envía webhooks: no llama por su cuenta a tu programa de contabilidad, a tu web ni a tu hoja de cálculo. Hay dos formas de mantener otro sistema al día, y cada una tiene límites que conviene conocer.
Elige cómo reaccionar
| Preguntar a Filmo qué ha cambiado | Que un workflow avise a tu sistema | |
|---|---|---|
| Cómo funciona | El otro sistema pregunta a Filmo, cada pocos minutos, qué ha cambiado desde su última consulta | Un workflow de Filmo envía los datos a una dirección tuya cuando pasa algo |
| Quién lo configura | Quien construye la integración, o una herramienta como Make, n8n o Zapier | Un administrador, en la sección de workflows, más una dirección al otro lado que pueda recibirlo |
| Retraso | Lo que dure el intervalo entre consultas | Normalmente corto, pero sin garantía |
| ¿Es fiable? | Sí, si además lo compara todo de vez en cuando | No: es de mejor esfuerzo, así que mantén también una consulta periódica |
Pregunta a Filmo qué ha cambiado
La mayoría de las listas de la API, entre ellas pedidos, artículos, contactos y facturas, se pueden filtrar por la fecha en que se cambió un registro. El otro sistema recuerda la hora de su última consulta y, en la siguiente, pide lo que cambió después. Se llama sincronización incremental y es como funcionan casi todas las integraciones con Filmo. Hecha sin cuidado, puede perder cambios, porque la fecha del último cambio es una buena guía, pero no perfecta:
- Sale del reloj de la aplicación y puede retroceder un segundo.
- Cambiar una línea de un pedido, o algunas etiquetas, no siempre actualiza la fecha del propio pedido.
- Un cambio puede estar terminando en segundo plano cuando se hace la consulta.
Por eso una integración bien hecha empieza cada consulta un par de minutos antes de donde acabó la anterior, ignora los duplicados que eso trae y lo compara todo de vez en cuando.
Lo que una consulta no te dice
Filmo no avisa de los borrados. Un registro borrado simplemente deja de aparecer, sin dejar rastro. Un pedido que archivas también desaparece de la API como si lo hubieras borrado, y vuelve si lo restauras. Una integración que necesite eliminar cosas por su lado tiene que comparar las listas completas y confirmar cada registro antes de borrar nada.
Que un workflow avise a tu sistema
Un workflow puede empezar cuando pasa algo en Filmo, como que se reserva un pedido, y usar un paso HTTP para enviar el pedido a una dirección que elijas. Necesita una dirección al otro lado que pueda recibirlo, algo que te dan herramientas como Make, n8n y Zapier. La dirección debe ser accesible desde internet: Filmo no llama a direcciones locales ni a direcciones de una red privada. Solo los administradores pueden crear y cambiar workflows. Más sobre workflows.
No es una entrega garantizada
Los eventos lanzan workflows después de guardar el cambio, con el mejor esfuerzo. El paso HTTP no va firmado, así que quien lo recibe no puede comprobar que el mensaje viene de Filmo, y el propio paso no reintenta: si la petición falla, la ejecución termina como fallida y no se reintenta sola; alguien tiene que pulsar Reintentar. La excepción es un paso HTTP dentro de un paso «Intentar»: entonces el fallo queda capturado, la ejecución sigue por el paso siguiente y puedes avisar a alguien o tomar otro camino según el resultado. Solo los errores del propio motor de Filmo se reintentan, hasta tres intentos en total. Usa el workflow para provocar una consulta, no como única forma de enterarte.
Si usas Make, n8n o Zapier
Estas herramientas pueden hacer una consulta programada o recibir lo que envía un workflow. No hace falta programar nada: elige una de las dos formas de arriba dentro de la herramienta.
Para quien construye la integración
La guía de sincronización de datos explica la ventana solapada, cómo tratar los borrados y los pedidos archivados, y cómo evitar reaccionar a tus propios cambios: Mantén los datos sincronizados.
Para enviar datos desde un workflow, consulta cómo funciona el paso de petición HTTP y qué pasa cuando una ejecución falla, incluido cómo seguir tras un paso fallido: Peticiones HTTP y Errores y reintentos.
Recursos relacionados
- Da a cada herramienta su propia clave: Genera una clave de API.
- Cada cuánto puede preguntar una herramienta: Cómo funcionan los límites de uso.
Preguntas frecuentes
Con una consulta cada cinco minutos, en unos cinco minutos más el solape. Con un workflow, normalmente antes, pero sin ninguna promesa.
No. Un asistente pregunta a Filmo cuando le pides algo, así que ve los datos actuales.