Existe uma peça AI PaperOffice para Activepieces?
Não. Não existe uma peça dedicada. Utilize a peça HTTP, o gatilho Catch Webhook e, se necessário, um passo de código contra a documentaçãoada REST-API e o servidor MCP.
Que chave é necessária?
Gere-a em PaperOffice AI em Conta → API. Para REST, utilize uma chave API (poai_) ou um token de utilizador (po_ut_); para MCP, utilize po_ut_, po_gt_ ou OAuth 2.1. Um e-mail confirmado é suficiente. A API está disponível em todos os planos, incluindo Free.
Isso funciona também com uma instância auto-hospedada?
Sim. Para chamadas à REST-API e ao servidor MCP, o Activepieces necessita apenas de acesso de saída para api.paperoffice.ai e mcp.paperoffice.ai. Para webhooks, a URL do fluxo deve ser publicamente acessível, pois o PaperOffice AI não envia dados para endereços privados.
Como é que o Activepieces sabe que um documento está concluído?
Através de uma subscrição de webhook, a partir do Professional. Subscra o evento document.processed com a URL do seu gatilho Catch-Webhook. A entrega inclui pofid, workspace_id, tipo de documento, key_fields e os campos extraídos. Para trabalhos iniciados pelo próprio fluxo, consulte GET /job/get/{job_id}.
Que eventos pode o Activepieces receber?
document.processed, document.edited, document.deleted, document.version_created, document.note_added, document.tag_added, document.comment_added, document.lifecycle_changed, document.legal_hold_placed e document.legal_hold_released. O fim de um job API é verificado por meio de job/get.
Como verifico que uma entrega vem de PaperOffice AI?
Cada entrega traz a assinatura X-PaperOffice-Signature com sha256= e o HMAC-SHA256 sobre o texto bruto. O secret está na resposta à assinatura. Uma etapa de código calcula o HMAC e o compara, ou o senhor pode enviar um cabeçalho próprio e verificá-lo no Router.
Posso criar assinaturas de webhook no aplicativo?
Não. As assinaturas de webhook são criadas por meio de API com POST /webhooks/subscribe ou pela ferramenta MCP po_webhooks_subscribe. Com POST /webhooks/test, o senhor envia um test.ping ao seu fluxo.
Existem limites para chamadas?
Sim. Em cada plano são possíveis pelo menos 5 chamadas por segundo, 30 por minuto, 100 por hora e 500 por dia – no plano Free por chave, nos planos pagos por conta. Enquanto houver Credits, não se aplicam limites de taxa nos planos pagos. Consultas de status por GET /job/get não contam.
Quanto custa uma chamada?
As chamadas são cobradas em PaperOffice-AI-Credits, no mínimo 5 Credits por chamada cobrável. O processamento, como OCR ou extração de faturas, é cobrado por página conforme o modelo. Consultas de job são gratuitas.
Onde ficam os dados?
Os documentos que Activepieces envia para PaperOffice AI são processados em nosso próprio data center na UE. O que Activepieces armazena depende de onde sua instância está localizada, seja operada internamente ou na Activepieces Cloud.