Вебхуки и уведомления в Slack, Microsoft Teams или Discord
В Pro и Team откройте в личном кабинете раздел «Интеграции», чтобы отправлять события Pandafile в канал Slack, Microsoft Teams или Discord либо на свой сервер в виде подписанного вебхука. Выберите события, отправьте тест и проверьте журнал доставок.
В Pro и Team Pandafile может сразу сообщать вашим другим инструментам о том, что произошло: сообщением в канал Slack, Microsoft Teams или Discord либо вебхуком – подписанным HTTPS-запросом на ваш собственный сервер.
Какие события можно выбрать
- Передача готова: загрузка завершена, и ссылка работает.
- Передача скачана: один раз на получателя, при первом скачивании. Вместо этого можно выбрать каждое скачивание.
- Срок передачи истёк.
- Одобрение или запрос изменений от получателя.
- Загрузка по одному из ваших запросов файлов.
- Документ подписан всеми – для Pandafile Sign.
Как добавить интеграцию
- В Slack, Microsoft Teams или Discord создайте входящий вебхук для канала и скопируйте его URL. Для своей системы используйте HTTPS-адрес на вашем сервере.
- Войдите в Pandafile и откройте в личном кабинете раздел «Интеграции».
- В блоке «Добавить интеграцию» выберите тип, вставьте URL, при желании задайте название и отметьте нужные события.
- Нажмите «Добавить интеграцию», а затем «Отправить тестовое событие», чтобы убедиться, что оно доходит.
Можно добавить до 5 интеграций. Сообщения в чаты пишутся на языке вашего аккаунта.
Вебхуки для разработчиков
- Каждая доставка – это JSON POST с типом события, id и подробностями: id, названия, ссылки, количества и адреса почты получателей. В нём никогда нет содержимого файлов, паролей или личных ссылок для скачивания.
- В каждом запросе есть заголовок Pandafile-Signature с меткой времени (t) и подписью HMAC-SHA256 (v1) метки времени и тела запроса, созданной вашим секретом подписи. Секрет начинается с whsec_ и показывается только один раз.
- Кнопка «Новый секрет» создаёт новый секрет подписи. Старый продолжает работать 24 часа, чтобы вы могли перейти, не потеряв события.
- Отвечайте статусом 2xx в течение 10 секунд. Иначе мы повторим попытку через 1 минуту, 5 минут, 30 минут, 2 часа и 12 часов.
- Журнал доставок показывает последние 50 доставок каждой интеграции и их результат.
Команды, тестовый режим и Zapier
В команде каждый управляет своими интеграциями и получает события только о своих передачах. События о тестовых передачах, созданных тестовым API-ключом, уходят на вебхуки со значением livemode = false и никогда не попадают в Slack, Teams или Discord. Zapier и Make подключаются через API Pandafile и отображаются в блоке «Подписки через API».