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

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

30 ноября 2023 г.

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

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

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

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

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

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

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

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

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

QR-code

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

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

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

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

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

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

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

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

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

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

    link-by-number-button-en

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

    enter_digits

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

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

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

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

    linked_button linked_by_phone field_for_code
    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 и привязывать аккаунт ещё удобнее.