Интеграция с Telegram

Если вы используете мессенджер Telegram для коммуникаций с клиентами, то для понимания эффективности маркетинговых каналов вам необходимо использовать услугу «Telegram-трекинг», которая позволяет определять рекламный источник посетителя, который перешел с вашего сайта в данный мессенджер. Данная услуга доступна в рамках услуги Chat-трекинг.

Так как стандартные методы мессенджера Telegram не позволяют определить источник перехода в мессенджер, мы подготовили специальный инструмент. Принцип его работы заключается в том, что при переходе по ссылке в Telegram, мы добавляем специальный параметр. После запуска бота, данный параметр и другие данные должны вернуться на наш сервер с помощью webhook.

ВАЖНО! Персональные аккаунты Telegram не поддерживают работу с webhook. Необходимо использовать исключительно Telegram-бот.

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

Настройка

Для настройки услуги вам нужно перейти в раздел Настройки -> Все интеграции -> Мессенджеры -> Telegram.

Вам необходимо выбрать, используете вы уже готовый бот или требуется создать новый.

Дальнейшие настройки зависят от выбранного варианта.

Использование собственного бота

Для того, чтобы Telegram-трекинг работал, вам необходимо настроить отправку webhook на наш сервер в момент запуска бота (то есть в момент нажатия Start вашим клиентом).

Основная информация, в том числе адрес для webhook, указаны на странице настроек.

Запрос должен минимально содержать следующие параметры:

"date": "{date:d.m.Y H:i:s}"
"user":{"id":"{chat_id}","first_name":"{first_name}","last_name":"{last_name}","username":"{username}"}, "message": "{message}"}

Далее необходимо указать ссылку на бот, которая размещена на вашем сайте и нажать «Сохранить».

После этого включится работа трекинга.

Настройка сторонних сервисов

Настройка отправки webhook в сервисе PuzzleBot

Важно! Отправка webhook возможна только на платных тарифах.

Для настройки отправки данных выберите нужный вам бот, перейдите в раздел «Настройки».

В настройках выберите раздел «Подписки на события», добавьте новую подписку на событие.

• В поле «Адрес» укажите путь, который указан в настройках Telegram-трекинга в личном кабинете Calltracking.ru.
• В поле «Тип события» выберите «Любое сообщение».

Не забудьте сохранить и активировать подписку на событие.

После этого сервис PuzzleBot будет отправлять всю необходимую информацию на наш сервис.

Настройка отправки webhook в сервисе Sambot

Перейдите в раздел «Реакции» и нажмите «Добавить реакцию». Укажите следующие настройки:

1. Срабатывает на -> Текстовое сообщение -> Содержит любой текст

2. Действия -> Отправлять веб-запрос:

• Адрес внешнего сервера как на странице интеграции в ЛК КТ
• Метод отправки POST
• Отправлять JSON:
  
  {"date": "{date:d.m.Y H:i:s}", "bot": {"username": "sambot"}, "user":{"id":"{chat_id}","first_name":"{first_name}","last_name":"{last_name}","username":"{username}"}, "message": "{message}"}

Не забудьте сохранить и активировать реакцию.

Использование бота от Calltrack

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

Важно! Общение с клиентами в этом боте не предусмотрено. Всю переписку вы должны вести с личного аккаунта Telegram.

Для начала работы, перейдите в настройки Telegram_трекинга и выберите, «у меня нет готового бота»:

Далее создайте нового бота в Telegram с помощью Telegram-бота @BotFather.

1. Зайдите в свой аккаунт Telegram

Владельцем бота является пользователь, с чьего аккаунта он был создан. Если вы утратите доступ к аккаунту, с которого создавался бот, или он будет удален, то вы не сможете вернуть доступ к управлению ботом.

2. Найдите в поиске аккаунт @BotFather и отправьте ему команду /newbot

3. Введите имя бота и уникальное название

Имя бота может быть любым. Оно будет отображаться в списке контактов и в диалоге.
После имени дайте боту название.

К названию есть ряд требований:

• Название должно быть уникальным. Нельзя создать бота с уже занятым названием.
• Длина названия – от 5 до 32 символов. Только буквы латинского алфавита, цифры и нижнее подчеркивание.
• Название должно заканчиваться на ‘bot’. Например, 123456testbot, besteverbot, my_company_bot.

Необходимо добавить полученный токен в ЛК Calltracking.ru. Как только вы дадите боту имя и название, @BotFather пришлет сообщение, которое будет содержать токен (набор из цифр и букв). Скопируйте этот набор знаков и добавьте его в настройки Telegram-трекинга.

Далее вам необходимо настроить внешний вид вашего бота. Вы можете указать:

• Фразу-приветствие, которая отображается при входе клиента в бот. Например, «Вас приветствует компания Calltracking.ru. Нажмите кнопку «Старт» для заявки менеджеру».
• Фразу — автоматический ответ, которая отображается клиенту после запуска бота. Например, «Спасибо за вашу заявку, в ближайшее время с вами свяжется наш менеджер.»
• Изображение, которое будет отображаться в боте вместе с фразой-приветствием.

Не забудьте добавить ссылку на ваш бот. Эта ссылка должна в дальнейшем быть размещена на вашем сайте.