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

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

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

Содержание#

Различия в адресной строке вызова всех методов#

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

Было:

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

Стало:

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

Новый способ авторизации инстанса#

Изменился способ авторизации инстанса. Процесс авторизации стал проще:

  • Теперь не требуется наличие физической трубки.
  • Также не требуется сканирование QR-кода.
  • Требуется только номер телефона и проверочный код из SMS.

Для авторизации инстанса требуется последовательно вызвать два метода. Для начала авторизации вызовите метод StartAuthorization, а после получения кода из SMS отправьте его методом SendAuthorizationCode.

Отправка сообщений#

Для отправки сообщений используется Идентификатор чата. Перед отправкой сообщения требуется вначале получить Идентификатор чата методом CheckAccount, далее выполнить отправку методом SendMessage с использованием chatId.

Для поддержки обратной совместимости с предыдущими версиями интерфейса допускается в методе отправки сообщений SendMessage и др, в качестве идентификатора чата указывать номер телефона клиента в формате phoneNumber@c.us. Допускается использовать только номера телефонов для РФ и РБ с кодами "7" и "375" соответственно.

Изменения в формате идентификатор чата#

См. подробнее в Рекомендации по отправке сообщений

Изменения в формате идентификатора чата#

Идентификатор чата chatId может включать знак минус - для групповых чатов.

Отказ от использования префиксов @c.us и @g.us#

Во всех методах отправки сообщений, а также методах работы с журналами и в вебхуках префиксы @c.us и @g.us в Идентификаторе чата больше не используются. Однако, для обратной совместимости допускается указывать префикс @c.us при отправке сообщений по номеру телефона.

Прочее#

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