Коды авторизации Telegram Gateway#

В данном разделе приведено описание особенностей передачи авторизационных кодов через платформу в Telegram Gateway.

Для отправки кода необходимо передать запрос, содержащий соответствующий код. Указанный код (без сопутствующего текста) будет передан оператору, который вставит его в текст шаблона сообщения.

Подробнее

Сервис Telegram Gateway предназначен для доставки пользователям мессенджера Telegram авторизационных и верификационных цифровых кодов.

Отправка кодов происходит от имени официального канала Verification Codes.

Если пользователь скрывает свой номер телефона в настройках Telegram, это не влияет на доставку сообщения. Также на доставку кодов не влияет наличие или отсутствие у пользователя подписки Telegram Premium.

На данный момент сервис поддерживает:

  • отправку сообщений с кодами авторизации через Telegram;
  • получение статусов доставки сообщений;
  • каскадную передачу сообщений на альтернативные каналы в случае недоставки в Telegram (при необходимости).

Запрос на отправку#

 1 {
 2   "login": "ВАШ_ЛОГИН",
 3   "password": "ВАШ_ПАРОЛЬ",
 4   "useTimeDiff": true,
 5   "id": "superId",
 6   "shortenLinks": false,
 7   "scheduleInfo": {
 8     "timeBegin": "10:00",
 9     "timeEnd": "12:00",
10     "weekdaysSchedule": "123"
11   },
12   "destAddr": "НОМЕР_АБОНЕНТА",
13   "message": {
14     "type": "TGCODE",
15     "data": {
16       "text": "12345",
17       "serviceNumber": "ИМЯ_ОТПРАВИТЕЛЯ",
18       "ttl": 120,
19       "ttlUnit": "SECONDS"
20     }
21   }
22 }

Ответ на запрос#

После отправки сообщения Сервис-провайдер синхронно возвращает ответ.

Ответ при успешной отправке#

В случае успешной отправки возвращается HTTP-код 200 OK.

1  {
2     "mtNum": "7390612217"
3     "id": "8770630"
4  }

Ошибки при отправке#

Для ошибочных результатов HTTP-код ответа будет отличный от 200 OK (см. Коды ошибок отправки).

1 {
2     "error": {
3         "code": 4,
4         "description": "Invalid request"
5     },
6     "extendedDescription": "В сообщении отсутствует код"
7 }

В данном примере в Telegram-сообщении отсутствует цифровой авторизационный код.

Коды ошибок отправки#

Код

Описание

HTTP-код

1

Service is unavailable

503

2

Invalid IP-address

403

3

Too many connections

429

4

Invalid request

400

5

Invalid login

401

6

Invalid password

401

7

serviceNumber is not defined

400

8

destAddr is not correct

406

9

Message type is not correct

406

10

Prohibited sending duplicates

409

11

Invalid TTL

406

100

100

500

Статусы доставки сообщений#

Для получения статусов необходимо настроить Сервис получения статусов доставки сообщений.