Inicia un workflow desde un webhook
Da a otro sistema la dirección y el secreto del workflow; cada POST con JSON arranca una ejecución, y una Idempotency-Key evita duplicados.
Administradores de la cuenta: «Propietario», «Superadministrador» y «Administrador». El resto del equipo puede abrir los workflows públicos y su historial, pero no cambiarlos ni lanzarlos.
Workflows aún no está abierto en Filmo: la barra lateral lo muestra como próximamente y sus páginas no se pueden abrir. Este artículo describe cómo funciona cuando esté disponible en tu cuenta.
A veces el punto de partida está fuera de Filmo: un formulario de tu web, una herramienta de reservas o un script propio.
El da al workflow su propia dirección. Cuando otro sistema le envía una petición POST con JSON, junto con el secreto del workflow, el workflow arranca con el cuerpo de la petición como datos.
Conecta otro sistema
- Elige el disparador «Webhook» En el bloque del disparador, o en «Configura un trigger» al crear el workflow.
- Copia la dirección y el secreto Usa «Copiar endpoint» y «Copiar secreto». Los dos se crearon con el workflow y no cambian al publicar.
- Configura el emisor Envía los datos como JSON y el secreto en la cabecera X-Webhook-Secret, o como Authorization: Bearer.
- Publica y activa La dirección solo acepta peticiones mientras el workflow está en .
- Envía una primera petición Es una real. Comprueba el resultado en la pestaña «Runs».
Atención: Trata el secreto como una contraseña: con él y la dirección, cualquiera puede arrancar el workflow. Cualquier miembro del equipo que pueda abrir un workflow público también puede verlos, así que hazlo privado si eso importa.
Evita ejecuciones duplicadas
Si el emisor puede enviar la misma petición dos veces, haz que añada la cabecera . Una segunda entrega con la misma clave devuelve la ejecución ya creada en lugar de crear otra. Sin esa cabecera, cada entrega crea una ejecución.
Límites
- El cuerpo de la petición puede ocupar hasta 256 KB.
- Cada dirección acepta hasta 60 peticiones por minuto.
- Una Idempotency-Key puede tener hasta 255 caracteres.
Qué responde la dirección
| Respuesta | Cuándo |
|---|---|
| 202, con el identificador de la ejecución | La petición se aceptó y quedó en cola. |
| 200, con duplicate: true | La Idempotency-Key ya se había usado; devuelve la ejecución existente. |
| 401 | Falta el secreto o no coincide. |
| 404 | La dirección no existe, el disparador ya no es un webhook o el workflow no está en «Live». |
| 409 | El workflow no tiene versión publicada. |
| 400 | El cuerpo no es JSON, o la Idempotency-Key supera los 255 caracteres. |
| 413 | El cuerpo supera los 256 KB. |
| 429 | Más de 60 peticiones en un minuto a la misma dirección. |
Conviene saber
- Si cambias el disparador a otro tipo, o pausas el workflow, la dirección deja de aceptar peticiones.
- Para lanzar un workflow desde tu propio software con una clave de API, consulta la API pública en Ejecuta un workflow manualmente.