Каталог событий MCN Telecom — Адресная книга

5 просмотраСоздано 17.08.2026Обновлено 27.08.2026

Адресная книга

События (вебхуки и триггеры), связанные с созданием, изменением и удалением контактов в адресной книге.

Единый Envelope используется для всех событий: один channel соответствует одному event_type.

Содержание

• Создание контакта
• Изменение контакта
• Работа с корзиной

Также см.:
«Каталог событий MCN Telecom — Виртуальная АТС (Звонки ВАТС, Переадресация и внутренние номера)»;
«Каталог событий MCN Telecom — Виртуальная АТС (Очереди, Другие события ВАТС)»;
«Каталог событий MCN Telecom — Работа с речью»;

Общий формат события

Все события используют общую обёртку Envelope:

✓ — обязательное поле; — — необязательное.

Для каждого события приведены описание полей data и пример Payload.

Создание контакта

{
"account_id": 10001,
  "event_type": "integration_create_contact",
  "created_at": "2026-07-01T23:20:51.627Z",
  "idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
  "data": {
    "accountId": 10001,
    "data": {
      "isBlacklist": false,
      "additionalFields": [],
      "eventVersion": 2,
      "source": "web_ab",
      "clientAccountId": 142493,
      "eventTs": 1782937250619,
      "phoneNumbers": [
        {
          "accountId": 10001,
          "contactId": 4584324,
          "id": 9997217,
          "value": "79000000016"
        }
      ],
      "emails": [],
      "accountId": 10001,
      "createdAt": "2026-07-01T20:20:50.539Z",
      "isDeleted": false,
      "name": "ИП Иванов Иван Иванович",
      "eventName": "create_contact",
      "socialMedias": [],
      "id": 4584324,
      "updatedAt": "2026-07-01T20:20:50.539Z",
      "isFavorite": false
    },
    "eventType": "integration_create_contact",
    "id": "07ce776f-f4c5-4f8a-b175-7a0045d77cee",
    "type": "external_event"
  }
}

Изменение контакта

{
"account_id": 10001,
  "event_type": "integration_update_contact",
  "created_at": "2026-07-01T20:40:25.243Z",
  "idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
  "data": {
    "accountId": 10001,
    "data": {
      "isBlacklist": false,
      "updatedBy": 37406,
      "additionalFields": [],
      "contactId": 4584260,
      "eventVersion": 2,
      "numbers": [
        "79000000017"
      ],
      "fullName": "79000000017",
      "contactsGroupIds": [],
      "source": "web_ab",
      "eventTs": 1782927624326,
      "phoneNumbers": [],
      "emails": [],
      "accountId": 10001,
      "createdAt": "2026-07-01T17:32:05.481Z",
      "isDeleted": false,
      "createdBy": 37406,
      "name": "79000000017",
      "eventName": "update_contact",
      "socialMedias": [],
      "customerIds": [],
      "id": 4584260,
      "updatedAt": "2026-07-01T17:40:24.289Z",
      "isFavorite": false
    },
    "eventType": "integration_update_contact",
    "id": "8865c584-772b-4897-8195-f22b8c0072a9",
    "type": "external_event"
  }
}

Работа с корзиной

{
"account_id": 0,
  "event_type": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "idempotencyKey": "0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1",
  "data": {
    "accountId": 0,
    "eventType": "string",
    "id": "string",
    "type": "string"
  }
}

{
"account_id": 10001,
  "event_type": "integration_delete_contact_bulk",
  "created_at": "2026-06-18T18:16:18.918Z",
  "idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
  "data": {
    "accountId": 10001,
    "data": {
      "accountId": 10001,
      "eventVersion": 2,
      "ids": [
        4479221
      ],
      "eventName": "delete_contact_bulk",
      "eventTs": 1781795778463
    },
    "eventType": "integration_delete_contact_bulk",
    "id": "0fa9e3c9-5dd2-4e33-b771-175f82fe92d2",
    "type": "external_event"
  }
}

Была ли эта статья полезной

Да, полезнаНет, не полезна