Свои поля
Своё поле удалено
custom_field.deletedОтправляется, когда поле удалено окончательно вместе со всеми значениями. Удалить можно только архивное поле; `DELETE /v1/custom-fields/{customField}` отвечает `202` и ставит удаление в очередь, а событие приходит позже, когда строки поля действительно больше нет. Если поле успели восстановить до этого момента, удаление отменяется и события не будет. В payload последнее состояние поля, поэтому `archived_at` заполнен. Справочник полей общий для всей компании, поэтому фильтр каналов интеграции (`channelFilter`) на эти события не действует: они приходят и интеграции, закреплённой за отдельными каналами.
HTTP-запрос
AISAR отправляет подписанный POST-запрос на ваш webhook_url:
POST {webhook_url}
Content-Type: application/json
X-AISAR-Signature: sha256=...
{
"event": "custom_field.deleted",
"event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
"timestamp": "2026-11-15T07:00:00.000000Z",
"company_id": 1,
"data": {
"custom_field": {
"id": 12,
"entity_type": "contact",
"key": "istochnik",
"label": "Источник",
"description": null,
"type": "select",
"options": [
{ "key": "sait", "label": "Сайт", "position": 0, "archived": false },
{ "key": "reklama", "label": "Реклама", "position": 1, "archived": false }
],
"settings": {},
"is_ai_readable": false,
"position": 1,
"archived_at": "2026-11-14T08:00:00.000000Z",
"created_at": "2026-11-12T09:30:00.000000Z",
"updated_at": "2026-11-14T08:00:00.000000Z"
}
}
}Заголовок X-AISAR-Signature содержит HMAC-SHA256 подпись тела запроса — используйте её, чтобы убедиться, что запрос пришёл от AISAR.
Пример payload
{
"event": "custom_field.deleted",
"event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
"timestamp": "2026-11-15T07:00:00.000000Z",
"company_id": 1,
"data": {
"custom_field": {
"id": 12,
"entity_type": "contact",
"key": "istochnik",
"label": "Источник",
"description": null,
"type": "select",
"options": [
{ "key": "sait", "label": "Сайт", "position": 0, "archived": false },
{ "key": "reklama", "label": "Реклама", "position": 1, "archived": false }
],
"settings": {},
"is_ai_readable": false,
"position": 1,
"archived_at": "2026-11-14T08:00:00.000000Z",
"created_at": "2026-11-12T09:30:00.000000Z",
"updated_at": "2026-11-14T08:00:00.000000Z"
}
}
}Поля payload
| Поле | Тип | Описание |
|---|---|---|
custom_field.id | integer | ID поля |
custom_field.entity_type | string | К чему относится поле: `contact`, `conversation` или `organization` |
custom_field.key | string | Машинное имя поля. Под этим ключом значение лежит в `custom_fields` контакта, диалога или организации и в именах `changes` вида `custom_fields.<key>` |
custom_field.label | string | Подпись поля в карточке |
custom_field.description | string|null | Пояснение к полю |
custom_field.type | string | Тип поля: `string`, `textarea`, `number`, `date`, `select`, `multiselect`, `checkbox`, `url`, `phone`, `email` |
custom_field.options | array|null | Варианты выбора `[{key, label, position, archived}]` у полей `select` и `multiselect`; у остальных типов `null` |
custom_field.settings | object | Настройки отображения, например `decimals` у числового поля; всегда объект, может быть пустым |
custom_field.is_ai_readable | boolean | Видят ли значение поля ИИ-сотрудники |
custom_field.position | integer | Место поля в списке. Смена порядка (`PUT /v1/custom-fields/order`) события не отправляет |
custom_field.archived_at | string|null | Когда поле ушло в архив (ISO 8601); `null` у активного поля |
custom_field.created_at | string | Время создания (ISO 8601) |
custom_field.updated_at | string | Время последнего изменения (ISO 8601) |