Контакт создан

contact.created

Отправляется при создании нового контакта. Не отправляется для контактов, созданных импортом из CSV (`/v1/contact-imports`): импорт намеренно не шлёт этот вебхук, не запускает автоматизации и не синхронизирует контакты с Bitrix24/amoCRM — если нужно знать о появлении контактов, ориентируйтесь на realtime-событие `contact_import.completed` или перечитайте список через `GET /v1/contacts`. Обратите внимание: в payload этого события имена полей контакта в camelCase, а поле со списком email называется emailes. Для семейной (kids) компании события `contact.*` не отправляются (ни вебхуком, ни в realtime-канал компании) о контактах, известных семье только через каналы 18+.

HTTP-запрос

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

http

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

{
  "event": "contact.created",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "contact": {
      "id": 10,
      "company_id": 1,
      "displayName": "John Doe",
      "firstName": "John",
      "lastName": "Doe",
      "secondName": null,
      "salutation": null,
      "title": null,
      "company": null,
      "status": "lead",
      "photo": null,
      "comments": null,
      "phones": [{ "phone": "+12025550187", "type": "mobile" }],
      "emailes": [{ "email": "john@example.com", "type": "work" }],
      "contactAccounts": [],
      "tags": [],
      "last_activity_at": null,
      "hidden_from_inbox_at": null,
      "hidden_from_inbox_by_user_id": null,
      "open_deals_count": 0,
      "responsible_user": null,
      "created_at": "2026-03-26T12:00:00.000000Z",
      "updated_at": "2026-03-26T12:00:00.000000Z"
    }
  }
}

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

Пример payload

json

{
  "event": "contact.created",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "contact": {
      "id": 10,
      "company_id": 1,
      "displayName": "John Doe",
      "firstName": "John",
      "lastName": "Doe",
      "secondName": null,
      "salutation": null,
      "title": null,
      "company": null,
      "status": "lead",
      "photo": null,
      "comments": null,
      "phones": [{ "phone": "+12025550187", "type": "mobile" }],
      "emailes": [{ "email": "john@example.com", "type": "work" }],
      "contactAccounts": [],
      "tags": [],
      "last_activity_at": null,
      "hidden_from_inbox_at": null,
      "hidden_from_inbox_by_user_id": null,
      "open_deals_count": 0,
      "responsible_user": null,
      "created_at": "2026-03-26T12:00:00.000000Z",
      "updated_at": "2026-03-26T12:00:00.000000Z"
    }
  }
}

Поля payload

Поле	Тип	Описание
`contact.id`	`integer`	Внутренний ID контакта
`contact.displayName`	`string\|null`	Отображаемое имя контакта
`contact.firstName`	`string\|null`	Имя
`contact.lastName`	`string\|null`	Фамилия
`contact.status`	`string`	lead или customer
`contact.phones`	`array`	Телефоны — объекты с полями phone и type
`contact.emailes`	`array`	Email-адреса — объекты с полями email и type (обратите внимание: поле называется emailes)
`contact.contactAccounts`	`array`	Привязанные платформенные аккаунты
`contact.tags`	`array`	Теги, назначенные контакту
`contact.last_activity_at`	`string\|null`	Последняя активность контакта (сообщение или звонок в любом из его диалогов), ISO-8601; у только что созданного контакта — null
`contact.hidden_from_inbox_at`	`string\|null`	Момент скрытия контакта из общего рабочего inbox (ISO-8601); null — контакт виден
`contact.hidden_from_inbox_by_user_id`	`integer\|null`	Кто скрыл контакт из inbox
`contact.open_deals_count`	`integer`	Число открытых сделок контакта
`contact.responsible_user`	`object\|null`	Ответственный менеджер — {id, name} или null