Logo PDFHQ

Documentos

DocumentaçãoAutomação e integrações

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.

Chaves de API do lado do servidor Uploads de armazenamento assinado

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.

Veja a visão geral de integração visual →

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.

Crie uma subscrição de webhook privada
# 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.

Validação offline (antes da configuração privada do Zapier CLI)
cd integrations/zapier
npm install
npm test
npx zapier-platform validate

Valide 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.

Alvo de implantação MCP remoto — não é uma afirmação de conexão ativa
https://mcp.pdfhq.io/mcp

As 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 →
Logo PDFHQ

Ferramentas PDF e inteligência de documentos. Prepare, compreenda e trabalhe com seus documentos.

© 2026 PDFHQ. Todos os direitos reservados.