contact.note.updated

Используйте contact.note.updated для обработки этого события на вашей конечной точке Webhook.

Триггеры

Происходит при обновлении заметки о контакте. Подпишитесь на contact.note.updated, когда будете настраивать конечную точку Webhook. Храните заметку id отдельно от contactId. username и phoneNumber могут иметь значение null.

Синтаксис

YCloud отправляет HTTP-запрос POST на настроенный вами URL-адрес Webhook. Следующая структура показывает один из вариантов полезной нагрузки. Значения в угловых скобках являются плейсхолдерами; их типы перечислены в разделе Параметры. Необязательные поля и другие варианты описаны ниже.

{
  "id": "<ID>",
  "type": "contact.note.updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "contactNote": {
    "id": "<ID>",
    "contactId": "<CONTACT_ID>",
    "username": "<USERNAME>",
    "phoneNumber": "<PHONE_NUMBER>",
    "content": "<CONTENT>",
    "createTime": "<CREATE_TIME>",
    "updateTime": "<UPDATE_TIME>"
  }
}

Параметры

Проверьте HTTP-заголовок YCloud-Signature перед обработкой тела JSON. См. раздел проверка подписи.

Конверт события

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Уникальный идентификатор события. Минимальная длина: `6`. Максимальная длина: `128`.
`type`	string	Да	Всегда `contact.note.updated`.
`apiVersion`	string	Да	Версия API, используемая для формирования этого события.
`createTime`	string (date-time)	Да	Время создания этого события в формате RFC 3339. Например, `2022-06-01T12:00:00.000Z`.

Полезная нагрузка события

Параметр	Тип	Обязательный	Описание
`contactNote`	object	Нет	Специфичная для события полезная нагрузка `contactNote`.

Четыре общих поля конверта являются обязательными. Поля полезной нагрузки зависят от варианта события. В каждой таблице объектов статус Обязательный применяется, если присутствует родительский объект. Необязательные поля можно опускать; наличие поля в примере не делает его обязательным.

contactNote

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Идентификатор заметки. Минимальная длина: `24`. Максимальная длина: `24`. Шаблон: `^[0-9a-fA-F]{24}$`.
`contactId`	string	Да	Идентификатор контакта, которому принадлежит заметка.
`username`	string or null	Да	Имя пользователя контакта, которому принадлежит эта заметка, без начального символа `@`.
`phoneNumber`	string or null	Да	Номер телефона контакта, которому принадлежит эта заметка, в формате E.164.
`content`	string	Да	Текст заметки. Максимальная длина: `500`.
`createTime`	string (date-time)	Нет	Время создания заметки в формате RFC 3339.
`updateTime`	string (date-time)	Нет	Время последнего обновления заметки в формате RFC 3339.

Пример

Ниже приведён JSON тела запроса, доставляемого вашему получателю. Идентификаторы, номера телефонов и другие значения учётной записи представлены для примера.

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

После проверки подписи и надёжного сохранения события верните ответ 2xx. Длительные операции выполняйте асинхронно.

HTTP/1.1 200 OK

Пошаговые сценарии см. в разделе примеры с пояснениями.

Начало работы

Руководства

Конечные точки

Webhook reference

Триггеры

Синтаксис

Параметры

Конверт события

Полезная нагрузка события

contactNote

Пример

​Триггеры

​Синтаксис

​Параметры

​Конверт события

​Полезная нагрузка события

​contactNote

​Пример

Триггеры

Синтаксис

Параметры

Конверт события

Полезная нагрузка события

contactNote

Пример