Примеры Webhook для удаления контакта

​

Что это такое

​

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

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

​

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

​

Запрос

​

Ответ

HTTP/1.1 200 OK

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

​

Базовый пример удаления контакта

​

Запрос

{
  "id": "evt_3456789012",
  "type": "contact.deleted",
  "apiVersion": "v2",
  "createTime": "2024-01-01T12:00:00.000Z",
  "contactDeleted": {
    "id": "1824266594102064128",
    "nickName": "John Doe",
    "phoneNumber": "+16315551111",
    "updateTime": "2024-01-01T12:00:00.000Z"
  }
}

​

Ответ

HTTP/1.1 200 OK

​

Пояснение

• Минимальная информация: объект contactDeleted содержит только основные сведения: id, nickName, phoneNumber и updateTime.
• Значения Null: поле nickName может быть null, если у контакта не был задан псевдоним.
• Время обновления: поле updateTime отражает время последнего изменения контакта перед его удалением.
• ID контакта: поле id содержит уникальный идентификатор удаленного контакта для справки.
• Номер телефона: поле phoneNumber присутствует всегда и указано в формате E.164.