Skip to main content
Полный каталог на основе схемы см. в разделе все примеры.

Что это такое

Обработка событий создания контакта.

Перед началом работы

  • Создайте общедоступную конечную точку HTTPS в вашем приложении.
  • Настройте конечную точку Webhook в YCloud для необходимых типов событий.
  • Обеспечьте безопасное хранение секрета подписи конечной точки.
  • Сделайте обработку событий идемпотентной.

Принцип работы

YCloud отправляет HTTP-запрос POST при возникновении события. Проверьте подпись, надежно сохраните событие, верните ответ 2xx и обрабатывайте длительные задачи асинхронно.

Запрос

Ниже представлены сценарии запросов, доставляемых на ваш Webhook URL. Используйте id события как идентификатор доставки, а type — для маршрутизации полезной нагрузки.

Ответ

Верните статус 2xx после успешного принятия события.
Сведения о настройке конечной точки, проверке подписи и логике повторных попыток см. в разделе Настройка Webhook.
Происходит при создании нового контакта. Полезная нагрузка Webhook содержит полную информацию о созданном контакте.

Пример события создания контакта

Запрос

Ответ

Подтвердите получение после надежного сохранения события.

Пояснение

  • Полная информация о контакте: объект contactCreated содержит все доступные сведения о контакте на момент его создания.
  • Пользовательские атрибуты: поле customAttributes содержит любые пользовательские данные, связанные с контактом.
  • Теги: массив tags содержит любые теги, присвоенные контакту во время создания.