{"id":42893607,"url":"https://github.com/green-api/max-api-client-golang","last_synced_at":"2026-01-30T15:02:17.263Z","repository":{"id":314043028,"uuid":"1052657333","full_name":"green-api/max-api-client-golang","owner":"green-api","description":"Golang MAX библиотека для интеграции с мессенджером MAX через API сервиса green-api.com.","archived":false,"fork":false,"pushed_at":"2025-12-23T07:15:52.000Z","size":96,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-12-24T21:54:38.455Z","etag":null,"topics":["max","max-api","max-api-golang","max-bot","max-chat","max-chatbot","max-chatbot-golang","max-golang"],"latest_commit_sha":null,"homepage":"https://green-api.com/max","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","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-09-08T11:14:31.000Z","updated_at":"2025-12-23T07:14:34.000Z","dependencies_parsed_at":"2025-09-10T08:58:34.255Z","dependency_job_id":"92a30d6b-e7dc-4bc4-88f9-d56e2680bade","html_url":"https://github.com/green-api/max-api-client-golang","commit_stats":null,"previous_names":["green-api/max-api-client-golang"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/green-api/max-api-client-golang","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/green-api%2Fmax-api-client-golang","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/green-api%2Fmax-api-client-golang/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/green-api%2Fmax-api-client-golang/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/green-api%2Fmax-api-client-golang/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-golang/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/green-api%2Fmax-api-client-golang/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28914895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T12:13:43.263Z","status":"ssl_error","status_checked_at":"2026-01-30T12:13:22.389Z","response_time":66,"last_error":"SSL_read: 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":["max","max-api","max-api-golang","max-bot","max-chat","max-chatbot","max-chatbot-golang","max-golang"],"created_at":"2026-01-30T15:02:13.559Z","updated_at":"2026-01-30T15:02:17.250Z","avatar_url":"https://github.com/green-api.png","language":"Go","readme":"# max-api-client-golang\n\n- [Documentation in English](docs/README_EN.md).\n\n## API\n\nДокументация к REST API находится по [ссылке](https://green-api.com/v3/docs/api). Библиотека является оберткой к REST API, поэтому документация по ссылке выше применима и к самой библиотеке.\n\n## Поддержка\n\n[![Support](https://img.shields.io/badge/support@green--api.com-D14836?style=for-the-badge\u0026logo=gmail\u0026logoColor=white)](mailto:support@greenapi.com)\n[![Support](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge\u0026logo=telegram\u0026logoColor=white)](https://t.me/greenapi_support_eng_bot)\n[![Support](https://img.shields.io/badge/WhatsApp-25D366?style=for-the-badge\u0026logo=whatsapp\u0026logoColor=white)](https://wa.me/77273122366)\n\n## Руководства и новости\n\n[![Guides](https://img.shields.io/badge/YouTube-%23FF0000.svg?style=for-the-badge\u0026logo=YouTube\u0026logoColor=white)](https://www.youtube.com/@greenapi-en)\n[![News](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge\u0026logo=telegram\u0026logoColor=white)](https://t.me/green_api)\n[![News](https://img.shields.io/badge/WhatsApp-25D366?style=for-the-badge\u0026logo=whatsapp\u0026logoColor=white)](https://whatsapp.com/channel/0029VaLj6J4LNSa2B5Jx6s3h)\n\n## Авторизация\n\nЧтобы отправить сообщение или выполнить другие методы GREEN API, аккаунт MAX в приложении телефона должен быть в авторизованном состоянии. Для авторизации аккаунта перейдите в [личный кабинет](https://console.green-api.com/), запросите SMS код. Введите SMS код, после чего инстанс будет авторизован.\n\n## Установка\n\n**Убедитесь, что у вас установлена версия Go не ниже 1.22**\n```shell\ngo version\n```\n\n**Создайте Go модуль, если он не создан:**\n\n```shell\ngo mod init ModuleName\n```\n\n**Установите библиотеку:**\n\n```shell\ngo get github.com/green-api/max-api-client-golang\n```\n\n**Импорт:**\n\n```go\nimport (\n\tgreenapi \"github.com/green-api/max-api-client-golang\"\n)\n```\n\n## Использование и примеры\n\n**Как инициализировать объект:**\n\n```go\nGreenAPI := greenapi.GreenAPI{\n\t\tAPIURL:           \"https://api.green-api.com/v3\",\n\t\tMediaURL:         \"https://api.green-api.com/v3\",\n\t\tIDInstance:       \"3100000001\",\n\t\tAPITokenInstance: \"d75b3a66374942c5b3c019c698abc2067e151558acbd412345\",\n\t}\n```\n\nВсе методы библиотеки возвращают два объекта: `*APIResponse` и `error`. \n\nВы можете посмотреть формат `APIResponse` в [types.go](types.go)\n\n**Как отправить сообщение:**\n\nСсылка на пример: [sendMessage/main.go](/examples/sendMessage/main.go)\n\n```go\nresponse, _ := GreenAPI.Sending().SendMessage(\n\t\t\"10000000\",\n\t\t\"Hello\",\n\t)\n```\n\n**Как создать группу:**\n\nСсылка на пример: [createGroup/main.go](/examples/createGroup/main.go)\n\n```go\nresponse, _ := GreenAPI.Groups().CreateGroup(\n\t\t\"Group Title\",\n\t\t[]string{\n\t\t\t\"10000000\",\n\t\t\t\"10000001\",\n\t\t},\n\t)\n```\n\n**Как отправить файл с диска:**\n\nСсылка на пример: [sendFileByUpload/main.go](/examples/sendFileByUpload/main.go)\n\n```go\nresponse, _ := GreenAPI.Sending().SendFileByUpload(\n\t\t\"10000000\",\n\t\t\"C:/Users/user/Desktop/Pictures/image.png\",\n\t\t\"image.png\",\n\t)\n```\n\n**Как отправить файл по ссылке:**\n\nСсылка на пример: [sendFileByUrl/main.go](/examples/sendFileByUrl/main.go)\n\n```go\nresponse, _ := GreenAPI.Sending().SendFileByUrl(\n\t\t\"10000000\",\n\t\t\"urlFile\",\n\t\t\"fileName\",\n\t\tgreenapi.OptionalCaptionSendUrl(\"Caption\"),\n\t)\n```\n\n**Как получить входящее уведомление:**\n\nСсылка на пример: [receiveNotification/main.go](/examples/receiveNotification/main.go)\n\n```go\nresponse, _ := GreenAPI.Receiving().ReceiveNotification(\n\t\tgreenapi.OptionalReceiveTimeout(5),\n\t)\n```\n\n## Методы партнёра\n\n**Чтобы использовать методы партнёра, вы должны инициализировать другой объект:**\n\n```go\nPartner := greenapi.GreenAPIPartner{\n\t\tPartnerToken: \"gac.1234567891234567891234567891213456789\",\n\t\tEmail: \"mail@email.com\", // поле email не обязательно \n\t}\n```\n\n**Теперь вы можете использовать методы партнёра так же, как и обычные методы, но через объект \"Partner\":**\n\n**Как получить все инстансы на аккаунте:**\n\nСсылка на пример: [partnerMethods/getInstances/main.go](/examples/partnerMethods/getInstances/main.go)\n\n```go\nresponse, _ := Partner.Partner().GetInstances()\n```\n\n**Как создать инстанс:**\n\nСсылка на пример: [partnerMethods/createInstance/main.go](/examples/partnerMethods/createInstance/main.go)\n\n```go\nresponse, _ := Partner.Partner().CreateInstance(\n\t\tgreenapi.OptionalName(\"Created by GO SDK\"),\n\t\tgreenapi.OptionalWebhookUrl(\"https://webhook.url\"),\n\t\tgreenapi.OptionalWebhookUrlToken(\"auth_token\"),\n\t\tgreenapi.OptionalDelaySendMessages(5000),\n\t\tgreenapi.OptionalMarkIncomingMessagesRead(true),\n\t\tgreenapi.OptionalMarkIncomingMessagesReadOnReply(true),\n\t\tgreenapi.OptionalOutgoingWebhook(true),\n\t\tgreenapi.OptionalOutgoingMessageWebhook(true),\n\t\tgreenapi.OptionalOutgoingAPIMessageWebhook(true),\n\t\tgreenapi.OptionalStateWebhook(true),\n\t\tgreenapi.OptionalIncomingWebhook(true),\n\t)\n```\n\n**Как удалить инстанс:**\n\nСсылка на пример: [partnerMethods/deleteInstanceAccount/main.go](/examples/partnerMethods/deleteInstanceAccount/main.go)\n\n```go\nresponse, _ := Partner.Partner().DeleteInstanceAccount(3100000000)\n```\n\n## Необязательные параметры\n\n**Обратите внимание, что методы могут иметь необязательные параметры, которые вы можете передавать. Необязательные параметры передаются в аргументы методов в виде функций и имеют следующий формат:**\n```go\ngreenapi.Optional + name of parameter\n```\n\n**К примеру в методе `SetSettings` все параметры являются опциональными. Рассмотрим пример вызова данной функции::**\n\n```go\nresponse, _ := GreenAPI.Account().SetSettings(\n        greenapi.OptionalDelaySendMessages(5000),\n\t\tgreenapi.OptionalOutgoingWebhook(true),\n\t\tgreenapi.OptionalIncomingWebhook(true),\n\t\t// greenapi.OptionalWebhookUrl(\"webhook_url\"),\n\t\t// greenapi.OptionalWebhookUrlToken(\"auth_token\"),\n\t\t// greenapi.OptionalMarkIncomingMessagesRead(true),\n\t\t// greenapi.OptionalMarkIncomingMessagesReadOnReply(true),\n\t\t// greenapi.OptionalOutgoingMessageWebhook(true),\n\t\t// greenapi.OptionalOutgoingAPIMessageWebhook(true),\n\t\t// greenapi.OptionalStateWebhook(true),\n\t)\n```\n\nВ этом примере только настройки `DelaySendMessages`, `OutgoingWebhook` и `IncomingWebhook` будут изменены, остальные параметры закомментированы, поэтому не будут использованы. Вы можете раскомментировать любой параметр который предпочитаете. **Неиспользованные параметры никак не затронут настройки инстанса**\n\nЕщё один пример использования опциональных параметров, в этот раз рассмотрим метод `sendMessage`:\n\n```go\nresponse, _ := GreenAPI.Sending().SendMessage(\n\t\t\"10000000\",\n\t\t\"Hello\",\n\t\tgreenapi.OptionalQuotedMessageId(\"2712345112345\"), // цитирует указанное сообщение\n\t)\n```\n\n## Список примеров\n\n| Описание                                   | Ссылка на пример                                               |\n|-----------------------------------------------|---------------------------------------------------------------|\n| Как отправить сообщение                         | [sendMessage/main.go](/examples/sendMessage/main.go)           |\n| Как отправить файл с диска | [sendFileByUpload/main.go](/examples/sendFileByUpload/main.go) |\n| Как отправить файл по ссылке | [sendFileByUrl/main.go](/examples/sendFileByUrl/main.go) |\n| Как выгрузить файл в облачное хранилище                     | [uploadFile/main.go](/examples/uploadFile/main.go)       |\n| Как отправить опрос                         | [sendPoll/main.go](/examples/sendPoll/main.go)           |\n| Как проверить номер телефона на наличие аккаунта MAX         | [CheckAccount/main.go](/examples/CheckAccount/main.go)                   |\n| Как установить настройки инстанса             | [setSettings/main.go](/examples/setSettings/main.go)                 |\n| Как создать группу             | [createGroup/main.go](/examples/createGroup/main.go)                 |\n| Как отправить текстовый статус             | [sendTextStatus/main.go](/examples/sendTextStatus/main.go)                 |\n| Как получить входящее уведомление | [receiveNotification/main.go](/examples/receiveNotification/main.go) |\n| Как получить все инстансы на аккаунте             | [partnerMethods/getInstances/main.go](/examples/partnerMethods/getInstances/main.go)                 |\n| Как создать инстанс             | [partnerMethods/createInstance/main.go](/examples/partnerMethods/createInstance/main.go)                 |\n| Как удалить инстанс            | [partnerMethods/deleteInstanceAccount/main.go](/examples/partnerMethods/deleteInstanceAccount/main.go)                 |\n\n## Список всех методов библиотеки\n\n| API метод                        | Описание                                                                                                               | Ссылка на документацию                                                                                          |\n|-----------------------------------|---------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------|\n| `Account().GetSettings`           | Метод предназначен для получения текущих настроек аккаунта                                                         | [GetSettings](https://green-api.com/v3/docs/api/account/GetSettings/)                                       |\n| `Account().GetAccountSettings`         | Метод предназначен для получения информации о аккаунте MAX                                                      | [GetSettings](https://green-api.com/v3/docs/api/account/GetAccountSettings/)                                     |\n| `Account().SetSettings`           | Метод предназначен для установки настроек аккаунта                                                                        | [SetSettings](https://green-api.com/v3/docs/api/account/SetSettings/)                                          |\n| `Account().GetStateInstance`      | Метод предназначен для получения состояния аккаунта                                                                    | [GetStateInstance](https://green-api.com/v3/docs/api/account/GetStateInstance/)                             |\n| `Account().Reboot`                | Метод предназначен для перезапуска аккаунта                                                                             | [Reboot](https://green-api.com/v3/docs/api/account/Reboot/)                                                 |\n| `Account().Logout`                | Метод предназначен для деавторизации аккаунта                                                                             | [Logout](https://green-api.com/v3/docs/api/account/Logout/)                                                 |\n| `Account().Qr`                | Метод предназначен для получения QR-кода                                                                            | [QR](https://green-api.com/v3/docs/api/account/qr/)                                                 |\n| `Account().SetProfilePicture`     | Метод предназначен для установки аватара аккаунта                                                                   | [SetProfilePicture](https://green-api.com/v3/docs/api/account/SetProfilePicture/)                           |\n| `Groups().CreateGroup`            | Метод предназначен для создания группового чата                                                                             | [CreateGroup](https://green-api.com/v3/docs/api/groups/CreateGroup/)                                        |\n| `Groups().UpdateGroupName`        | Метод изменяет наименование группового чата                                                                             | [UpdateGroupName](https://green-api.com/v3/docs/api/groups/UpdateGroupName/)                                |\n| `Groups().GetGroupData`           | Метод получает данные группового чата                                                                                           | [GetGroupData](https://green-api.com/v3/docs/api/groups/GetGroupData/)                                      |\n| `Groups().AddGroupParticipant`    | Метод добавляет участника в групповой чат                                                                           | [AddGroupParticipant](https://green-api.com/v3/docs/api/groups/AddGroupParticipant/)                        |\n| `Groups().RemoveGroupParticipant` | Метод удаляет участника из группового чата                                                                    | [RemoveGroupParticipant](https://green-api.com/v3/docs/api/groups/RemoveGroupParticipant/)                  |\n| `Groups().SetGroupAdmin`          | Метод назначает участника группового чата администратором                                                        | [SetGroupAdmin](https://green-api.com/v3/docs/api/groups/SetGroupAdmin/)                                    |\n| `Groups().RemoveAdmin`            | Метод лишает участника прав администрирования группового чата                                                   | [RemoveAdmin](https://green-api.com/v3/docs/api/groups/RemoveAdmin/)                                        |\n| `Groups().SetGroupPicture`        | Метод устанавливает аватар группы                                                                                   | [SetGroupPicture](https://green-api.com/v3/docs/api/groups/SetGroupPicture/)                                |\n| `Groups().LeaveGroup`             | \tМетод производит выход пользователя текущего аккаунта из группового чата                                                     | [LeaveGroup](https://green-api.com/v3/docs/api/groups/LeaveGroup/)                                          |\n| `Journals().GetChatHistory`       | Метод возвращает историю сообщений чата                                                                               | [GetChatHistory](https://green-api.com/v3/docs/api/journals/GetChatHistory/)                                |\n| `Journals().GetMessage`           | Метод возвращает сообщение чата                                                                                         | [GetMessage](https://green-api.com/v3/docs/api/journals/GetMessage/)                                        |\n| `Journals().LastIncomingMessages` | Метод возвращает крайние входящие сообщения аккаунта                                                       | [LastIncomingMessages](https://green-api.com/v3/docs/api/journals/LastIncomingMessages/)                    |\n| `Journals().LastOutgoingMessages` | Метод возвращает крайние отправленные сообщения аккаунта                                                                  | [LastOutgoingMessages](https://green-api.com/v3/docs/api/journals/LastOutgoingMessages/)                    |\n| `Queues().ShowMessagesQueue`      | Метод предназначен для получения списка сообщений, находящихся в очереди на отправку                                       | [ShowMessagesQueue](https://green-api.com/v3/docs/api/queues/ShowMessagesQueue/)                            |\n| `Queues().ClearMessagesQueue`     | Метод предназначен для очистки очереди сообщений на отправку                                                          | [ClearMessagesQueue](https://green-api.com/v3/docs/api/queues/ClearMessagesQueue/)                          |\n| `ReadMark().ReadChat`             | Метод предназначен для отметки сообщений в чате прочитанными                                                                      | [ReadChat](https://green-api.com/v3/docs/api/marks/ReadChat/)                                               |\n| `Receiving().ReceiveNotification` | Метод предназначен для получения одного входящего уведомления из очереди уведомлений                              | [ReceiveNotification](https://green-api.com/v3/docs/api/receiving/technology-http-api/ReceiveNotification/) |\n| `Receiving().DeleteNotification`  | Метод предназначен для удаления входящего уведомления из очереди уведомлений                                     | [DeleteNotification](https://green-api.com/v3/docs/api/receiving/technology-http-api/DeleteNotification/)   |\n| `Receiving().DownloadFile`        | \tМетод предназначен для скачивания принятых и отправленных файлов                                                                     | [DownloadFile](https://green-api.com/v3/docs/api/receiving/files/DownloadFile/)                             |\n| `Sending().SendMessage`           | Метод предназначен для отправки текстового сообщения в личный или групповой чат                                                 | [SendMessage](https://green-api.com/v3/docs/api/sending/SendMessage/)                                       |\n| `Sending().SendFileByUpload`      | Метод предназначен для отправки файла, загружаемого через форму (form-data)                                                   | [SendFileByUpload](https://green-api.com/v3/docs/api/sending/SendFileByUpload/)                             |\n| `Sending().SendFileByUrl`         | Метод предназначен для отправки файла, загружаемого по ссылке                                                               | [SendFileByUrl](https://green-api.com/v3/docs/api/sending/SendFileByUrl/)                                   |\n| `Sending().UploadFile`            | Метод предназначен для загрузки файла в облачное хранилище, который можно отправить методом sendFileByUrl | [UploadFile](https://green-api.com/v3/docs/api/sending/UploadFile/)                                         |\n| `Service().CheckAccount`         | Метод проверяет наличие аккаунта MAX на номере телефона                                                      | [CheckAccount](https://green-api.com/v3/docs/api/service/CheckAccount/)                                   |\n| `Service().GetAvatar`             | Метод возвращает аватар корреспондента или группового чата\t                                                          | [GetAvatar](https://green-api.com/v3/docs/api/service/GetAvatar/)                                           |\n| `Service().GetContacts`           | Метод предназначен для получения списка контактов текущего аккаунта                                                   | [GetContacts](https://green-api.com/v3/docs/api/service/GetContacts/)                                       |\n| `Service().GetContactInfo`        | Метод предназначен для получения информации о контакте                                                            | [GetContactInfo](https://green-api.com/v3/docs/api/service/GetContactInfo/)                                 |\n| `Partner().GetInstances`   | Метод предназначен для получения всех инстансов аккаунтов созданных партнёром.                                           | [GetInstances](https://green-api.com/v3/docs/partners/getInstances/)                       |\n| `Partner().CreateInstance`   | Метод предназначен для создания инстанса от имени партнёра.                                           | [CreateInstance](https://green-api.com/v3/docs/partners/createInstance/)                       |\n| `Partner().DeleteInstanceAccount`   | Метод предназначен для удаления инстанса аккаунта партнёра.                                           | [DeleteInstanceAccount](https://green-api.com/v3/docs/partners/deleteInstanceAccount/)                   \n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreen-api%2Fmax-api-client-golang","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgreen-api%2Fmax-api-client-golang","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreen-api%2Fmax-api-client-golang/lists"}