O que é e para que serve
Com o n8n, Make ou Zapier, você conecta o PaperOffice AI aos seus outros sistemas. Você utiliza os blocos de construção padrão dessas ferramentas: solicitações HTTP à API REST e webhooks. O n8n também pode se conectar ao servidor MCP do PaperOffice por meio de seu cliente MCP. Os destinos de webhook nos Workflow Agents estão disponíveis apenas a partir do plano Professional.
Como funciona
- Crie uma chave na página Chaves API. Insira-a no nó HTTP como um token Bearer.
- Chame a API REST, por exemplo, para fazer upload ou pesquisar. Consulte a Documentação da API para os endpoints.
- Para receber os resultados, abra Workflow AI → Workflow Agents, edite um agente salvo e escolha a guia Webhooks.
- Clique em Adicionar destino de webhook. Insira o endereço do webhook do n8n, Make ou Zapier como URL de destino.
- Em Send when, escolha Execução concluída com sucesso, Falha na execução ou ambos.
- Para uma revisão humana, seu fluxo cria uma tarefa de revisão e aguarda um webhook. O evento task.completed informa a decisão em Workflow AI → Tarefas Human In The Loop.
Bom saber
- Cada entrega de webhook bem-sucedida é cobrada. Retentativas, eventos de teste e entregas com falha são gratuitos.
- As chamadas de API são cobradas.
- Placeholders como {trigger.pofid} são permitidos no caminho, na consulta e nos cabeçalhos, mas não no nome do host.
- Os webhooks do PaperOffice são assinados no cabeçalho X-PaperOffice-Signature. Verifique-o em seu fluxo.
- Para o Make e o Zapier, utilize os módulos HTTP e webhook deles.