Существует ли приложение AI для PaperOffice от Pipedream?
Нет. Отдельного приложения в Pipedream не существует. Вы работаете с помощью кодовых шагов в Node.js или Python, HTTP-действия и HTTP-триггера к документированному интерфейсу REST-API и серверу MCP.
Какой ключ мне нужен?
Вы создаете его в PaperOffice AI в разделе Аккаунт → API. Для REST используйте ключ API (poai_) или токен пользователя (po_ut_), для MCP — po_ut_, po_gt_ или OAuth 2.1. Достаточно подтвержденного адреса электронной почты. Интерфейс API доступен во всех тарифах, включая Free.
Как Pipedream узнает, что документ готов?
Через подписку на вебхуки, начиная с Professional. Вы подписываетесь на событие document.processed, указав URL вашего HTTP-триггера. Доставка включает pofid, workspace_id, тип документа, key_fields и извлеченные поля. Для заданий, запускаемых самим рабочим процессом, запрашивайте статус через GET /job/get/{job_id}.
Какие события может получать Pipedream?
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 и document.legal_hold_released. Окончание работы задания API можно проверить через job/get.
Как проверить, что отправка выполнена с PaperOffice AI?
Каждая отправка содержит заголовок X-PaperOffice-Signature с sha256= и значением HMAC-SHA256, вычисленным для исходного текста. Секретный ключ указан в ответе на подписку. Шаг кода вычисляет HMAC и сравнивает его, прежде чем продолжить выполнение рабочего процесса.
Могу ли я создавать подписки на вебхуки в приложении?
Нет. Подписки на вебхуки создаются с помощью API через POST /webhooks/subscribe или с помощью инструмента MCP po_webhooks_subscribe. С помощью POST /webhooks/test Вы отправляете test.ping на Ваш HTTP-триггер.
Есть ли готовый код?
Да. PaperOffice-AI-Cookbook на GitHub содержит рецепты на Node.js, Python и curl, под лицензией MIT. Документация llms.txt описывает все конечные точки так, что ИИ-редактор может сгенерировать код для Вашего шага.
Есть ли ограничения на количество вызовов?
Да. В каждом тарифном плане предусмотрено не менее 5 вызовов в секунду, 30 в минуту, 100 в час и 500 в день — для тарифа Free это количество рассчитывается на каждый ключ, для платных тарифов — на аккаунт. Пока присутствуют Credits, в платных тарифах ограничения скорости не применяются. Запросы статуса через GET /job/get не учитываются.
Сколько стоит один вызов?
Вызовы рассчитываются в PaperOffice-AI-Credits, минимум 5 Credits за каждый подлежащий оплате вызов. Обработка, такая как OCR или извлечение данных из счетов, рассчитывается постранично в зависимости от модели. Запросы заданий бесплатны. Pipedream списывает свои собственные Credits отдельно.
Где хранятся данные?
Документы, которые Pipedream отправляет на PaperOffice AI, мы обрабатываем в нашем собственном дата-центре в ЕС. То, что Pipedream сохраняет в событиях и журналах, зависит от настроек Pipedream и Ваших рабочих процессов.