Контакт обновлён

contact.updated

Отправляется при изменении данных контакта, а также при скрытии контакта из рабочего inbox и возврате обратно (`POST /v1/contacts/{contact}/hide-from-inbox` и `/unhide-from-inbox`) — отдельного типа события для этого не вводилось. Payload этого события — сокращённый, в snake_case (не полная карточка контакта, как в `contact.created`), поэтому полей `hidden_from_inbox_at`, `last_activity_at`, `open_deals_count` и `responsible_user` в нём нет: актуальное состояние читается через `GET /v1/contacts/{contact}`.

HTTP-запрос

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

http

POST {webhook_url}
Content-Type: application/json
X-AISAR-Signature: sha256=...

{
  "event": "contact.updated",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "contact": {
      "id": 10,
      "display_name": "John Doe",
      "first_name": "John",
      "last_name": "Doe",
      "second_name": null,
      "phone": "+12025550187",
      "email": "john@example.com",
      "status": "customer",
      "company": null,
      "title": null,
      "is_group": false,
      "phones": ["+12025550187"],
      "emails": ["john@example.com"],
      "created_at": "2026-03-26T12:00:00.000000Z"
    }
  }
}

Заголовок X-AISAR-Signature содержит HMAC-SHA256 подпись тела запроса — используйте её, чтобы убедиться, что запрос пришёл от AISAR.

Пример payload

json

{
  "event": "contact.updated",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "contact": {
      "id": 10,
      "display_name": "John Doe",
      "first_name": "John",
      "last_name": "Doe",
      "second_name": null,
      "phone": "+12025550187",
      "email": "john@example.com",
      "status": "customer",
      "company": null,
      "title": null,
      "is_group": false,
      "phones": ["+12025550187"],
      "emails": ["john@example.com"],
      "created_at": "2026-03-26T12:00:00.000000Z"
    }
  }
}

Поля payload

Поле	Тип	Описание
`contact.id`	`integer`	Внутренний ID контакта
`contact.display_name`	`string\|null`	Отображаемое имя контакта
`contact.first_name`	`string\|null`	Имя
`contact.last_name`	`string\|null`	Фамилия
`contact.second_name`	`string\|null`	Отчество / среднее имя
`contact.phone`	`string\|null`	Основной телефон
`contact.email`	`string\|null`	Основной email
`contact.status`	`string`	lead или customer
`contact.company`	`string\|null`	Название компании контакта
`contact.title`	`string\|null`	Должность
`contact.is_group`	`boolean`	Является ли контакт групповым
`contact.phones`	`array`	Все телефоны (строки)
`contact.emails`	`array`	Все email-адреса (строки)