Zapier, Make y n8n

• Crea una clave por escenario o Zap, solo con los scopes que necesita (consulta Permisos (scopes)).
• Guarda la clave en el almacén de credenciales o de secretos de la plataforma. No la pegues en un campo del escenario que se muestre en los registros o se exporte con él.
• Haz tu primera llamada a GET /api/v1/account para confirmar que la clave funciona y ver sus scopes.

En Zapier usa una acción de petición HTTP personalizada. En Make usa el módulo HTTP. En n8n usa el nodo HTTP Request. Los ajustes son los mismos en los tres.

Haz que el paso entregue las respuestas 4xx y 5xx a tu escenario en lugar de fallar en silencio, para poder leer el estado, el code del error y Retry-After. Bifurca según code, nunca según detail.

1. 1

   Pide la primera página

   Envía la petición de lista con un limit (el máximo es 500).

2. 2

   Comprobar si hay más

   Lee pagination.hasMore en la respuesta.

3. 3

   Pide la página siguiente

   Mientras sea true, repite la petición con cursor igual a pagination.nextCursor y el mismo limit.

Trata el cursor como opaco. Zapier no tiene un bucle de cursor integrado, así que haz el bucle en un paso de código o con sus herramientas de bucle. Make y n8n tienen iteradores y bucles, y el nodo HTTP Request de n8n tiene una opción de paginación. Pon siempre un número máximo de páginas en el bucle. Consulta Paginación para ver los detalles, y Sincronizar datos para saber cómo leer solo lo que cambió.

Cada clave tiene 120 peticiones por minuto, y las consultas de disponibilidad tienen 30 por minuto aparte. Todos los escenarios que comparten una clave comparten esa cuota, y cada paso HTTP dentro de un bucle es una petición. Cuando se supera un límite, la respuesta es 429 rate_limited con una cabecera Retry-After en segundos. Espera ese tiempo y reintenta la misma petición con la misma clave de idempotencia. Frena los bucles a propósito y usa una clave por escenario para que una ejecución no deje sin cuota a otra. Consulta Límites de peticiones.

Las plataformas reintentan pasos y te permiten volver a ejecutar una ejecución fallida. Sin clave, cada reintento puede crear el registro otra vez. Envía un Idempotency-Key en cada escritura, construido con algo que se mantenga igual para ese registro: el id del registro en el sistema de origen más lo que haces con él (por ejemplo crm-4821-create-contact). Usa una clave distinta para cada registro, nunca una para toda la ejecución. Si vuelves a ejecutar una ejecución tras cambiar los datos, la misma clave con un cuerpo distinto es un 422 idempotency_key_reused, que es la señal para usar una clave nueva. Las claves duran 24 horas. Consulta Idempotencia.

Envía siempre tu propia clave a POST /api/v1/orders/line-items/returns, POST /api/v1/purchase-orders/{purchaseOrderId}/receive, POST /api/v1/treasury/payments y POST /api/v1/workflows/{workflowId}/runs. Un reintento sin ella duplica algo que no se puede deshacer.

Filmo no envía webhooks, pero un workflow de Filmo puede enviar una petición HTTP a una URL cuando ocurre un evento, y Zapier, Make y n8n ofrecen cada uno un trigger que recibe una llamada HTTP entrante. Crea el trigger en la plataforma, copia su URL en el paso de petición HTTP de un workflow de Filmo y pon un secreto en una cabecera de ese paso. El paso no tiene firma. El paso no reintenta, pero la ejecución se intenta hasta tres veces, así que deduplica por la cabecera Idempotency-Key y mantén una lectura programada como fuente de verdad. La petición, sus límites y los campos del evento se describen en Sincronizar datos.

• Ejecuta el escenario con una programación y lee qué ha cambiado, además de esperar una llamada o en lugar de hacerlo.
• Antes de escribir, compara con el valor actual y omite la escritura cuando no cambie nada.
• Marca lo que escribió la integración, por ejemplo con una etiqueta, y haz que el escenario ignore los registros que lleven esa marca.
• Fija un tope de ejecuciones por hora en la plataforma, para que un bucle se detenga solo.
• Revisa los workflows activos de la cuenta antes de activar el escenario (consulta Pruebas).

La primera ejecución de un escenario suele abarcar todo el historial. Leer miles de registros lleva minutos a 120 peticiones por minuto, y cada petición cuenta como una tarea u operación en la mayoría de las plataformas, así que revisa tu plan. Si la primera ejecución escribe en Filmo, cada escritura puede iniciar las automatizaciones de la cuenta, incluidas las que envían emails a los clientes. Pausa antes esas automatizaciones, haz la primera carga con un lote pequeño y solo después ábrela del todo.

Make y n8n también tienen nodos que se conectan a servidores MCP, que permiten a un paso de IA elegir por sí mismo las herramientas de Filmo. El servidor está en https://app.filmo.io/api/v1/mcp. Empieza por la Resumen de MCP, luego los pasos para conectar Make o n8n. Para flujos fijos y predecibles, prefiere los pasos HTTP descritos aquí.