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

Перед началом работы#

Перед началом работы с Green API требуется выполнить следующие шаги:

  1. Создать учетную запись в Личном кабинете
  2. Создать Аккаунт
  3. Установить мобильное приложение WhatsApp Business
  4. Авторизовать Аккаунт
  5. Получить параметры доступа к Аккаунту
  6. Настроить получение входящих данных

1. Создать учетную запись в Личном кабинете#

Для создания учетной записи перейдите в Личный кабинет. После авторизации в личном кабинете будет доступна возможность создания аккаунта. В личном кабинете можно создать несколько аккаунтов для одной учетной записи.

2. Создать Аккаунт#

Аккаунт создается в личном кабинете и используется для организации HTTP API WhatsApp. Один аккаунт может одновременно обслуживать только один номер телефона (один аккаунт WhatsApp). При создании аккаунта требуется выбрать тариф.

3. Установить мобильное приложение WhatsApp Business#

Отправка и получение сообщений WhatsApp выполняется с вашего мобильного трелефона. На телефоне должно быть установлено официальное мобильное приложение WhatsApp Business. Допускается также использование мобильного приложения WhatsApp, если использование WhatsApp Business по каким-либо причинам невозможно.

Рекомендуется заказать услугу Хостинг трубки. В этом случае наличие личного мобильного телефона не требуется. Отправка и получение сообщений WhatsApp будет выполняться с мобильного телефона, расположенного в дата-центре Green API.

4. Авторизовать Аккаунт#

В случае, если для работы с Green API используется личный мобильный телефон, требуется авторизовать аккаунт. Авторизация аккаунта выполняется в Личном кабинете путем считывания QR-кода из мобильного приложения WhatsApp Business. Для этого откройте на своем мобильном телефоне приложение WhatsApp Business, перейдите в настройки приложения и считайте QR-код, который отображается в личном кабинете.

  • Android: WhatsApp Business -> Выпадающее меню -> WhatsApp Web
  • iPhone: WhatsApp Business -> Настройки -> WhatsApp Web -> Сканировать QR-код

Отправка и получение сообщений выполняется с вашего мобильного телефона. Поэтому телефон должен быть всегда заряжен и подключен к сети Интернет.

5. Получить параметры доступа к Аккаунту#

Для выполнения запросов HTTP API WhatsApp требуется использовать параметры доступа к Аккаунту. Параметры доступа публикуются в Личном кабинете:

  • idInstance - уникальный номер аккаунта
  • apiTokenInstance - ключ доступа аккаунта

Ключ доступа аккаунта можно сменить при необходимости, например, в случае его компрометации.

6. Настроить получение входящих данных#

Если требуется получать входящие данные (входящие сообщения, статусы ранее отправленных сообщений и др.), то предварительно необходимо выполнить настройку аккаунта. Получать входящие уведомления можно через HTTP API (рекомендуется) или через Webhook Endpoint.

Готово!#

Всё готово для начала отправки и получения сообщений WhatsApp!

Для отладки запросов к Green API рекомендуется использовать Коллекцию Postman