Подключение аккаунта Telegram

К Wbiztool можно подключить свой собственный аккаунт Telegram рядом с вашими номерами WhatsApp. Он отправляет сообщения через тот же API и те же страницы, что и номер WhatsApp, а получатели видят ваши сообщения как обычные сообщения Telegram от вас.

• Один API для обоих. Отправка сообщения, Отправка на несколько номеров, Планирование сообщения, Отправка в группу, Отмена сообщения и вебхуки статуса сообщений работают так же. Передайте ID аккаунта Telegram как whatsapp_client.
• Те же страницы. Быстрая отправка, кампании и напоминания могут отправлять с него.
• Больше способов связаться с людьми. Отправляйте на номер телефона, имя пользователя (@username), ссылку t.me или в группу.

Кто может это делать: владельцы и редакторы подключают аккаунты Telegram и управляют ими.

Перед началом работы#

• Telegram на телефоне, в котором выполнен вход в аккаунт, с которого вы хотите отправлять.
• Подтверждённый адрес email.
• Оплаченный тариф со свободным местом для номера. Аккаунт Telegram занимает одно из мест для номеров в вашем тарифе, как номер WhatsApp. См. Лимиты номеров.
• Оставшиеся сообщения в тарифе. Каждое сообщение с аккаунта Telegram расходует одно сообщение тарифа, как и в WhatsApp.

Подключение аккаунта#

На странице Номера нажмите Добавить аккаунт Telegram. Эта кнопка есть и в окне Добавить номер WhatsApp: Хотите подключить аккаунт Telegram? Добавить аккаунт Telegram.

Окно Добавить аккаунт Telegram предлагает два способа входа: Сканировать QR-код или Код входа. Результат одинаковый.

По QR-коду#

Этот способ подходит, когда телефон рядом с компьютером.

1. Откройте «Добавить аккаунт Telegram»

   На странице Номера нажмите Добавить аккаунт Telegram. Откроется окно, в котором уже выбран вариант Сканировать QR-код.

2. Покажите QR-код

   Нажмите Показать QR-код. Окно Отсканируйте в Telegram покажет код.

3. Откройте «Подключить устройство» на телефоне

   Откройте Telegram на телефоне и перейдите в Настройки → Устройства → Подключить устройство.

4. Отсканируйте код

   Наведите телефон на QR-код. Код меняется каждые 30 секунд: сканируйте самый новый. Когда вход пройдёт, в окне появится Аккаунт Telegram подключён и «… подключён. Сообщения, которые вы с него отправляете, уходят через Telegram.»

По коду входа#

Этот способ подходит, когда отсканировать QR-код не получается, например если телефон — ваше единственное устройство.

1. Выберите «Код входа»

   В окне Добавить аккаунт Telegram откройте вкладку Код входа.

2. Введите номер

   Проверьте страну в поле Код страны. В поле Номер телефона в Telegram введите номер, к которому привязан ваш аккаунт Telegram, без кода страны, например 9876543210. Нажмите Отправить код входа.

3. Введите код

   Telegram отправит код входа в ваше приложение Telegram (или по SMS). В окне Введите код входа введите его в поле Код входа и нажмите Войти. После этого в окне появится Аккаунт Telegram подключён.

Двухэтапная проверка (облачный пароль)#

Если в аккаунте включена двухэтапная проверка, после QR-кода или кода входа окно попросит её пароль: Введите облачный пароль Telegram. Введите облачный пароль Telegram в поле Облачный пароль и нажмите Войти. Wbiztool использует его один раз для входа и никогда не хранит.

После подключения#

• Аккаунт получает карточку на странице Номера со значком Telegram и своим ID, например ID 702. Нажмите на ID, чтобы скопировать его, и используйте как whatsapp_client в API, как и для номера.
• Нажмите Отправить тестовое сообщение, чтобы проверить отправку. В поле Кому введите @username или номер телефона с кодом страны, например @name или +91 98765 43210.
• Переименовать и Удалить работают так же, как для номера WhatsApp. См. Управление номером.

Отправка с аккаунта Telegram#

Выбирайте аккаунт Telegram как любой номер: в поле От в быстрой отправке, как номер-отправитель кампании или напоминания или с его ID как whatsapp_client в API. Его сообщения видны в Отчётах, а webhook из Отправки сообщения сообщает SENT или FAILED, как и для WhatsApp.

curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 702,
    "phone": "@emma_thompson",
    "msg": "Hi Emma, your order #4821 has shipped and will arrive on Thursday."
  }'

Замените 12345, YOUR_API_KEY и 702 своими значениями: 702 — это ID аккаунта Telegram с его карточки.

Кому можно отправлять#

С аккаунта Telegram параметр phone в API (а также номера в быстрой отправке, номера кампании и поле Кому напоминания) принимает любое из этого:

Имена пользователей, ссылки t.me и tg:<id> работают только с аккаунта Telegram. С номера WhatsApp Отправка сообщения и Планирование сообщения отвечают «Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client», а Отправка на несколько номеров их пропускает.

Какой аккаунт выбирает API#

Если не передать whatsapp_client, Отправка сообщения использует единственный подключённый номер, причём WhatsApp в приоритете:

• Используется один подключённый номер WhatsApp, даже если подключён ещё и аккаунт Telegram. Добавление аккаунта Telegram не переводит на него ваши существующие интеграции.
• Аккаунт Telegram используется, только когда не подключено ни одного номера WhatsApp.
• Для @username используется единственный подключённый аккаунт Telegram.

Чтобы в любом другом случае отправить с аккаунта Telegram, передайте его ID как whatsapp_client.

Группы#

С аккаунта Telegram параметр group_name (и Группы в быстрой отправке) принимает:

• @username или ссылку t.me публичной группы, например @lumen_club или t.me/lumen_club, или
• точное название группы или канала, в которых состоит аккаунт, например Lumen VIP Club. Регистр букв не важен.

Аккаунт уже должен быть участником группы и иметь право в ней писать. Сам он никогда не вступает в группы.

• Если ни одна группа не подходит, сообщение завершается ошибкой «Group not found».
• Если аккаунт не может писать в группу, сообщение завершается ошибкой «This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)».

Ограничения Telegram#

Telegram ограничивает, скольким людям, которые не писали аккаунту первыми, он может отправлять сообщения. Сильнее всего ограничены новые аккаунты.

• Когда Telegram просит снизить темп, аккаунт делает паузу, и его сообщения ждут. Они уйдут после паузы.
• Когда Telegram ограничивает сообщения незнакомым, это сообщение завершается ошибкой «Telegram limited this account: it can't message people who haven't contacted it for now. Sending resumes in an hour», и аккаунт отдыхает час.

Входящие (Unibox)#

Аккаунт Telegram можно добавить во входящие Unibox так же, как номер: на странице Номера для входящих нажмите Добавить номер во входящие и выберите его. Он занимает один из номеров для входящих вашего дополнения Unibox, как и номер WhatsApp.

• Во входящих отображаются его личные чаты: полученные сообщения и сообщения, отправленные с телефона или через Wbiztool. Чаты из Telegram отмечены значком Telegram.
• Файлы до 16 МБ копируются во входящие.
• Ответы работают даже для людей, которые скрывают свой номер.
• Группы, каналы, «Избранное» и служебный чат самого Telegram (тот, в который приходят коды входа) никогда не показываются.

Вебхук аккаунта во входящих отправляет его сообщения так же, как вебхук номера. В полезной нагрузке platform равно telegram, а contact.phone и message.from содержат номер человека, @username или tg:<id>: отправляйте ответ на это значение, передав его как phone. См. Полезная нагрузка.

Отключение и переподключение#

• Отключить на карточке останавливает отправку с аккаунта. Кроме того, Wbiztool выходит из списка устройств аккаунта в Telegram.
• Если Telegram завершит сеанс, например когда вы завершаете сеанс Wbiztool в разделе Настройки → Устройства или из аккаунта выполнен выход на всех устройствах, карточка показывает Не подключён. Владельцы и редакторы получают оповещение об отключении, сформулированное для Telegram, как и для номера WhatsApp. См. Оповещения об отключении WhatsApp.
• Пока аккаунт не подключён, его сообщения ждут в строке Ожидают отправки.
• Чтобы подключить его снова, нажмите Переподключить на его карточке и войдите заново — по QR-коду или по коду входа.

Пока недоступно#

• Экспорт участников групп Telegram. Экспорт участников группы работает только для групп WhatsApp.
• Группы Telegram во входящих Unibox. Там отображаются только личные чаты.

Устранение неполадок#

Связанные материалы#

• Подключение номера WhatsApp
• Быстрая отправка сообщения
• Входящие Unibox и Вебхуки входящих сообщений
• Тарифы и оплата
• API: Отправка сообщения, Отправка в группу и Список подключённых номеров