Перейти к содержимому
AISARAISAR
Свои поля

Свои поля

Своё поле удалено

custom_field.deleted

Отправляется, когда поле удалено окончательно вместе со всеми значениями. Удалить можно только архивное поле; `DELETE /v1/custom-fields/{customField}` отвечает `202` и ставит удаление в очередь, а событие приходит позже, когда строки поля действительно больше нет. Если поле успели восстановить до этого момента, удаление отменяется и события не будет. В payload последнее состояние поля, поэтому `archived_at` заполнен. Справочник полей общий для всей компании, поэтому фильтр каналов интеграции (`channelFilter`) на эти события не действует: они приходят и интеграции, закреплённой за отдельными каналами.

HTTP-запрос

AISAR отправляет подписанный POST-запрос на ваш webhook_url:

http
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

json
{
  "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.idintegerID поля
custom_field.entity_typestringК чему относится поле: `contact`, `conversation` или `organization`
custom_field.keystringМашинное имя поля. Под этим ключом значение лежит в `custom_fields` контакта, диалога или организации и в именах `changes` вида `custom_fields.<key>`
custom_field.labelstringПодпись поля в карточке
custom_field.descriptionstring|nullПояснение к полю
custom_field.typestringТип поля: `string`, `textarea`, `number`, `date`, `select`, `multiselect`, `checkbox`, `url`, `phone`, `email`
custom_field.optionsarray|nullВарианты выбора `[{key, label, position, archived}]` у полей `select` и `multiselect`; у остальных типов `null`
custom_field.settingsobjectНастройки отображения, например `decimals` у числового поля; всегда объект, может быть пустым
custom_field.is_ai_readablebooleanВидят ли значение поля ИИ-сотрудники
custom_field.positionintegerМесто поля в списке. Смена порядка (`PUT /v1/custom-fields/order`) события не отправляет
custom_field.archived_atstring|nullКогда поле ушло в архив (ISO 8601); `null` у активного поля
custom_field.created_atstringВремя создания (ISO 8601)
custom_field.updated_atstringВремя последнего изменения (ISO 8601)