Die ConverterHQ-Zapier-App nutzt OAuth und dieselben REST-, Capability- und Webhook-Verträge wie eigene Integrationen.
Authentifizierung
Verbinden Sie das Konto über HQTools OAuth. Grants sind scoped und widerrufbar; Konvertierungsaktionen enthalten File-write, weil eine einfache Konvertierung zunächst ein eigenes Input-File erstellt.
Actions
Konvertieren Sie Files, erstellen/verwalten Jobs, führen Workflows aus, schätzen Konvertierungen und erstellen signierte URLs. Dynamische Felder stammen aus dem Capability-Graph.
Instant Triggers
Job-/Konvertierungs-Erfolg und -Fehler werden über das dauerhafte Webhook-System geliefert. Delivery ist at-least-once; deduplizieren Sie sensible Side Effects.
Workflow-Daten
Run Workflow akzeptiert validierte Variablen, Metadata und client_reference_id. Ordnen Sie die stabile Quellereignis-ID dem Feld business_event_id zu. ConverterHQ hasht diese Geschäftsidentität in den Idempotency-Key, sodass Transport-Retries denselben Run wiederverwenden und spätere Ereignisse neue Arbeit erzeugen.
Zap betreiben
Convert a File wiederholt eine noch laufende Konvertierung mit derselben business_event_id-Identität, statt ein unfertiges Ergebnis an den nächsten Schritt zu geben. Für lange Fan-out-Workflows ist der Completion-Webhook-Trigger die bevorzugte Grenze vor nachgelagerten Schritten.