La app de Zapier usa OAuth y los mismos contratos REST, de capacidades y webhooks que una integración propia.
Autenticación
Conecta la cuenta mediante OAuth de HQTools. Los grants tienen scopes y son revocables; la acción de conversión incluye File write porque una conversión simple crea primero un File de entrada propio.
Acciones
Convierte Files, crea y gestiona Jobs, ejecuta Workflows, estima conversiones y crea URLs firmadas. Los campos dinámicos proceden del grafo de capabilities.
Triggers instantáneos
Éxitos y fallos de Job/conversión llegan por el sistema durable de webhooks. La entrega es al menos una vez; deduplica efectos sensibles.
Datos de Workflow
Run Workflow acepta variables validadas, metadata y client_reference_id. Asigna el identificador estable del evento de origen a business_event_id. ConverterHQ convierte esa identidad en la clave de idempotencia, de modo que un reintento de transporte reutiliza el run previsto y un evento posterior crea trabajo nuevo.
Operar un Zap
Convert a File vuelve a intentar una conversión que sigue procesándose con la misma identidad business_event_id en vez de entregar un resultado incompleto al siguiente paso. Para flujos largos y fan-out, el trigger webhook de finalización es el límite preferido antes de los pasos posteriores.