O app do Zapier usa OAuth e os mesmos contratos REST, capabilities e webhooks de integrações próprias.
Autenticação
Conecte a conta via OAuth do HQTools. Grants têm scopes e são revogáveis; a ação de conversão inclui File write porque uma conversão simples primeiro cria um File de entrada próprio.
Ações
Converta Files, crie e gerencie Jobs, execute Workflows, estime conversões e crie URLs assinadas. Campos dinâmicos vêm do grafo de capabilities.
Triggers instantâneos
Sucessos e falhas de Job/conversão chegam pelo sistema durável de webhooks. A entrega é pelo menos uma vez; deduplique efeitos sensíveis.
Dados de Workflow
Run Workflow aceita variáveis validadas, metadata e client_reference_id. Mapeie o identificador estável do evento de origem para business_event_id. ConverterHQ transforma essa identidade na chave de idempotência, assim retries de transporte reutilizam o run pretendido e eventos posteriores criam novo trabalho.
Operar um Zap
Convert a File repete uma conversão ainda em processamento com a mesma identidade business_event_id, em vez de entregar um resultado incompleto ao próximo passo. Para workflows longos e fan-out, prefira o trigger webhook de conclusão antes das etapas seguintes.