Перейти к содержанию

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

Перед началом работы с мессенджером Telegram требуется:

  1. Установить мобильное приложение Telegram
  2. Зарегистрироваться в Личном кабинете Green-API
  3. Создать и авторизовать инстанс
  4. Получить параметры доступа к инстансу
  5. Настроить получение входящих данных
  6. Ознакомиться с отличиями версии telegram

1. Установка мобильного приложения Telegram#

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

  1. Установите официальное мобильное приложение:

  2. Откройте приложение и нажмите Войти

  3. Введите свой номер телефона, вам будет отправлен код для подтверждения входа
  4. Код придёт в уже установленное приложение Telegram или по SMS

После регистрации в мобильном приложении вы сможете использовать все его функции - отправлять и получать сообщения, совершать звонки и пр.

2. Регистрация в Личном кабинете#

Для использования сервиса перейдите в Личный кабинет и зарегистрируйтесь. Порядок регистрации:

  1. Введите электронную почту

    Рекомендуем использовать корпоративную почту для предотвращения потери доступа к учетной записи при увольнении сотрудника

  2. Выберите страну

  3. Примите пользовательское соглашение и нажмите на кнопку Зарегистрироваться

  4. На указанный адрес электронной почты будет направлено письмо. Введите код, указанный в письме, для подтверждения вашей учетной записи

    Рекомендуем проверять помимо общих входящих сообщений папку Спам, так как письмо может оказаться там

register
code

3. Создание и авторизация инстанса#

Что такое инстанс#

Инстанс - это уникальный номер шлюза для отправки и получения сообщений через мессенджер Telegram.

Он является связующим звеном между вашим аккаунтом в мессенджере и API для отправки запросов и получения уведомлений.

Инстанс создается в личном кабинете и используется для организации HTTP API мессенджера Telegram.

Важно

Один инстанс может одновременно обслуживать только один аккаунт Telegram (один номер телефона).
Для подключения нескольких аккаунтов необходимо создать отдельный инстанс для каждого Telegram аккаунта (каждый инстанс тарифицируется отдельно)

Создание инстанса#

Порядок создания инстанса:

  1. В личном кабинете нажмите на кнопку Создать инстанс
  2. Выберите тарифный план
  3. Если требуется, выберите способ оплаты и проведите оплату

  4. Перейдите в список инстансев, нажав на кнопку Инстансы в боковом меню. В списке можете увидеть созданный вами инстанс

    Переход инстанса в рабочее состояние после создания может занимать до 2-х минут

create

Авторизация инстанса#

Для работы с GREEN-API требуется авторизовать инстанс.
Авторизация выполняется в Личном кабинете одним из двух способов:

  1. Откройте приложение Telegram на мобильном устройстве
  2. Откройте шторку меню ☰ ➠ ⚙ Настройки ➠ 🖳 Устройства ➠ Подключить устройство
  3. В личном кабинете выберите нужный инстанс
  4. Нажмите на кнопку Получить QR и отсканируйте код в мобильном приложении

QR

  1. Используйте метод StartAuthorization для получения кода авторизации

    Код поступит в сервисный чат мессенджера либо через SMS

    code

  2. Отправьте полученный код методом SendAuthorizationCode

    Если ваш аккаунт защищён паролем, то также укажите его в поле password

    Если вы отправили SendAuthorizationCode с кодом, но без пароля, можете отправить его отдельно методом SendAuthorizationPassword

Рекомендуем выполнять авторизацию по QR методу

4. Получить параметры доступа к инстансу#

Для выполнения запросов HTTP API мессенджера Telegram требуется использовать параметры доступа к инстансу. Параметры доступа публикуются в личном кабинете:

  • apiUrl - ссылка на хост API
  • mediaUrl - ссылка на хост API для отправки файлов
  • idInstance - уникальный номер инстанса
  • apiTokenInstance - ключ доступа инстанса

parameters

Ключ доступа инстанса можно сменить при необходимости, например, в случае его компрометации. Сменить токен можно в личном кабинете самостоятельно или обратившись в техподдержку.

5. Настроить получение входящих данных#

Если требуется получать входящие данные (входящие сообщения, статусы ранее отправленных сообщений и др.), то предварительно необходимо выполнить настройку инстанса.

6. Важные отличия версии telegram#

Версия telegram разработана на базе текущей версии GREEN-API.

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

Готово!#

Всё готово для начала отправки и получения сообщений через мессенджер Telegram!