Подключаем мессенджер MAX к 1С

Получение сообщений

Получение сообщений выполняется в разделе Получение и работает в режиме ожидания входящих уведомлений.

Режим ожидания сообщений

При нажатии на кнопку «Ожидать сообщения» обработка переходит в режим ожидания входящих сообщений.

В этом режиме:

• обработка регулярно обращается к API GREEN-API;
• входящие сообщения получаются по одному;
• каждое полученное сообщение выводится в поле «Ответ»;
• кнопка «Ожидать сообщения» меняет название на «Прекратить ожидать сообщения», что означает активный режим ожидания.

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

Завершение получения сообщений

Когда все входящие сообщения обработаны и новых сообщений во входящей очереди нет, обработка автоматически завершает получение и выводит сообщение: «Нет сообщений».

После этого режим ожидания считается завершённым.

Прерывание ожидания вручную

В любой момент пользователь может нажать кнопку «Прекратить ожидать сообщения».

В этом случае:

• процесс ожидания немедленно останавливается;
• дальнейшее получение сообщений прекращается;
• обработка возвращается в обычный режим работы.

Рекомендации по использованию

Для автоматизированных сценариев рекомендуется выполнять получение сообщений:

• в фоновом задании;
• с небольшим интервалом (например, 10 секунд).

Такой подход позволяет стабильно обрабатывать входящие сообщения без перегрузки API.

Журналы и очереди

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

Группы

• Создание и управление группами
• Добавление и удаление участников
• Назначение администраторов
• Изменение имени и аватара

Работа с контактами и сообщениями

В разделе Сервисные методы доступны операции для работы с контактами, сообщениями и чатами.

Проверка наличия получателя в MAX

Кнопка «Проверить наличие MAX» позволяет проверить, зарегистрирован ли указанный номер телефона в мессенджере MAX.

В результате выполнения:

• в поле «Ответ» отображается результат проверки;
• если аккаунт не авторизован, может быть возвращено сообщение вида: instance is starting or not authorized.

Получение информации о контактах

В разделе доступны следующие операции:

• Получить аватар контакта - получение изображения профиля контакта;
• Получить контакты - получение списка контактов аккаунта;
• Получить информацию о контакте - получение детальной информации по указанному номеру телефона.

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

Работа с сообщениями

Также доступны операции:

• Удалить сообщение - удаление сообщения по ID;
• Изменить сообщение - редактирование ранее отправленного сообщения;
• Получить список чатов - получение списка доступных чатов;
• Отправить уведомление о наборе текста - отображение статуса «набор сообщения» у получателя.

Партнёрский режим GREEN-API

Раздел Партнёр предназначен для работы по партнёрской схеме GREEN-API и управления несколькими инстансами.

Возможности партнёрского режима

Партнёрская схема работы позволяет:

• управлять большим количеством инстансов;
• получать список созданных инстансов;
• создавать новые инстансы;
• удалять существующие инстансы;
• использовать расширенные условия обслуживания и поддержки.

Работа с инстансами

Для работы необходимо указать Partner token.

Доступные операции:

• Получить список инстансов - выводит список всех инстансов, доступных партнёру;
• Создать инстанс - создание нового инстанса;
• Удалить инстанс - удаление инстанса по его ID.

Результаты выполнения операций отображаются в поле «Ответ».

Использование обработки в собственных конфигурациях

Обработка имеет программный интерфейс, оформленный в соответствии со стандартами разработки 1С. Вы можете встроить ее в свою конфигурацию и вызывать АПИ на сервере через создание объекта. Пример использования:

Отправка сообщения в чат

АПИ = Обработки.GreenAPI.Создать();
АПИ.IdInstance = "ВАШ_ИНСТАНС";
АПИ.ApiToken = "ВАШ_ТОКЕН";
Ответ = АПИ.ОтправитьТекст("10000000", "Я использую GREEN-API для отправки этого сообщения!");

Отправка сообщения в группу

АПИ = Обработки.GreenAPI.Создать();
АПИ.IdInstance = "ВАШ_ИНСТАНС";
АПИ.ApiToken = "ВАШ_ТОКЕН";
Ответ = АПИ.ОтправитьТекст("-10000000000000", "Я использую GREEN-API для отправки этого сообщения!");