Вебхуки та сповіщення в 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».