Блок действия «Интеграция с API» позволяет подключать внешние сервисы через API - например, передавать данные, собранные в воронке по конкретному пользователю.
В этой статье разберём, как передавать информацию в Telegram чаты через Bot API по схеме: сообщение с вопросом → сбор контактных данных (ответ сохраняется в переменную) → передача данных через API.
Пример использования:
Иван - начинающий предприниматель и активный пользователь Telegram с ограниченным бюджетом, у него пока нет подключенной полноценной CRM-системы, и ему удобно получать заявки клиентов из Instagram напрямую в его группу в Telegram, в которую он в будущем планирует добавить операторов для обработки заявок.
Передача информации о клиенте используя Telegram BOT API после сбора данных контакта
Для этого нам понадобится идентификатор (id) конкретного пользователя/группы/канала, его можно получить без использования сторонних ботов в Telegram. Для этого достаточно просто следовать шагам ниже:
1) Откройте "Настройки" в приложении, перейдите в раздел "Продвинутые настройки" > "Экспериментальные настройки"
2) Пролистайте до пункта "Show peer IDs in Profile" и переключите ползунок, чтобы включить отображение идентификаторов
3) Откройте страницу профиля/группу/канал того пользователя, кому хотите передавать информацию через бота.
4) Нажатием на идентификатор скопируйте его, он скопируется без пробелов (как нам и нужно). Для групп/каналов аналогично, просто в начале нужно будет добавить -100 перед использованием.
ВАЖНО! Бот должен быть добавлен администратором в группу/канал, чтобы мог отправлять сообщения. А если используете отправку напрямую пользователю - пользователь должен сначала запустить ваш бот.
Теперь у нас есть идентификатор, и его уже можно использовать в ссылке с запросом. Пример готовой ссылки:
https://api.telegram.org/botТОКЕН_БОТА/sendMessage?chat_id=ИДЕНТИФИКАТОР_ПОЛУЧАТЕЛЯ&parse_mode=MarkdownV2&text=🔹*НОВАЯ ЗАЯВКА*🔹%0A%0AИмя: ПЕРЕМЕННАЯ_С_ИМЕНЕМ%0AНомер телефона: \%2BНОМЕР_ТЕЛЕФОНА%0AИсточник: Лид магнит инст&reply_markup={"inline_keyboard":[[{"text":"Открыть диалог 📨","url":"{{ chatLink }}"}]]}
Ниже разберем по пунктам, как заполнить эти данные под ваши цели:
ТОКЕН_БОТА - Вставляете токен вашего бота, можно взять из BotFather. Подробнее есть в инструкции: Подключение Telegram бота
ИДЕНТИФИКАТОР_ПОЛУЧАТЕЛЯ - Заменяете на id пользователя/группы/канала, в который нужно передавать информацию. Напоминаем: для групп и каналов не забудьте добавить -100 до самого идентификатора, чтобы у вас получилось в итоге, например, -10055566644.
Содержимое внутри text:
Текст можете адаптировать под ваши цели и переменные, в которые записываются данные контакта. Также доступно использование эмодзи, можете из Telegram скопировать и вставить прямо в ссылку.
* - Используется для жирного текста, если не нужно - можете убрать
%0A - Перенос строки
\%2B - Чтобы добавить "+" к номеру телефона
url - Ссылка, которая вшита в кнопку. В данном случае мы будем ссылаться сразу на чат с тем пользователем, того, кто проходил через воронку, используем переменную chatLink. То есть, если у вас воронка через Telegram-бота, ссылка будет на аккаунт/чат в Telegram, если Instagram — ссылка на диалог с пользователем в Instagram.
Если нужно в конкретный тред/топик в группе отправлять сообщения, добавьте в конце ссылки: &message_thread_id=ИДЕНТИФИКАТОР_ТОПИКА
Как его найти? Просто скопируйте ссылку на сообщение, любое, у вас будет ссылка вида: https://t.me/c/12345678/2/3 , где 2 - это идентификатор. То есть, в конце итоговой ссылки для добавления интеграции по API будет: &message_thread_id=2 .
Не забываем о возможности использования переменных, в которые записываются данные о контакте через блок сбора данных контакта, подробнее о переменных рассказали в статье: Переменные - как использовать в ChatPlace.
В итоге ссылка в блоке будет выглядеть примерно вот так:
А само сообщение в Telegram следующим образом:
