Примеры Webhook при удалении контактов и заметок

​

Что это такое

​

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

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

​

Как это работает

​

Запрос

​

Ответ

HTTP/1.1 200 OK

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

​

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

​

Запрос

{
  "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 содержит уникальный идентификатор удаленного контакта для справки.
• Номер телефона: поле phoneNumber присутствует всегда и отформатировано в стандарте E.164.

​

Удаление заметки контакта

​

Запрос

{
  "id": "evt_3234567890abcdef12345678",
  "type": "contact.note.deleted",
  "apiVersion": "v2",
  "createTime": "2024-01-03T12:00:00.000Z",
  "contactNote": {
    "id": "6a3de646e18f344f743aaa4d",
    "contactId": "1824266594102064128",
    "username": "alice_01",
    "phoneNumber": "+16315551111",
    "content": "Customer now prefers afternoon follow-up.",
    "createTime": "2024-01-01T12:00:00.000Z",
    "updateTime": "2024-01-02T12:00:00.000Z"
  }
}

​

Ответ

HTTP/1.1 200 OK

​

Пояснение