Инструкция: «Кнопки в Telegram»

Виджет для amoCRM от LEADLAB. Описание самой интеграции — на странице виджета. Вопросы — в чате на этой странице или на support@leadlab.su.

1. Как это устроено

Виджет отправляет клиенту в Telegram то, чего не умеет штатный канал amoCRM: кнопку «Поделиться номером» и кнопки-варианты ответа. Сообщения уходят от имени вашего бота, подключённого к Telegram-каналу amoCRM, в ту же переписку, где менеджер общается с клиентом.

Отправить сообщение можно кнопкой в правой колонке карточки сделки или контакта либо шагом Salesbot. Что именно уйдёт клиенту, задаёт шаблон (раздел 4).

2. Установка

Устанавливает виджет администратор аккаунта.

1. Откройте amoМаркет и найдите «Кнопки в Telegram».
2. Нажмите «Установить» и отметьте согласие с условиями — ссылка в окне ведёт на оферту.
3. Окно установки сохранится само. Если появилась подсказка «Нажмите «Сохранить», чтобы завершить установку», нажмите «Сохранить».

После установки в меню «Настройки» появится пункт «Кнопки в Telegram». На его вкладке «Обзор» показано, сколько ботов подключено, сколько шаблонов создано и какой из них основной.

3. Подключение бота

Откройте «Настройки» → «Кнопки в Telegram», вкладка «Боты». Изменять настройки может только администратор аккаунта. На вкладке перечислены Telegram-боты, подключённые к вашей amoCRM, и для каждого указано, подключён ли он к виджету.

1. Нажмите «Подключить» рядом с нужным ботом — откроется окно подключения.
2. Вставьте токен этого бота. Его выдаёт @BotFather в Telegram: /mybots → ваш бот → API Token.
3. Нажмите «Подключить» в окне. Виджет проверит, что токен принадлежит именно этому боту и что бот подключён к штатному каналу amoCRM, а не к другому сервису. После этого рядом с ботом появится статус «Подключён к виджету».

Ботов может быть несколько, например по одному на воронку. Виджет сам выбирает бота по каналу, в котором идёт переписка с клиентом.

Токен не хранится в amoCRM: он передаётся в сервис LEADLAB и хранится там в зашифрованном виде.

Кнопка «Отключить» рядом с ботом отключает его от виджета; перед этим виджет попросит подтверждение. После отключения бот снова работает только с amoCRM, как до подключения. То же происходит, если отключить сам виджет в amoМаркете. После отключения виджета токен бота и шаблоны хранятся 30 дней: если за это время установить виджет снова, бот подключится автоматически, а шаблоны останутся на месте.

4. Шаблоны сообщений

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

• Запрос номера (зелёная точка): текст запроса, надпись на кнопке «Поделиться номером», ответ после получения номера ({phone} заменяется номером клиента), сколько часов ждать ответа, тип телефона в контакте и записи в ленту сделки.
• Сообщение с кнопками (синяя точка): текст, до 10 кнопок-вариантов, сколько часов ждать нажатия и записи в ленту сделки. Справа показано, как сообщение увидит клиент до и после нажатия.

Основной шаблон — это всегда запрос номера. Его отправляет кнопка в карточке, если не выбран другой шаблон, и шаг Salesbot, в котором шаблон не выбран. Чтобы сделать основным другой запрос номера, нажмите «Сделать основным» внизу окна шаблона. Удалить шаблон можно значком корзины в списке или кнопкой «Удалить шаблон» внизу окна; перед удалением виджет попросит подтверждение. Основной шаблон удалить нельзя. Если удалённый шаблон был выбран в шаге Salesbot, этот шаг перестанет отправлять сообщения — выберите в нём другой шаблон.

Внизу списка — настройки для всех запросов номера: удалять ли из чата клиента сообщение с его контактом после ответа и принимать ли номер, который клиент написал текстом. Эти переключатели сохраняются сразу, без кнопки «Сохранить».

5. Отправка из карточки

В правой колонке сделки или контакта есть кнопка «Запросить телефон в Telegram». Если шаблонов несколько, над кнопкой появится выбор шаблона. Если выбран шаблон с кнопками, кнопка называется «Отправить в Telegram».

Если отправить сообщение нельзя, под кнопкой появится причина: нет переписки в Telegram, клиент заблокировал бота, бот не подключён к виджету и т. д.

6. Salesbot: запрос номера

В конструкторе Salesbot добавьте шаг виджета «Запросить телефон в Telegram». В шаге выберите шаблон; если оставить поле пустым, будет использован основной. Поля шаблона можно изменить только для этого шага, сам шаблон не изменится. Изменённые поля отмечены словом «изменено», а ссылка «Вернуть всё как в шаблоне» отменяет все правки.

Ветки шага: «Номер получен», «Клиент не ответил» (время ожидания вышло) и «Запрос не отправлен». В следующих шагах номер доступен как {{json.phone}}, причина неудачи — как {{json.reason}}.

7. Salesbot: сообщение с кнопками

Добавьте шаг «Отправить сообщение с кнопками в Telegram» и выберите шаблон с кнопками. Текст сообщения можно изменить только для этого шага.

У каждой кнопки своя ветка, и есть ещё две: «Клиент не нажал» и «Не отправлено». Надпись нажатой кнопки в следующих шагах доступна как {{json.button_text}}.

8. Что видно в amoCRM

• В ленте сделки (если сделки нет — контакта) — системные сообщения «Кнопки в Telegram»: запрос отправлен, номер получен и записан, кнопка нажата, клиент не ответил. Их можно выключить в шаблоне (переключатель «Записи в ленту сделки»).
• В беседе — ответ клиента: его контакт, если он поделился номером, или надпись нажатой кнопки цитатой к вашему сообщению.
• В контакте — полученный номер в поле «Телефон».

9. Частые вопросы