Партнёрам#
Для проверки методов партнёров, рекомендуем использовать коллекцию Postman для партнёров.
Партнёрская схема работы предполагает более глубокую интеграцию с сервисом и работу с большим числом инстансев на вашей стороне:
-
Управление инстансами по API
-
Постоплатная система работы (со второго месяца работы)
-
Посуточная тарификация (за созданные и не удалённые инстансы)
-
Выделенная линия поддержки
По вопросам подключения к партнёрской схеме и дополнительных условиях просим вас писать на почту support@green-api.com или в чат на сайте.
Настройка АПИ для партнёров:
1. Получение партнёрского ключа
2. Подготовка и работа с личным кабинетом партнёра
3. Тестирование методов
4. Формат запроса
5. Доступные методы API для партнёров
6. Порядок работы
Получение партнёрского ключа#
Получение партнёрского API-ключа происходит через техподдержку Green API support@green-api.com.
Перед запросом ключа партнёра рекомендуем ознакомится с пунктом Подготовка и работа с личным кабинетом партнёра
Подготовка и работа с личным кабинетом партнёра#
-
Для работы с инстансами партнёра рекомендуем создать отдельный личный кабинет. Регистрацию кабинета произвести на корпоративную почту, так при увольнении сотрудника Вы не потеряете данные личного кабинета.
-
После переключения личного кабинета на работу с партнёрской программой (Вам выдается ключ партнёра), создание и удаление инстансов происходить только по API (создание инстансов из личного кабинета будет приводить к ошибке).
-
Если в личном кабинете у Вас присутствуют инстансы тарифа Business они будут тарифицироваться по стандартной схеме (на инстансе может закончиться срок действия и производить продление необходимо оплатой на сайте), изменить тарификацию на партнёрскую невозможно.
-
Рекомендуем, после получения ключа партнёра удалить все существующие инстансы из личного кабинета и производить создание инстансов по API.
-
Для тестирования и настройки интеграции программисту необходимо использовать отдельный личный кабинет и инстансы тарифа Developer. Повышение квоты на создание инстансов происходит через канал технической поддержки.
Тестирование методов#
Для проверки методов партнёров, рекомендуем использовать коллекцию Postman для партнёров.
Ключ партнёра имеет вид: gac.1234567891234567891234567891213456789
Для работы с коллекцией требуется предварительно получить API-ключ партнёра через техподдержку Green API (support@green-api.com).
Справка по установке Postman
Формат запроса#
Обращение к API производится по адресу:
https://api.green-api.com/partner/{method}/{partnerToken}
{method} - (string) - название метода API;
{partnerToken} - (string) - токен партнёра, получается отдельно через техподдержку Green API (support@green-api.com);
Доступные методы API для партнёров#
createInstance - метод создания инстанса аккаунта мессенджера от имени партнёра
deleteInstanceAccount - метод удаляет инстанс аккаунта партнёра
getInstances - метод возвращает все инстансы аккаунтов созданных партнёром
Порядок работы#
- Создайте инстанс методом createInstance
-
Авторизуйте новый инстанс на телефоне. Для этого перейдите в личный кабинет и сканируйте QR-код.
Дополнительно отображение QR-кода можно реализовать в интерфейсе Вашего программного продукта. Для этого рекомендуется воспользоваться примерами кода ниже:
-
Получение QR-кода через HTTP-запрос
-
Получение QR-кода через web-socket
-
Получение QR-кода в 1С
-
Также реализовано получение QR-кода на отдельной странице в Интернете:
https://qr.green-api.com/waInstance{idInstance}/{apiTokenInstance}
idInstance и apiTokenInstance могут быть получены методами createInstance и getInstances.
-
-
Инстанс готов к работе. Для отправки и получения сообщений используйте методы API согласно документации