¿Existe un módulo de IA PaperOffice para Activepieces?
No. No existe un componente específico. Trabaje con el componente HTTP, el disparador Catch Webhook y, si es necesario, un paso de código contra la documentación de REST-API y el servidor MCP.
¿Qué clave necesito?
La genera en PaperOffice AI bajo Cuenta → API. Para REST utilice una clave API (poai_) o un token de usuario (po_ut_), para MCP po_ut_, po_gt_ o OAuth 2.1. Un correo electrónico confirmado es suficiente. La API está disponible en todos los planes, también en Free.
¿Funciona también con una instancia autoalojada?
Sí. Para las llamadas a REST-API y al servidor MCP, Activepieces solo necesita acceso saliente a api.paperoffice.ai y mcp.paperoffice.ai. Para los webhooks, la URL del flujo debe ser accesible públicamente, ya que PaperOffice AI no envía datos a direcciones privadas.
¿Cómo sabe Activepieces que un documento está completo?
A través de una suscripción a webhook, desde Professional. Suscriba document.processed con la URL de su disparador Catch-Webhook. La entrega incluye pofid, workspace_id, tipo de documento, key_fields y los campos extraídos. Para trabajos iniciados por el propio flujo, consulte GET /job/get/{job_id}.
¿Qué eventos puede recibir Activepieces?
document.processed, document.edited, document.deleted, document.version_created, document.note_added, document.tag_added, document.comment_added, document.lifecycle_changed y document.legal_hold_placed y document.legal_hold_released. Puede verificar el final de un trabajo API mediante job/get.
¿Cómo verifico que una entrega proviene de PaperOffice AI?
Cada entrega lleva X-PaperOffice-Signature con sha256= y el HMAC-SHA256 sobre el texto en crudo. El secreto se encuentra en la respuesta a la suscripción. Un paso de código calcula el HMAC y lo compara, o usted puede hacer que se envíe un encabezado personalizado y verificarlo en Router.
¿Puedo crear suscripciones de webhook en la aplicación?
No. Las suscripciones de webhook se crean mediante API con POST /webhooks/subscribe o a través de la herramienta MCP po_webhooks_subscribe. Con POST /webhooks/test envía un test.ping a su flujo.
¿Existen límites para las llamadas?
Sí. En cada plan se permiten al menos 5 llamadas por segundo, 30 por minuto, 100 por hora y 500 por día – en la tarifa Free por clave, en las tarifas pagadas por cuenta. Mientras existan Credits, no se aplican límites de tasa en las tarifas pagadas. Las consultas de estado mediante GET /job/get no se cuentan.
¿Cuánto cuesta una llamada?
Las llamadas se facturan en PaperOffice-AI-Credits, con un mínimo de 5 Credits por llamada facturables. El procesamiento como OCR o extracción de facturas se calcula por página según el modelo. Las consultas de trabajo son gratuitas.
¿Dónde se almacenan los datos?
Los documentos que Activepieces envía a PaperOffice AI los procesamos en nuestro propio centro de datos en la UE. Lo que Activepieces almacena depende de dónde se ejecute su instancia, ya sea autoalojado o en la Activepieces Cloud.