События
60 типов событий приходят на ваши вебхуки, когда в вашей организации что-то меняется. Подписывайтесь на точные типы или на маски вроде card.*.
Карточки
- card.archivedКарточка архивирована
- card.createdКарточка создана
- card.deletedКарточка удалена
- card.index_failedОшибка индексации карточки
- card.indexedКарточка проиндексирована
- card.movedКарточка перемещена
- card.publishedЧерновик опубликован как новая карточка
- card.restoredКарточка восстановлена
- card.updatedКарточка изменена
Верификация
- card.unverifiedДоверие к карточке снято
- card.verifiedКарточка подтверждена
- verification.expiredСрок верификации истёк
- verification.requestedЗапрошена верификация
Коллекции и папки
- collection.createdКоллекция создана
- collection.deletedКоллекция удалена
- collection.updatedКоллекция изменена
- folder.createdПапка создана
- folder.deletedПапка удалена
- folder.updatedПапка изменена
Совместная работа
- announcement.readОбъявление прочитано
- announcement.sentОбъявление отправлено
- comment.createdКомментарий добавлен
- comment.resolvedВетка комментариев закрыта
- draft.approvedЧерновик одобрен
- draft.createdЧерновик создан
- draft.publish_requestedЗапрошено согласование публикации
Вопросы и ответы
- access_request.createdЗапрошен доступ
- access_request.resolvedЗапрос доступа рассмотрен
- gap.detectedОбнаружен пробел в знаниях
- question.answeredОтвет на вопрос дан
- question.feedback_createdОтвет оценён
- question.unansweredВопрос без ответа
Люди и доступ
- api_key.createdКлюч API создан
- api_key.expiringСрок ключа API истекает
- api_key.revokedКлюч API отозван
- app.authorizedПриложение авторизовано
- app.revokedАвторизация приложения отозвана
- group.createdГруппа создана
- group.deletedГруппа удалена
- group.member_addedУчастник добавлен в группу
- group.member_removedУчастник удалён из группы
- group.updatedГруппа изменена
- user.createdПользователь создан
- user.deactivatedПользователь деактивирован
- user.offboardedПользователь уволен
- user.updatedПользователь изменён
Источники и импорт
- import.document_failedДокумент импорта не обработан
- import.sync_completedСинхронизация импорта завершена
- source.connection_lostПодключение источника потеряно
- source.sync_completedСинхронизация источника завершена
- source.sync_failedСинхронизация источника не удалась
Задания и выгрузки
- export.readyЭкспорт готов
- job.completedЗадание выполнено
- job.failedЗадание не выполнено
Оплата
- credits.lowКредиты на исходе
- invoice.issuedСчёт выставлен
- invoice.paidСчёт оплачен
- subscription.updatedПодписка изменена
Служебные события вебхуков
- webhook.endpoint_disabledВебхук отключён
- webhook.pingПроверочное событие
Получение событий
Каждая доставка — это POST-запрос с таким JSON-телом на адрес вашего вебхука. Прежде чем доверять телу, проверьте заголовок webhook-signature (Standard Webhooks), ответьте статусом 2xx в течение нескольких секунд, а саму работу выполняйте уже после ответа. Доставки на один адрес сохраняют порядок событий; неудачная доставка повторяется с нарастающими паузами.
Новые типы событий и новые поля могут появиться в любой момент: пропускайте типы и поля, которых не знаете.