Visão geral de automação — Zapier, MCP e webhooks
Compare conectores privados do Zapier, ferramentas MCP delegadas por OAuth, webhooks de projeto assinados e orquestração de API REST, com pré-requisitos de implantação e limitações.
Escolha a superfície de automação correta#
PDFHQ oferece diferentes superfícies de integração em vez de um único endpoint REST chamado Zapier ou MCP. A API de tarefas alimenta o processamento; webhooks de projeto entregam eventos; um aplicativo CLI da Plataforma Zapier não publicado envolve operações REST permitidas; MCP expõe ferramentas OAuth delegadas para agentes de IA.
API direta: tarefa documentada, envio, rotas de IA e assinatura são acessíveis com as credenciais apropriadas e permissões de conta. Zapier: a origem está disponível em integrations/zapier mas não há aplicativo publicado. PCM: servidor local existe; OAuth hospedado é staging gated e não certificado público. Webhooks: endpoints de origem existem mas retornam 503 a menos que habilitados por um operador após configuração e teste.
Exemplo: trabalho PDF → webhook → automação#
Primeiro envie uma tarefa PDF de propriedade do projeto usando o ciclo de vida normal da API. Inscreva-se no evento concluído apenas após sua implantação ter ativado webhooks de cliente, criptografia e o worker de entrega. Armazene o segredo de assinatura retornado uma vez; verifique a carga útil bruta exata e rejeite repetição antes de acionar automação downstream.
# Staging only: project API key stored on your server.
curl -X POST 'https://api.pdfhq.io/v1/webhooks' \
-H 'x-api-key: YOUR_PROJECT_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"target_url":"https://your-app.example/events/pdfhq","events":["pdf.job.succeeded","ai.job.succeeded"]}'
# The first response includes a one-time HMAC signing secret.
# Verify X-PDFHQ-Webhook-Timestamp and X-PDFHQ-Webhook-Signature: v1=...;
# reject old messages and deduplicate on the event ID.O payload do webhook contém metadados, não bytes de PDF ou links de download assinados. Recupere qualquer resultado permitido independentemente através de APIs PDFHQ autenticadas. A entrega é pelo menos uma vez, portanto os consumidores devem lidar com duplicatas.
Eventos webhook, verificação, tentativas e repetição →Zapier: fonte de aplicativo privado#
A autenticação por chave de projeto permite acionadores e ações de trabalhos PDF/IA, com REST Hooks assinados para eventos de projeto suportados e fallback de consulta. Um documento autorizado já deve ter sido enviado através do fluxo de upload selado. O aplicativo só pode preparar rascunhos de assinatura sandbox não enviados; não pode enviar convites ao vivo.
cd integrations/zapier
npm install
npm test
npx zapier-platform validateValide o conector com uma conta de desenvolvedor Zapier e API de staging antes de publicar qualquer coisa. Este repositório não contém uma listagem pública do Zapier ou um link de instalação em um clique.
Acionadores, ações e limitações do Zapier →MCP: acesso delegado de agente de IA#
O MCP utiliza Código de Autorização HQTools OAuth + PKCE e âmbitos PDFHQ verificados por audiência. Não é uma variante de chave de API do Zapier e não recebe webhooks. O stdio local pode ser testado com um token de curta duração obtido separadamente; alojar um servidor MCP remoto requer configuração do operador, PKCE e aceitação de ciclo de vida.
https://mcp.pdfhq.io/mcpAs ferramentas permitidas incluem status/envio de trabalho PDF, cotações/trabalhos de IA e status de assinatura limitado. Redação, exclusão, envio de assinatura ao vivo e administração de credenciais são deliberadamente excluídos de ferramentas autônomas. A execução de IA continua através das regras de crédito e consentimento do HQTools.
Escopos OAuth do MCP e configuração de staging →Outros sistemas de fluxo de trabalho#
Os conectores nativos Make e n8n não estão implementados ou publicados. Seus módulos HTTP podem chamar operações REST documentadas, e endpoints HTTPS compatíveis podem receber webhooks de projeto uma vez habilitados. Não configure fluxos de trabalho de produção até que autenticação de projeto, assinaturas de evento, faturamento e tentativas passem em testes conectados.
Comece com o guia rápido de tarefas REST →