Сообщения

Новое сообщение

message.created

Отправляется при создании нового сообщения — входящего от контакта или исходящего от оператора либо системы. Для сообщений, начатых из рекламы (например, WhatsApp Click-to-Message), payload включает объект referral с данными объявления. Нажатия quick-reply и интерактивных кнопок WhatsApp нормализуются в обычное текстовое сообщение: подпись кнопки попадает в content.text, а payload кнопки — в content.interactive_reply_payload.

HTTP-запрос

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

http

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

{
  "event": "message.created",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-22T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "message": {
      "id": 123,
      "external_id": "3EB0ABC123456789",
      "conversation_id": 45,
      "thread_id": 67,
      "channel_id": 2,
      "direction": "inbound",
      "type": "text",
      "content": {
        "text": "Hello, I need help"
      },
      "display_content": "Hello, I need help",
      "media": null,
      "reply_to_message_id": null,
      "is_deleted": false,
      "system_notification": false,
      "created_at": "2026-03-22T12:00:00.000000Z"
    },
    "sender": {
      "type": "contact",
      "contact_id": 10,
      "contact_account_id": 15,
      "name": "John Doe",
      "phone": "+77001234567",
      "email": "john@example.com",
      "external_id": "77001234567@s.whatsapp.net"
    },
    "recipient": null,
    "conversation": {
      "id": 45,
      "status": "active",
      "contact_id": 10,
      "deal_id": null,
      "subject": null,
      "is_archived": false,
      "is_group": false
    },
    "channel": {
      "id": 2,
      "type": "whatsapp",
      "name": "Main WhatsApp"
    },
    "is_dialog_assigned": false,
    "referral": null
  }
}

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

Пример payload

json

{
  "event": "message.created",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-22T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "message": {
      "id": 123,
      "external_id": "3EB0ABC123456789",
      "conversation_id": 45,
      "thread_id": 67,
      "channel_id": 2,
      "direction": "inbound",
      "type": "text",
      "content": {
        "text": "Hello, I need help"
      },
      "display_content": "Hello, I need help",
      "media": null,
      "reply_to_message_id": null,
      "is_deleted": false,
      "system_notification": false,
      "created_at": "2026-03-22T12:00:00.000000Z"
    },
    "sender": {
      "type": "contact",
      "contact_id": 10,
      "contact_account_id": 15,
      "name": "John Doe",
      "phone": "+77001234567",
      "email": "john@example.com",
      "external_id": "77001234567@s.whatsapp.net"
    },
    "recipient": null,
    "conversation": {
      "id": 45,
      "status": "active",
      "contact_id": 10,
      "deal_id": null,
      "subject": null,
      "is_archived": false,
      "is_group": false
    },
    "channel": {
      "id": 2,
      "type": "whatsapp",
      "name": "Main WhatsApp"
    },
    "is_dialog_assigned": false,
    "referral": null
  }
}

Поля payload

Поле	Тип	Описание
`message.id`	`integer`	Внутренний ID сообщения
`message.external_id`	`string`	Внешний ID сообщения (платформенный, например ID сообщения WhatsApp)
`message.conversation_id`	`integer`	ID диалога
`message.thread_id`	`integer`	ID треда
`message.channel_id`	`integer`	ID канала
`message.direction`	`string`	inbound (от контакта) или outbound (от пользователя/системы)
`message.type`	`string`	Тип сообщения: text, image, video, audio, voice, document, sticker, location, contact, reaction, poll. voice — голосовое сообщение (записанное аудио, OGG/Opus), audio — обычный аудиофайл. Нажатия quick-reply / интерактивных кнопок WhatsApp нормализуются в text
`message.content`	`object\|string`	Содержимое сообщения. Для текста: {"text": "..."}. Для медиа включает подпись, mime_type и т. п. Для нажатий кнопок дополнительно несёт interactive_reply_payload — payload кнопки / id пункта списка (null, если кнопка шаблона без payload)
`message.display_content`	`string\|null`	Текстовое представление содержимого сообщения
`message.media`	`array\|null`	Массив вложений; null, если медиа нет
`message.media[].type`	`string`	Тип вложения: image, video, audio, voice, document, sticker
`message.media[].url`	`string`	URL для скачивания
`message.media[].filename`	`string\|null`	Исходное имя файла
`message.media[].mime_type`	`string\|null`	MIME-тип (например, image/jpeg; голосовые сообщения — audio/ogg)
`message.media[].size`	`integer\|null`	Размер файла в байтах
`message.media[].duration`	`integer\|null`	Длительность в секундах (аудио / голосовые / видео)
`message.reply_to_message_id`	`integer\|null`	ID цитируемого сообщения, если это ответ
`message.is_deleted`	`boolean`	Удалено ли сообщение
`message.system_notification`	`boolean`	Является ли сообщение системным уведомлением
`message.created_at`	`string`	Метка времени ISO 8601
`sender.type`	`string`	contact для входящих сообщений, user для исходящих
`sender.contact_id`	`integer`	ID контакта (для входящих)
`sender.contact_account_id`	`integer`	ID аккаунта контакта (для входящих)
`sender.user_id`	`integer`	ID пользователя (для исходящих)
`sender.name`	`string`	Отображаемое имя отправителя
`sender.phone`	`string\|null`	Телефон контакта (для входящих)
`sender.email`	`string\|null`	Email отправителя
`sender.external_id`	`string`	Платформенный ID контакта, например 77001234567@s.whatsapp.net (для входящих)
`recipient`	`object\|null`	Только для исходящих сообщений: контакт-получатель, та же структура, что у sender с type=contact
`conversation.id`	`integer`	ID диалога
`conversation.status`	`string`	active или closed
`conversation.contact_id`	`integer`	ID контакта
`conversation.deal_id`	`integer\|null`	ID связанной сделки
`conversation.subject`	`string\|null`	Тема диалога
`conversation.is_archived`	`boolean`	Архивирован ли диалог
`conversation.is_group`	`boolean`	true, если это групповой чат (например, группа WhatsApp), false для личных переписок
`channel.id`	`integer`	ID канала
`channel.type`	`string`	Тип канала: whatsapp, whatsapp_business, instagram, telegram
`channel.name`	`string`	Название канала
`is_dialog_assigned`	`boolean`	true, если на диалог назначен пользователь, иначе false
`referral`	`object\|null`	Данные перехода из рекламы (например, WhatsApp Click-to-Message из Facebook/Instagram); null для обычных сообщений
`referral.source_url`	`string`	URL объявления или поста
`referral.source_type`	`string`	Тип источника: ad или post
`referral.source_id`	`string`	ID объявления или поста; можно использовать с Meta API для получения данных кампании
`referral.headline`	`string`	Заголовок объявления
`referral.body`	`string`	Текст объявления
`referral.ctwa_clid`	`string`	Клик-ID для точной атрибуции
`referral.media_type`	`string`	Тип медиа в объявлении: image или video
`referral.image_url`	`string`	URL изображения объявления (если есть)
`referral.video_url`	`string`	URL видео объявления (если есть)