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

  • 1. Установка виджета
    Перейдите в amoМаркет и найдите виджет
    Телеграм группы | Интегратор 2.0 или установить по ссылке
  • 2. Добавить токен Телеграм бота
    Телеграм бот передаёт сообщения из групп где он добавлен с правами Администратора.

    Если создаёте нового бота:
    1. В поиске в Telegram найти @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. Подключение персонального Телеграм
    Для автоматического создания групп из amoCRM необходимо подключить персональный Телеграм. Этот аккаунт будет владельцем создаваемых групп.

    1. Открыть Настройки Телеграм → Конфиденциальность → Двух-факторная аутентификация ВЫКЛ
    2. Настройки → Устройства → Привязать устройство через QR
    3. Отсканировать QR код
    4. Ввести одноразовый код - придёт внутри Telegram
    5. Перейти в бот, который создали на предыдущем шаге нажать /start и нажать кнопку поделиться своим контактом

    *Персональный Телеграм - будет только создавать новые группы, личные сообщения интеграцией не поддерживаются. Данный шаг можно ПРОПУСТИТЬ если не требуется автоматического создание ТГ групп.
  • 4. Передача сообщений из уже существующих Групп Телеграм
    • Если группы Телеграм у вас уже созданы, то вам необходимо в эти группы добавить созданного ТГ бота в качестве участника и наделить его Админ правами.
    • Написать в группе, в которую добавили бота, любое сообщение


  • 5. Указать воронку, этап для групп, которые созданы не из amoCRM
    При ручном добавлении ТГ бота в группу - создаются новый контакт и сделка в amoCRM, созданный контакт группы можно привязать к любой другой сделке. Укажите воронку и этап для этого.

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

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


  • 6. Имя автора и Заставка группы
    Указывать имя автора - в ТГ группе сообщения отправленные из amoCRM будут приходить в виде Имя пользователя: сообщение, например: "Михаил: Здравствуйте"

    Установить фото профиля - при автоматическом создании группы - заставка будет добавляться в группу

  • 7. Авто-добавление участников в группу
    Есть 2 формата добавления участников в группу:
    • Для всех созданных групп
    • Для групп созданных по триггеру из воронки amoCRM
    В общих настройках виджета можно добавить участников, которые будут добавлены во все создаваемые группы.

    Для этого нужно чтобы нужный вам участник написал команду /start в ранее созданный бот и поделился с ним контактом. После этого вы сможете добавить его в настройках
  • 8. Создание Телеграм группы из сделки amoCRM
    ВАЖНО!!! функционал доступен только если привязан персональный Телеграм

    • Перейти в раздел Сделки
    • Выбрать существующую сделку или создать новую
    • В сделке, рядом с названием, нажать на "···" (три точки) и на кнопку Создать Телеграм группу
    • Ссылка на новую группу будет находиться в контакте, созданном в этой сделке в поле Ссылка на чат
    • Сообщения из созданного группового чата будут приходить в эту сделку
  • 9. Создание группы автоматически из воронки
    Переходим в настройки воронки amoCRM (доступно на тарифе "Расширенный", "Профессиональный".

    Нажимаем добавить триггер и через поиск находим виджет Телеграм группы | Интегратор 2.0, нажимаем кнопку Добавить

    №1 Создать ТГ группу
    Установить галочку, если нужно создавать группу по событию. Ниже задаётся название созданной группы - можно передавать название из полей amoCRM с помощью переменных. Если галочку не ставить отработают следующие пункты.

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

    №3 Добавить участников в группу
    При создании группы можно автоматически добавлять постоянных участников группы, например члены команды. Для этого нужно чтобы нужный вам участник написал команду /start в ранее созданный бот и поделился с ним контактом

    №4 Удаление участников группы
    Если нужно удалить ранее добавленных участников в группу массово, то можно настроить триггер на удаление участника из всех групп на которые сработает триггера


  • 10. Удаление отправленных сообщений в группе
    Для удаления отправленного сообщения наведите на 3 точки рядом с отправленным сообщением и нажмите удалить, появится запись сообщение удалено
  • 11. Переменные в названии группы и в отправляемых сообщениях
    Виджет поддерживает передачу данных из полей сделки, контакта, компании в названии ТГ группы и в отправляемом сообщении через триггер DP

    Список переменных по ссылке: https://integrator2.ru/manual/vars
  • Авто-приглашение других ботов в группу
    С персонального Телеграм, привязанного в настройках написать боту, который нужно добавлять автоматически /start

    В настройках триггера или настройках виджета нажать "Редактировать список". указать username бота и нажать добавить. После этого бот станет доступен для выбора при настройках автоприглашения.
Инструкция по настройке виджета

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

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

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