Инструкция к виджету "Групповые чаты Телеграм" в amoCRM

В данной инструкции вы узнаете:

1. Как интегрировать телеграм группу и amoCRM, чтобы получать сообщения из групп
2. Настроите телеграм бота
3. Подключите телеграм номер для автоматического создания групп по триггеру
4. Узнаете какие есть лимиты на создание групп на одном номере

Установка и настройка виджета

1. Установка виджета
Перейдите в amoМаркет и найдите виджет Групповые чаты телеграм от Интегратор 2.0
2. Подключение телеграм бота
Телеграм бот осуществляет передачу сообщений из групп в amoCRM, в которых он добавлен и наделён правами Администратора

Для подключения ТГ бота необходимо в Телеграмме найти официальный бот, который создаёт и управляет ботами Телеграм.

Если создаёте нового бота:
  1. В поиске в Telegram найти @BotFather или перейти по ссылке: https://t.me/botfather
  2. Написать ему /start и бот выдаст вам список доступных команд.
  3. Для создания нового бота введите команду /newbot, далее следуйте инструкциям Telegram.
  4. ВАЖНО! Название бота должно оканчиваться на _bot, например: integrator2_bot
  5. BotFather пришлет вам в ответ результат о создании вашего бота. В ответе будет ссылка, по которой доступен бот, и API token для доступа.
  6. Необходимо скопировать токен вида: 6140340093:AFFuyT-rIXJEzZdXbh6-P5t0jgO433qypQO и вставить в настройках виджета раздел "Подключение" и нажать кнопку Добавить
  7. Если бот успешно добавится, то откроются дальнейшие настройки виджета
Для того, чтобы подключить существующего бота Telegram, вам необходимо:
  1. Написать в @BotFather команду /mybots.
  2. Выбрать бот, который вы хотите подключить.
  3. Нажать API Token, после чего вы увидите token для выбранного бота.
  4. Скопировать его и добавить в окно настроек виджета как на скрине
!!!ВАЖНО: бот, который подключается к виджету не должен быть интегрирован к другим сервисам
3.1. Передача сообщений из уже существующих Групп Телеграм
  • Если группы телеграм у вас уже созданы, то вам необходимо в эти группы добавить созданного ТГ бота в качестве участника и наделить его Админ правами.
  • Написать в группе куда добавили любое сообщение


3.2. Автоматическое создание групп триггером из DP или кнопкой из Сделки [опциональная настройка]
Если нужно, чтобы группы создавались автоматически по триггеру из воронки, или кнопкой в сделке, то необходимо в настройках виджета привязать аккаунт Телеграм указав номер телефона аккаунта.

Данный шаг можно ПРОПУСТИТЬ если не требуется автоматическое создание ТГ групп.

!!!ВАЖНО: рекомендуем завести Телеграм аккаунт на отдельный номер, не использовать для этого свой активный Телеграм

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

*Телеграм аккаунт - не предназначен для переписки с другими аккаунтами, его задача - автоматически создавать группы Телеграм
3.3. Дополнительная безопасность против СПАМа
После привязки бота к виджету, все группы в которые бот будет добавлен, а также сообщения, которые напишут боту другие пользователи Телеграм будут создавать в amoCRM новый чат

Чтобы устранить такую уязвимость, вы можете нажать галочку "Создавать чат, только если бот был приглашён привязанным личным аккаунтом" и нажать Сохранить

ВАЖНО!!!
  • Работает только если привязан аккаунт телеграм (шаг 3.2. выше)
  • Добавлять в группу бот необходимо именно из под личного телеграм аккаунта, который был привязан на шаге 3.2., если добавите бот в группу другим аккаунтом телеграм, бот НЕ БУДЕТ передавать сообщения в amoCRM


4. Настройка этапа в котором будет создаваться сделка с чатом из группы
После добавления ТГ бота, откроется настройка Воронки и Этапа в котором будет создаваться Сделка с контактом группы

  • По-умолчанию новые сообщения из группы будут приходить в Неразобранное в первой воронке
  • Если нужно добавить чат с группой в существующую сделку, то добавьте контакт, который создаётся в Неразобранном в нужную сделку
  • Если нужно, чтобы все новые группы создавались в отдельном этапе или воронке, укажите в Подключении - Воронка - Этап
5. Сообщения из группы создаются в настроенном этапе
Если вы корректно привязали бота в виджете, то сообщение, которое было отправлено в группы вы увидите в Неразобранном в главной воронке amoCRM или на том этапе, который указали в настройках виджета - Подключение Шаг 4

  • Ссылка на группу автоматически прикрепляется в созданном контакте
  • Название группы передаётся в Название созданной сделки
6. Создание группы телеграм из сделки amoCRM
ВАЖНО!!! функционал доступен только если привязан Телеграм аккаунт (не только ТГ бот) - Шаг 3.2

  • Перейти в раздел Сделки
  • Выбрать существующую сделку или создать новую
  • В сделке, рядом с названием, нажать на "···" (три точки) и на кнопку Создать групповой чат
  • Ссылка на новую группу будет находиться в контакте созданном в этой сделке, в поле Ссылка на чат
  • Сообщения из созданного группового чата будут приходить в эту сделку
7. Создание группы автоматически с помощью триггера DP, отправка сообщения и название созданных групп
ВАЖНО!!! функционал доступен только если привязан Телеграм аккаунт (не только ТГ бот) - Шаг 3.2

  • Переходим в настройки DP amoCRM (доступно на тарифе "Расширенный", "Профессиональный"
  • Нажимаем добавить триггер и через поиск находим виджет "Групповые чаты Телеграм от Интегратор 2.0", нажимаем кнопку Добавить

Раздел №1 Отправить сообщение
В данном окне можно написать шаблонное сообщение, которое будет отправляться при создании группы или по настроенному условию (переменные в тексте сообщения пока не поддерживает). Можно отправлять сообщения через Salesbot amoCRM с переменными

№2 Название группы
Задаётся шаблонное название созданной группы

№3 Галочка создавать чат
Если стоит, то при соблюдении условия триггера к сделке будет крепиться созданная новая группа, ссылка на группу будет в контакте в поле "Ссылка на группу"

Если не стоит, то отправляются только сообщения (раздел №1)
8. Удаление отправленных сообщений в группе
Для удаления отправленного сообщения необходимо:

  • Скопировать ссылку из чата amoCRM на не нужное сообщение
  • И отправить в чат команду: удалить "ссылка на сообщение", пример команды: "удалить https://test.amocrm.ru/leads/detail/40357211?t=1715621830533&tid=10dd249a-47c5-4a5c-bd67-8c439bfb5da4"
  • Убрать галочку "Сокращать ссылки"
  • Сообщение в группе удаляется, но в amoCRM его будет видно

»
Ограничения интеграции
Некоторый функционал ограничен возможностями сервисов
  • Лимиты: 50 групп/день и 500 групп всего
    Лимит Телеграм на создание групп с одного аккаунта: 50 групп/день, после превышения лимита нужно ждать следующего дня или написать нам, сделаем доработку под вас

    Аккаунт телеграм (личный) - может состоять не более чем в 500 группах, поэтому после Закрытия сделки виджет будет выходить из группы (на передачу сообщений никак не влияет)

    *Подписка Telegram Premium увеличивает лимит до 1000 групп
  • Только групповые чаты, и чат с ТГ ботом передают сообщения в amoCRM
    Личные сообщения ТГ аккаунта не передаются в amoCRM
  • Убрать пароль в Телеграм аккаунте, который подключаете
    Если вы подключаете Телеграм аккаунт (личный), Шаг 3.2, то необходимо отключить пароль в аккаунте Телеграм, если он есть
  • Нельзя совмещать авторизацию ТГ бота с другими сервисами
    Если у вас уже есть ТГ бот подключенный например в amoCRM, то его нельзя использовать. Либо отвязать от всех сервисов
Если остались вопросы или нужна бесплатная настройка оставляйте заявку