Перейти к содержимому
AISARAISAR
Все инструкции

amoCRM Salesbot: сообщения, файлы и группы через AISAR

Как в Salesbot amoCRM отправлять через каналы AISAR сообщение клиенту сделки, файл по ссылке и сообщение в существующий чат или группу: поля блоков, ID канала и ID чата, ограничения и коды ошибок.

Что умеют блоки AISAR

Виджет AISAR добавляет в конструктор Salesbot amoCRM три блока (раздел «Виджеты»). Бот доходит до блока, AISAR отправляет сообщение через выбранный канал и возвращает бота на выход «Отправлено» или «Не удалось отправить».

БлокКомуЧто отправляет
AISAR: отправить сообщениеглавному контакту сделкитекст или одобренный шаблон WhatsApp Business
AISAR: отправить файлглавному контакту сделкифайл по публичной ссылке и подпись к нему
AISAR: отправить в чатсуществующему чату канала по его ID: группе или человекутекст, файл или файл с текстом как подписью

Блоки «отправить сообщение» и «отправить файл» работают только в ботах на сделках. Блок «отправить в чат» работает в боте на любой сущности: сделке, покупателе или контакте, потому что получатель задан ID чата.

Перед началом

  • amoCRM подключена к AISAR: в my.aisar.app Настройки → CRM и интеграции → amoCRM. На вкладке «Основное» есть карточка «Salesbot: блоки AISAR» с подсказками из этой статьи.
  • Salesbot включён для вашей интеграции. По умолчанию он выключен, и переключателя в кабинете нет: Salesbot включает команда AISAR по вашему запросу в поддержку. Строка «Salesbot для этой интеграции» в той же карточке показывает, включён ли он. Пока не включён, любой блок завершается кодом salesbot_disabled. Для компаний AISAR Kids Salesbot не включается.
  • Виджет AISAR установлен в amoCRM: Настройки → Интеграции → AISAR → Установить. Блоки «отправить файл» и «отправить в чат» есть в виджете начиная с версии 2.1.0.
  • Ответственные за сделки сопоставлены с сотрудниками AISAR на вкладке «Маппинг». Это нужно, когда у контакта ещё нет переписки на выбранном канале: тогда AISAR открывает диалог от имени ответственного за сделку (подробнее ниже).

Где взять ID канала и ID чата

  • ID канала AISAR нужен во всех трёх блоках. Это число в адресе страницы канала: откройте канал в Настройки → Каналы, ID стоит в конце ссылки, например …/settings/channels/15. Подходит только подключённый канал вашей компании.
  • ID чата нужен в блоке «отправить в чат». Откройте в AISAR диалог с группой или человеком: в панели диалога есть строка «ID чата» с кнопкой «Скопировать ID чата». У группы WhatsApp ID заканчивается на @g.us, у группы Telegram это число вида -100…, у человека в Telegram это его числовой id.
  • ID чата можно вписать в блок как есть или хранить в поле сделки и подставлять маркером amoCRM, например {{lead.cf.123}}. Чат должен уже быть в том канале, который указан в блоке: бот новые чаты не создаёт.

Блок «AISAR: отправить сообщение»

ПолеЧто вписать
ID канала AISARканал, с которого отправить
ID шаблона AISARтолько для WhatsApp Business: ID одобренного шаблона
Текст сообщениядля остальных каналов; маркеры amoCRM вроде {{contact.name}} работают
Переменные шаблонаJSON, например {"name": "{{contact.name}}"} или ["{{lead.price}}"]
  • WhatsApp Business: с ID шаблона уходит шаблон, без него текст уходит, только пока открыто 24-часовое окно клиента.
  • Instagram (Meta) и Messenger: текст, только пока открыто 24-часовое окно клиента.
  • WhatsApp, Telegram (аккаунт или бот): текст без ограничения окна.
  • Телефония, SMS, Live Chat, Threads и TikTok не подходят (channel_type_unsupported).
amoCRM подставляет маркеры в «Переменные шаблона» как обычный текст. Если в значении есть двойная кавычка, JSON ломается и шаг завершается кодом invalid_params.

Кому уходит сообщение или файл по сделке

Получатель блоков «отправить сообщение» и «отправить файл» всегда главный контакт той сделки, на которой идёт бот. Сообщение уходит в его существующую переписку на выбранном канале. Контакту, который отказался от сообщений, бот не пишет.

Если переписки на этом канале ещё нет, AISAR открывает диалог от имени ответственного за сделку, как это делает оператор в кабинете. Для этого ответственный сопоставлен с сотрудником AISAR, состоит в компании, может создавать диалоги и имеет доступ к каналу. У контакта должен быть адрес этого мессенджера, а для WhatsApp и WhatsApp Business достаточно телефона в карточке (не короче 8 цифр). Скрытому контакту новый диалог не открывается. Новых диалогов от Salesbot в день не больше 200 на компанию. В истории диалога видно, кто его открыл и почему: «amoCRM Salesbot, сделка #N».

Блок «AISAR: отправить файл»

ПолеЧто вписать
ID канала AISARканал, с которого отправить
Ссылка на файлпубличная ссылка https или маркер поля сделки, например {{lead.cf.123}}
Имя файланеобязательно; расширение AISAR ставит по настоящему типу файла
Подпись к файлунеобязательно, до 1024 символов

Правила для файлов

  • Только публичная ссылка https: прайс на вашем сайте, прямая ссылка из облака, ссылка из поля сделки. Ссылки на внутренние и частные адреса не принимаются, переадресаций не больше трёх. Файлы из хранилища amoCRM пока не поддерживаются: им нужна авторизация аккаунта.
  • Тип определяется по содержимому файла, а не по имени, и сверяется с тем, что принимает канал. HTML, SVG, скрипты, программы и архивы не отправляются ни в один канал.
  • WhatsApp Business, Instagram (Meta) и Messenger: файл человеку уходит, только пока открыто его 24-часовое окно. Это проверяется до скачивания.
  • Бот ждёт, пока файл скачается и уйдёт, обычно до минуты, и только потом идёт дальше.
КаналРазмер файла
WhatsApp Businessкартинки до 5 МБ (JPEG, PNG), видео и аудио до 16 МБ, документы до 64 МБ
Instagram и Messengerкартинки до 8 МБ (JPEG, PNG, GIF), остальные файлы до 25 МБ
Telegram (аккаунт или бот)до 50 МБ
WhatsAppдо 64 МБ
остальные каналыфайлы не отправляются (channel_type_unsupported)

Блок «AISAR: отправить в чат»

ПолеЧто вписать
ID канала AISARканал, в котором есть этот чат
ID чатаиз панели диалога AISAR или маркер поля сделки
Текст сообщениятекст; если указан файл, это подпись к нему (до 1024 символов)
Ссылка на файлнеобязательно: публичная ссылка https, правила те же, что выше
Имя файланеобязательно
  • Группа: 24-часового окна и отказа от рассылок у группы нет, поэтому эти проверки не применяются. Скрытой или заблокированной группе бот не пишет.
  • Личный чат: те же правила окна и отказа от сообщений, что для контакта сделки.
  • Нужен текст, файл или оба. Шаблоны WhatsApp Business в чаты не отправляются, а групп у WhatsApp Business нет.
  • Сообщения в группу видны в AISAR (и в открытой линии Битрикс24, если она подключена), но не в карточке сделки amoCRM: чаты amoCRM привязаны к контакту, и группы туда не попадают.

От чьего имени пишет бот

Блок «AISAR: отправить в чат» пишет от имени пользователя AISAR, который подключил amoCRM. Любой, кто может править Salesbot в вашем amoCRM, может написать этим блоком в любой существующий чат каналов, доступных этому пользователю: в группы WhatsApp и Telegram и в личные чаты, а не только в чаты контактов из сделок. Права самого редактора бота в AISAR при этом не проверяются. Если не все каналы должны быть доступны боту, ограничьте доступ к каналам пользователю, который подключил amoCRM (см. команды и доступ к каналам), или подключите amoCRM от сотрудника, которому открыты только нужные каналы. Если этот пользователь ушёл из компании, потерял право создавать диалоги или доступ к каналу, блок завершается кодом no_actor, actor_no_permission или actor_no_channel_access.

Блоки «отправить сообщение» и «отправить файл» тоже могут писать с любого подключённого канала компании, но только главному контакту сделки, на которой идёт бот. Выдавайте право править Salesbot в amoCRM тем, кому готовы доверить каналы и чаты компании.

Ограничения

  • В один чат блоком «отправить в чат» уходит не больше 20 сообщений в минуту (chat_rate_limited).
  • В одну группу не больше 500 сообщений в день (group_daily_cap). У личных чатов дневного лимита нет.
  • Шагов с файлом не больше 6 в минуту на аккаунт amoCRM (file_rate_limited). Файлы скачиваются по одному на интеграцию, есть дневная квота на объём скачанного (2 ГБ на интеграцию в сутки, file_quota_exceeded). Шаг, который ждал очереди дольше 5 минут, завершается кодом queue_busy.
  • Шаблонов WhatsApp Business блоком «отправить сообщение» не больше 500 в день на компанию (daily_cap_reached), новых диалогов от Salesbot не больше 200 в день на компанию (daily_dialog_cap_reached).
  • Повтор того же шага бота второго сообщения не даёт (duplicate_step).

Если шаг ушёл в «Не удалось отправить»

Каждую отправку и каждый отказ видно в my.aisar.app на вкладке «Активность» страницы amoCRM, отказ с кодом ошибки. Код приходит и в бота: второй шаг блока читает {{json.status}} (success или fail), а при fail в ответе есть error_code. Коды по смыслу:

КодЧто случилось и что сделать
salesbot_disabledSalesbot не включён для интеграции. Напишите в поддержку AISAR.
file_disabled, chat_disabledфайлы или блок «в чат» временно выключены на стороне AISAR. Повторите позже.
unsupported_entityблок сообщения или файла стоит в боте не на сделке. Для покупателей и контактов подходит только «отправить в чат».
integration_unavailableинтеграция amoCRM в AISAR недоступна. Проверьте её статус на странице amoCRM.
channel_required, channel_not_found, channel_inactiveID канала не указан, не найден в компании или канал отключён. Проверьте ID и статус канала.
channel_type_unsupportedэтот тип канала блок не поддерживает (см. правила выше).
window_closed24-часовое окно клиента закрыто. В WhatsApp Business отправьте шаблон блоком «отправить сообщение».
contact_opted_out, contact_blocked, contact_hiddenконтакт отказался от сообщений, заблокирован или скрыт в AISAR.
lead_not_found, amocrm_unavailableAISAR не смог прочитать сделку в amoCRM: её нет или amoCRM не ответил. Во втором случае повторите позже.
lead_has_no_contact, contact_not_linkedу сделки нет главного контакта или он ещё не связан с контактом AISAR.
no_thread, no_contact_account, invalid_phone, phone_belongs_to_other_contact, dialog_not_createdпереписки нет и открыть её не удалось: у контакта нет адреса в этом мессенджере, телефон короче 8 цифр, номер уже принадлежит другой карточке или диалог не создался.
responsible_not_mapped, responsible_not_member, responsible_no_permission, responsible_no_channel_accessответственный за сделку не сопоставлен с сотрудником AISAR, не состоит в компании, не может создавать диалоги или не имеет доступа к каналу. Проверьте вкладку «Маппинг» и права сотрудника.
template_required, template_not_found, template_not_approved, template_params_missing, invalid_paramsдля WhatsApp Business нужен ID одобренного шаблона и все его переменные корректным JSON.
text_required, text_too_longнет текста или он слишком длинный.
file_url_required, file_url_invalidссылки нет, она не https, ведёт на внутренний адрес или маркер amoCRM не подставился.
file_download_failedфайл не скачался: сайт не ответил, слишком много переадресаций или не уложились по времени.
file_too_large, file_type_unsupportedфайл больше лимита канала или канал не принимает этот тип.
file_quota_exceeded, file_rate_limited, queue_busyсработал лимит файлов (см. «Ограничения»). Повторите позже.
caption_too_longподпись к файлу длиннее 1024 символов.
chat_required, chat_not_foundID чата не указан, в этом канале такого чата нет или маркер amoCRM не подставился.
text_or_file_requiredв блоке «отправить в чат» нет ни текста, ни файла.
no_actor, actor_no_permission, actor_no_channel_accessпользователь, который подключил amoCRM, ушёл из компании, не может создавать диалоги или не имеет доступа к каналу.
chat_rate_limited, group_daily_cap, daily_cap_reached, daily_dialog_cap_reachedсработал лимит (см. «Ограничения»).
duplicate_stepэтот шаг уже выполнялся, второе сообщение не отправлено.
internal_errorсбой на стороне AISAR. Если повторяется, напишите в поддержку.

Смотрите также