{"id":44059887,"url":"https://github.com/green-api/max-api-client-1c","last_synced_at":"2026-02-08T01:09:20.822Z","repository":{"id":336001876,"uuid":"1121605835","full_name":"green-api/max-api-client-1c","owner":"green-api","description":"Внешняя обработка для программы 1С:Предприятие, которая демонстрирует основные приемы работы с API мессенджера MAX и является АПИ оберткой.","archived":false,"fork":false,"pushed_at":"2026-02-02T08:34:03.000Z","size":2181,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-02T21:23:48.496Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"1C Enterprise","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/green-api.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-23T08:58:29.000Z","updated_at":"2026-02-02T08:34:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/green-api/max-api-client-1c","commit_stats":null,"previous_names":["green-api/max-api-client-1c"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/green-api/max-api-client-1c","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/green-api%2Fmax-api-client-1c","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/green-api%2Fmax-api-client-1c/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/green-api%2Fmax-api-client-1c/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/green-api%2Fmax-api-client-1c/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/green-api","download_url":"https://codeload.github.com/green-api/max-api-client-1c/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/green-api%2Fmax-api-client-1c/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29216082,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-08T00:10:47.190Z","status":"ssl_error","status_checked_at":"2026-02-08T00:10:43.589Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-08T01:09:20.306Z","updated_at":"2026-02-08T01:09:20.808Z","avatar_url":"https://github.com/green-api.png","language":"1C Enterprise","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Демо обработка для работы с MAX из 1С  \n\nРепозиторий представляет собой исходники конфигурации в формате выгрузки xml файлов с одной обработкой. Из обработки можно отправить сообщение в мессенджер MAX. Интеграция с MAX сделана через REST сервис [green-api.com](https://green-api.com/max)  \n\nДанная обработка создана на основе ранее разработанной обработки интеграции [WhatsApp с GREEN-API](https://github.com/green-api/whatsapp-api-client-1c).  \n\nВ процессе разработки была сохранена общая архитектура, логика взаимодействия с API и структура интерфейса, что обеспечивает единый подход к работе с мессенджерами в 1С.  \n\nПри этом обработка была адаптирована под особенности мессенджера MAX, включая авторизацтю по QR-коду.  \n\n## Оглавление  \n\n* [Требования](#Требования)  \n* [Важные отличия MAX от WhatsApp](#Важные-отличия-MAX-от-WhatsApp)  \n  * [Основные отличия](#основные-отличия)  \n* [Возможности обработки](#возможности-обработки)  \n* [Регистрация и подготовка](#регистрация-и-подготовка)  \n  * [Процесс авторизации инстанса MAX (через QR-код)](#процесс-авторизации-инстанса-max-через-qr-код)  \n  * [Подключение MAX в обработке](#подключение-max-в-обработке)  \n  * [Отправка сообщений](#отправка-сообщений)  \n  * [Получение сообщений](#получение-сообщений)  \n  * [Журналы и очереди](#журналы-и-очереди)  \n  * [Группы](#группы)  \n* [Работа с контактами и сообщениями](#работа-с-контактами-и-сообщениями)  \n* [Партнёрский режим GREEN-API](#партнёрский-режим-green-api)  \n* [Использование обработки в собственных конфигурациях](#использование-обработки-в-собственных-конфигурациях)  \n  * [Отправка сообщения в чат](#отправка-сообщения-в-чат)  \n  * [Отправка сообщения в группу](#отправка-сообщения-в-группу)  \n* [Установка обработки из исходников](#установка-обработки-из-исходников)  \n\n\n## Требования  \n* Для запуска обработки нужна Платформа 1С не ниже версии 8.3.10.  \n* Для загрузки исходников нужно Платформа 1С не ниже версии 8.3.16.1063  \n\n## Важные отличия MAX от WhatsApp  \n\nПри работе с мессенджером MAX через GREEN-API существуют принципиальные отличия от интеграции WhatsApp, которые важно учитывать при разработке и эксплуатации.  \n\n### Основные отличия  \n\n* **Отсутствие привязки к телефону**  \nИнстанс MAX не зависит от постоянного подключения мобильного устройства к интернету, что повышает стабильность работы.  \n\n* **Более простое повторное подключение**  \nВ большинстве случаев повторная авторизация не требуется, даже при перезапуске инстанса.  \n\n* **Работа с группами**  \nГрупповые чаты идентифицируются ID, начинающимся со знака -, аналогично WhatsApp, но управление группами не требует подтверждений на телефоне.  \n\n* **Фокус на серверное использование**  \nAPI мессенджера MAX лучше подходит для серверных сценариев, ботов, CRM и интеграций с 1С без участия пользователя.  \n\nДетальное описание отличий доступно в [официальной документации API мессенджера MAX](https://green-api.com/v3/docs/important-differences).\n\n## Возможности обработки  \n\n* Отправка текстовых сообщений  \n* Отправка и получение файлов  \n* Работа с групповыми чатами  \n* Получение входящих сообщений  \n* Журналы входящих и исходящих сообщений  \n* Очереди сообщений  \n* Отметка сообщений как прочитанных  \n* Webhook-уведомления  \n* Сервисные методы управления инстансом  \n\n## Регистрация и подготовка  \n\n1. Зарегистрируйтесь в [личном кабинете GREEN-API](https://console.green-api.com)  \n2. Создайте инстанс MAX  \n3. Получите ID Instance и API Token  \n\n### Процесс авторизации инстанса MAX (через QR-код)  \n\nАвторизация выполняется на вкладке `Настройки` -\u003e `Подключение` и завязана на кнопку `Получить состояние инстанса`.  \n\nШаг 1. Запрос состояния инстанса  \n1. Заполните параметры подключения (`host`, `mediaHost`, `idInstance`, `apiTokenInstance`).\n2. Нажмите `Получить состояние инстанса`.  \n\n![qr-authorization](./media/auth.png)  \n\nШаг 2. Если текущий статус инстанса - «Неавторизован»\n\n1. Обработка автоматически покажет QR-код (в блоке под кнопкой).\n2. Отсканируте QR-код телефоном в приложении MAX.\n\nШаг 3. Подтверждение после сканирования  \n\nПосле того как QR-код отсканирован телефоном:\n1. Нажмите кнопку обновления (кнопка с круговой стрелкой / обновить);\n\n![status](./media/status.png)  \n\n2. Повторно нажмите «Получить состояние инстанса».  \nПосле обновления статус изменится на «Авторизован».  \n\n**Что будет, если инстанс уже авторизован**  \n\n![sucsess](./media/sucsess.png)  \n\nЕсли при нажатии «Получить состояние инстанса» инстанс уже в статусе «Авторизован», появится сообщение:  \n\n«Авторизация выполнена успешно.»  \nПримечание: QR-код отображается только когда инстанс не авторизован.  \n\n### Подключение MAX в обработке  \n\n1. [Скачать обработку](https://github.com/green-api/max-api-client-1c/releases/download/0.0.10/GreenAPI-MAX.epf) в формате epf  \n2. Подключиться к сервису через встроенный в обработку помощник или  самостоятельно через сайт [green-api.com](https://green-api.com/). Получить ``API Token`` и ``ID Instance``  \n3. В разделе «Настройки → Подключение» укажите:  \n  * host - api.green-api.com  \n  * hostMedia - media.green-api.com  \n  * idInstance - ID вашего инстанса  \n  * apiTokenInstance - API Token  \n4. Сканировать QR-код с мобильного телефона MAX  \n5. В форме обработки нажать кнопку ``Проверить подключение / Сканировать QR Код``. Поле формы статус должно изменится на \"Подключен\"  \n\nОбработка работает либо с личным чатом, либо с группой - режим определяется автоматически на основании значения, указанного в поле «ID чата».  \n* Если в поле «ID чата» указан идентификатор без знака -, сообщения отправляются в личный чат.\n* Если ID чата начинается со знака -, сообщения отправляются в групповой чат.  \nТип чата определяется автоматически, при этом переключатель «Тип чата» в интерфейсе обработки отображает текущий режим работы (личный чат или группа) и служит индикатором выбранного типа.  \n\n![личный-чат](./media/personal.png)  \n\nИзменение значения в поле «ID чата» приводит к автоматическому переключению типа чата без необходимости дополнительных настроек.  \n\n![групповой-чат](./media/group.png)  \n\n### Отправка сообщений  \n\n![отправка-текста](./media/sendText.gif)  \n\nПоддерживается отправка:  \n* текста  \n* файлов (локально и по URL)  \n* геолокации  \n* контактов  \n* уведомлений о наборе текста  \n\n### Получение сообщений  \n\nПолучение сообщений выполняется в разделе Получение и работает в режиме ожидания входящих уведомлений.  \n\n**Режим ожидания сообщений**  \n\nПри нажатии на кнопку «Ожидать сообщения» обработка переходит в режим ожидания входящих сообщений.  \n\n![ожидание-сообщений](./media/waiting.png)  \n\nВ этом режиме:  \n* обработка регулярно обращается к API GREEN-API;  \n* входящие сообщения получаются по одному;  \n* каждое полученное сообщение выводится в поле «Ответ»;  \n* кнопка «Ожидать сообщения» меняет название на «Прекратить ожидать сообщения», что означает активный режим ожидания.  \n\nОбработка продолжает получать сообщения до тех пор, пока во входящей очереди есть данные.\n\n**Завершение получения сообщений**  \n\nКогда все входящие сообщения обработаны и новых сообщений во входящей очереди нет, обработка автоматически завершает получение и выводит сообщение: **«Нет сообщений»**.  \n\n![конец-ожидания](./media/waiting-end.png)  \n\nПосле этого режим ожидания считается завершённым.  \n\n**Прерывание ожидания вручную**  \n\nВ любой момент пользователь может нажать кнопку **«Прекратить ожидать сообщения»**.\n\nВ этом случае:  \n\n* процесс ожидания немедленно останавливается;  \n* дальнейшее получение сообщений прекращается;  \n* обработка возвращается в обычный режим работы.  \n\n**Рекомендации по использованию**  \n\nДля автоматизированных сценариев рекомендуется выполнять получение сообщений:  \n* в фоновом задании;  \n* с небольшим интервалом (например, 10 секунд).  \n\nТакой подход позволяет стабильно обрабатывать входящие сообщения без перегрузки API.  \n\n### Журналы и очереди  \n\nДоступны журналы сообщений и управление очередями отправки и получения.  \n\n![получить-журнал](./media/getJournale.gif)  \n\n### Группы  \n\n* Создание и управление группами  \n* Добавление и удаление участников  \n* Назначение администраторов  \n* Изменение имени и аватара  \n\n![группы](./media/works-with-groups.png)  \n\n## Работа с контактами и сообщениями  \n\nВ разделе **Сервисные методы** доступны операции для работы с контактами, сообщениями и чатами.\n\n![получить-контакты](./media/getContacts.gif)  \n\n**Проверка наличия получателя в MAX**  \n\nКнопка **«Проверить наличие MAX»** позволяет проверить, зарегистрирован ли указанный номер телефона в мессенджере MAX.  \n\nВ результате выполнения:  \n\n* в поле «Ответ» отображается результат проверки;  \n* если аккаунт уже авторизован, может быть возвращено сообщение вида: `instance account already authorized`.  \n\n**Получение информации о контактах**  \n\nВ разделе доступны следующие операции:  \n\n* **Получить аватар контакта** - получение изображения профиля контакта;  \n* **Получить контакты** - получение списка контактов аккаунта;  \n* **Получить информацию о контакте** - получение детальной информации по указанному номеру телефона.  \n\nДля выполнения операций необходимо указать ID чата в соответствующих полях.  \n\n**Работа с сообщениями**  \n\nТакже доступны операции:  \n\n* Удалить сообщение - удаление сообщения по ID;  \n* Изменить сообщение - редактирование ранее отправленного сообщения;  \n* Получить список чатов - получение списка доступных чатов;  \n* Отправить уведомление о наборе текста - отображение статуса «набор сообщения» у получателя.  \n\n## Партнёрский режим GREEN-API  \n\nРаздел **Партнёр** предназначен для работы по партнёрской схеме GREEN-API и управления несколькими инстансами.  \n\n**Возможности партнёрского режима**\n\nПартнёрская схема работы позволяет:  \n* управлять большим количеством инстансов;  \n* получать список созданных инстансов;  \n* создавать новые инстансы;  \n* удалять существующие инстансы;  \n* использовать расширенные условия обслуживания и поддержки.  \n\n**Работа с инстансами**  \n\nДля работы необходимо указать **Partner token**.  \n\n![партнёры](./media/partners.png)  \n\nДоступные операции:  \n* Получить список инстансов - выводит список всех инстансов, доступных партнёру;  \n* Создать инстанс - создание нового инстанса;  \n* Удалить инстанс - удаление инстанса по его ID.  \n\nРезультаты выполнения операций отображаются в поле **«Ответ»**.\n\n## Использование обработки в собственных конфигурациях  \n\nОбработка имеет программный интерфейс, оформленный в соответствии со [стандартами разработки 1С](https://its.1c.ru/db/v8std). Вы можете встроить ее в свою конфигурацию и вызывать АПИ на сервере через создание объекта. Пример использования:\n\n### Отправка сообщения в чат  \n\n```bsl\nАПИ = Обработки.GreenAPI.Создать();\nАПИ.IdInstance = \"ВАШ_ИНСТАНС\";\nАПИ.ApiToken = \"ВАШ_ТОКЕН\";\nОтвет = АПИ.ОтправитьТекст(\"10000000\", \"Я использую GREEN-API для отправки этого сообщения!\"); \n```\n\n### Отправка сообщения в группу  \n\n```bsl\nАПИ = Обработки.GreenAPI.Создать();\nАПИ.IdInstance = \"ВАШ_ИНСТАНС\";\nАПИ.ApiToken = \"ВАШ_ТОКЕН\";\nОтвет = АПИ.ОтправитьТекст(\"-10000000000000\", \"Я использую GREEN-API для отправки этого сообщения!\"); \n```\n\n## Установка обработки из исходников  \n\nИсходники в репозитории - это xml выгрузка из конфигуратора 1С версии 8.3.16 в режиме совместимости с 8.3.10. Скачайте исходники с репозитория и загрузите в конфигуратор с помощью команды ``Конфигурация`` -\u003e ``Загрузить конфигурацию из файлов``\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreen-api%2Fmax-api-client-1c","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgreen-api%2Fmax-api-client-1c","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreen-api%2Fmax-api-client-1c/lists"}