Подключить GREEN-API по номеру телефона#

30 ноября 2023 г.

С выходом нового релиза 5.44.24.11, в API был добавлен метод getAutorizationCode для подключения аккаунта WhatsApp к инстансу по номеру телефона. Это более лёгкий способ связи функционала API и аккаунтом в мессенждере. Ранее было доступно подключение только по QR-коду.

QR-код и недостатки#

Способ подключения через QR-код имел ряд недостатков:

• Сгенерированный QR-код постоянно обновлялся;

• QR-код нельзя было переслать клиенту;

• На телефоне может отсутствовать камера для сканирования QR-кода;

• Сканирование QR-кода вызывает трудности, если клиент работает с одного телефона;

• Подключение по QR-коду может вызвать ошибку.

Привязка по номеру и удобство#

Новый метод подключения по номеру телефона getAutorizationCode позволяет избавиться от недостатков QR-кода.

• Вы можете отправить код для привязки аккаунта WhatsApp и инстанса по почте или в мессенджере.
• Не требуется ничего сканировать и применять дополнительные технические средства как камера.
• Код можно скопировать и вставить в поле Связать по номеру телефона. Или самостоятельно ввести код вручную.
• Привязать аккаунт можно не выпуская телефон из рук.

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

Получить код через личный кабинет#

Чтобы вызвать код для привязки номера телефона к инстансу в личном кабинете, требуется:

1. Войти в личный кабинет;

2. Создайте/выберите инстанс, который хотите привязать;

   Для тестирования рекомендуем использовать инстансы на тарифе Developer

3. Нажать на кнопку Связать по номеру телефона;

   
   

4. Ввести номер телефона в международном формате;
   

   
   

   Не используйте плюс, нули, скобки или дефисы при вводе номера телефона в международном формате. Например: 0100123456789@c.us.

5. Нажать Далее, после увидете код, который нужно ввести на телефоне;

   
   Код в личном кабинете.

6. На телефоне откройте приложение WhatsApp или WhatsApp Business, перейдите в Связанные устройства-> Привязка устройства-> Связать по номеру телефона и введите код из личного кабинета.

   
   1. Привязка устройства. 2. Кнопка Связать по номеру телефона. 3. Поле для ввода кода.

Получить код через метод getAutorizationCode#

Чтобы получить код через API, необходимо вызвать метод в вашей среде разработки или протестировать работу метода в Postman.

POST https://api.green-api.com/waInstance{{idInstance}}/getAuthorizationCode/{{apiTokenInstance}}

Для получения параметров запроса idInstance и apiTokenInstance обратитесь к разделу Перед началом работы. В теле запроса метода следует указать номер телефона, который хотите привязать к инстансу:

{
    "phoneNumber": 441234567890
}

Код авторизации придёт в теле ответа:

{
    "status": true,
    "code":"GAPI2018"
}

Подробнее о работе метода вы можете прочитать в документации.

Итог#

Готово. Теперь есть возможность получать код авторизации номера телефона в WhatsApp и привязывать аккаунт ещё удобнее.