Настройте доступ
В Организация → Workforce → Интеграции настройте подключение и сопоставления провайдера. Администратор выдаёт или меняет webhook-секрет в существующих настройках подключения. Используйте organizationId и connectionId этого подключения.
Маршрут кабинета: /organizations/:organizationId/workforce/integrations. Требуется workforce.integrations.manage; для просмотра — workforce.integrations.view. Предварительно должны быть настроены подключение и доступность соответствующих возможностей выпуска и провайдера.
Первый успешный сценарий
Выполните шаги по порядку. Откройте каждый метод для точного тела, обязательных заголовков и схемы ответа.
- Сформируйте внешний идентификатор события, тип события провайдера и структурированное содержимое.
- Подпишите рекурсивно отсортированный JSON с временем RFC3339 секретом подключения.
- Передайте событие; сохраните eventId, accepted и duplicate из квитанции.
Состояния, повторы и восстановление
Тот же идентификатор с другим содержимым вызывает конфликт повтора. Учитывайте 413 по размеру и Retry-After при 429. Принятие фиксирует проверенное событие провайдера и само по себе не гарантирует синхронизацию всех кадровых полей.