Боты в диалоге: приветствие, контакт и ответ клиента

Что делает бот в DoCRM

В текущих интеграциях Telegram Bot и MAX Bot API DoCRM принимает сообщения клиента в общий мессенджер, сохраняет их в диалоге и запоминает привязку клиента к провайдеру, каналу, внешнему ID и диалогу. Бот также может отправить настроенное приветствие и кнопку передачи контакта.

Входящие сообщения от бота не создают обычный клиентский диалог. Для MAX Bot API обрабатываются только личные диалоги, а сообщения от самого бота пропускаются.

Настройте бота школы

Нажмите шестерёнку внизу боковой панели → «Общие настройки».
В карточке «Настройки оповещений» нажмите карандаш и раскройте «Мессенджеры».
Для Telegram раскройте «Telegram Bot: интеграции», для MAX — «Интеграции MAX Bot API».
Добавьте интеграцию, затем внутри неё добавьте канал. Укажите название и токен бота; для Telegram при необходимости заполните Username, для MAX Bot API — идентификатор канала и необязательное имя пользователя бота.
На уровне интеграции настройте «Текст кнопки запроса контакта» и «Приветственное сообщение». Сохраните настройки.

Приветственное сообщение Telegram Bot отправляется, когда клиент начинает диалог командой /start. В MAX Bot API оно отправляется после события запуска бота (bot_started), а не после каждого входящего сообщения.

Запросите контакт из диалога

Откройте чат с клиентом. Значок телефона рядом с полем сообщения появляется только для Telegram Bot или MAX Bot API и только пока у карточки клиента нет основного номера. Нажмите значок: он включит «Запросить контакт» для следующего отправляемого сообщения. Отправьте сообщение обычным способом.

В Telegram Bot DoCRM добавляет к сообщению кнопку запроса номера; в MAX Bot API добавляет кнопку request_contact. Текст кнопки берётся из настроек интеграции, а если он пустой — используется «Отправить номер телефона».

Что произойдёт после ответа клиента

После входящего ответа DoCRM сохраняет сообщение в карточке, отмечает его как сообщение клиента и выбирает соответствующий бот-канал как предпочтительный для этого типа связи. В настройках мессенджера карточки обновляются провайдер, канал, ID диалога, внешний ID клиента и ник, если он передан сервисом.

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

Готово: бот направляет ответы клиента в общий диалог, а запрос контакта помогает дополнить карточку без ручного переписывания номера.