Необходимые условия интеграции
- Зарегистрированная учетная запись Green API с тарифом "Бизнес".
- Прогретый номер телефона, к которому будет привязан инстанс Green API.
- Подписка Swarmica уровня "Про" или выше.
Подготовка нового номера
Для связи по Whatsapp через Green API нужен действующий номер телефона. Если у вас уже есть учетная запись Green API с подключенным номером телефона, то можете сразу перейти к разделу Интеграция в Swarmica
Использование личного номера / учетной записи Whatsapp не рекомендуется – все личные переписки будут переводиться в заявки, а так же высок риск перманентной блокировки номера на стороне Whatsapp.
Чтобы подготовить и использовать новый номер, можно приобрести виртуальную SIM-карту любого сотового оператора на ваш выбор и установить приложение Whatsapp Business на телефон. После активации виртуальной SIM-карты необходимо зарегистрировать учетную запись в Whatsapp Business на номер этой карты и в течение 10-14 дней периодически вести переписку с этим номером с разных учетных записей, чтобы его прогреть.
Через 10-14 дней прогрева можно переходить к настройке Green API.
Внимание! 100% защиты от блокировки номера не существует. Блокирует сам WhatsApp, и, поскольку WhatsApp не раскрывает публично механизмы блокировки, нет и точных алгоритмов пути их обхода. Однако, если следовать указаниям, описанным в этой статье, вероятность блокировки будет очень низкой.
Если ваш номер всё же заблокируют, вам пригодится статья о том, как попытаться его разблокировать. Но WhatsApp может оставить решение о блокировке в силе навсегда.
Нюанс: входящие звонки на WhatsApp не видны в Swarmica. Если кто-то позвонит вам на WhatsApp, вы это не увидите.
Настройки Green API
1. Если у вас еще нет учетной записи Green API, зарегистрируйте аккаунт: https://console.green-api.com/registration
2. Нажмите "Создать инстанс" и выберите тариф.
Можно сначала потестировать возможности интеграции на бесплатном тарифе, а потом подключить платный тариф.
Вы попадёте на страницу инстанса. Также на страницу инстанса можно попасть по ссылке https://console.green-api.com, после нажатия на открывшейся странице на ваш инстанс.
3. На странице инстанса привяжите ваш аккаунт WhatsApp к Green Api. Для этого перейдите к вкладке "Связать по QR-коду" и нажмите "Получить QR":
4. В телефоне откройте приложение WhatsApp, нажмите на меню действий справа вверху и выберите "Связанные устройства"
Нажмите "Связывание устройства" и отсканируйте QR-код.
Если всё получилось, статус инстанса должен стать "Авторизован":
Если наблюдаются проблемы с привязкой номера по QR, вы можете попробовать воспользоваться вкладкой "Связать по номеру телефона":
5. https://console.green-api.com/app/api/setSettings, включите параметр Получать уведомления о входящих сообщениях и файлах и нажмите Отправить:
Интеграция в Swarmica
Перейдите в Swarmica в раздел Настройки - Каналы, выберите "WhatsApp" и заполните предлагаемые поля. Вам понадобятся настройки на странице инстанса Green Api. Чтобы перейти на страницу инстанса, нажмите https://console.green-api.com/instanceList/ и затем на ваш инстанс.
Настройки WhatsApp в Swarmica выглядят так:
Название - произвольное название канала.
Токен - apiTokenInstance со страницы инстанса Green Api.
ID инстанса - idInstance со страницы инстанса Green Api.
URL инстанса - apiUrl со страницы инстанса Green Api.
URL медиафайлов инстанса - mediaUrl со страницы инстанса Green Api.
Вот эти четыре параметра на странице инстанса:
Справа от каждого параметра находится кнопка копирования его содержимого.
Создавать заявки или чаты - выбор режима работы канала. Подробнее о режимах работы рассказали в отдельной статье.
Активируйте бегунок "Включен", чтобы активировать канал, и сохраните настройки.