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

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

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

Содержание#

Адресная строка вызова методов#

В адрес запроса вызова всех методов добавлен префикс /telegram/

Было:

{{apiUrl}}/waInstance{{idInstance}}/sendMessage/{{apiTokenInstance}}

Стало:

{{apiUrl}}/waInstance{{idInstance}}/sendMessage/{{apiTokenInstance}}

Идентификатор чата#

Идентификатор чата больше не содержит префиксы @c.us и @g.us.

Префикс @c.us сохранён только для отправки сообщений по номеру телефона для поддержки обратной совместимости.

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

  • Пример идентификатора личного чата: 1234567890
  • Пример идентификатора группового чата: -12345678909876

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

Тип мессенджера в вебхуке#

Для определения типа мессенджера, от которого пришел вебхук, можно анализировать свойство вебхука instanceData.typeInstance.

  • Для мессенджера Telegram: "typeInstance": "tgm"
  • Для мессенджера WhatsApp: "typeInstance": "whatsapp"
  • Для мессенджера MAX: "typeInstance": "v3"

Неограниченное количество клиентов Telegram#

Мессенджер Telegram поддерживает подключение неограниченного количества веб-клиентов и мобильных приложений к одному номеру телефона.

Благодаря этому можно создать несколько инстансев и подключить несколько клиентов Telegram к GREEN-API - по одному к каждому инстансу.

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

Партнерские методы#

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

Прочее#

Некоторые методы могут возвращать набор параметров, специфичный для мессенджера Telegram.
Полное описание всех методов и параметров можно найти в Документации API мессенджера Telegram