Что это и для чего нужно
С помощью n8n, Make или Zapier Вы подключаете PaperOffice AI к Вашим другим системам. Вы используете стандартные блоки этих инструментов: HTTP-запросы к REST API и вебхуки. n8n также может подключаться к MCP-серверу PaperOffice с помощью его MCP-клиента. Целевые адреса вебхуков в Workflow Agents доступны только начиная с плана Professional.
Как это работает
- Создайте ключ на странице API-ключи. Введите его в HTTP-узле как Bearer-токен.
- Выполняйте вызовы REST API, например, для загрузки или поиска. См. Документация API для получения информации об эндпоинтах.
- Чтобы получать результаты, откройте Workflow AI → Workflow Agents, отредактируйте сохраненного агента и выберите вкладку Вебхуки.
- Нажмите Добавить цель вебхука. Введите адрес вебхука из n8n, Make или Zapier в качестве Целевой URL.
- В разделе Отправлять при выберите Запуск успешно завершен, Запуск завершился ошибкой или оба варианта.
- Для проверки человеком Ваш поток создает задачу на проверку и ожидает вебхук. Событие task.completed сообщает о решении из Workflow AI → Задачи Human In The Loop.
Полезно знать
- За каждую успешную доставку вебхука взимается плата. Повторные попытки, тестовые события и неудачные доставки бесплатны.
- Вызовы API являются платными.
- В пути, параметрах запроса и заголовках допускаются такие заполнители, как {trigger.pofid}, но не в имени хоста.
- Вебхуки от PaperOffice подписываются в заголовке X-PaperOffice-Signature. Проверьте его в Вашем потоке.
- Для Make и Zapier используйте их HTTP-модули и модули вебхуков.
Подробнее: Интеграции на paperoffice.ai.