Интеграция WhatsApp с MS Excel#

Информация

MS Excel интеграция версия 2.0 с расширенным функционалом, описание всех возможностей ниже в статье.
Если вам достаточно только выполнить рассылку и получить статус отправленных сообщений, воспользуйтесь Lite версией

MS Excel интеграция версия 2.0, далее просто интеграция

Минимальные требования#

MS Excel версии 2016 и выше
ОС Windows версии 10 и выше (Поддержка Windows 7 прекращена 14 января 2020, поэтому при использовании таблицы на более ранних версиях ОС могут наблюдаться ошибки, связанные с актуальностью ПО)

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

Порядок настройки интеграции:#

1. Скачайте таблицу MS Excel#

Версия с возможностью редактирования для разработчиков Excel

Мы настоятельно рекомендуем использовать актуальную версию, если вы не умеете программировать в MS Excel.
Данная версия предоставлена для клиентов, желающих изучить код интеграции более подробно.
Скачать версию таблицы для редактирования.

2. Разблокируйте полученный из сети файл#

Откройте свойства файла с помощью правой кнопки мыши.
Установите галочку в чек-боксе «Разблокировать».
Нажмите на кнопку «Применить», после этого на кнопку «Ok».

Если вам не удается разблокировать файл, попробуйте переместить его в рабочую папку.

3. Разрешите редактирование файла#

При появлении предупреждения о защищённом просмотре, нажмите на кнопку "Разрешить редактирование"

4. Разрешите выполнение содержимого макроса#

При появлении предупреждении от системы безопасности нажмите на кнопку "Включить содержимое"

5. Заполните необходимые данные для авторизации#

В открывшемся окне выберите вкладку Parameters и добавьте следующие данные из вашего личного кабинета GREEN-API:

idInstance
apiTokenInstance
mediaUrl
apiUrl

При сворачивании таблицы введённые данные могут сброситься. Это особенность MS Excel, рекомендуем при заполнении данных сворачивать не таблицу, а браузер.

Если окно не открылось автоматически, нажмите на кнопку Методы API, чтобы открыть его вручную.

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

Возможные ошибки

Инстанс не авторизован. Необходимо подключить инстанс к WhatsApp аккаунту.

Проверьте правильность указанного apiTokenInstance

Проверьте правильность указанного idInstance

Проверьте правильность указанных apiUrl и mediaUrl

При корректном заполнении полей возникнет окно "Выполнено":

Важная информация. Рекомендации по рассылке.

Параметр "Задержка между сообщениями" отвечает за скорость отправки запросов из заполненной таблицы Excel.

Для изменения задержки отправки сообщений из очереди используйте метод SetSettings с параметром delaySendMessagesMilliseconds (см. примеры). Измените задержку отправки сообщений с 500 миллисекунд на 10-15 секунд (10000 мсек - 15000 мсек).

После этого измените значение «Задержка между сообщениями» при отправке в очередь на листе Параметры с 10 секунд на 1 секунду для наиболее быстрой обработки таблицы.

Примеры использования таблицы Excel:#

Как сделать рассылку текстовых сообщений

Как сделать рассылку файлов

Авторизация инстанса через таблицу Excel:#

Откройте на своем мобильном телефоне приложение WhatsApp Business или WhatsApp. На устройстве перейдите в раздел Привязка устройства, для этого:

На Android нажмите на 3 точки -> Связанные устройства -> Привязка устройства
На iPhone перейдите в Настройки -> Связанные устройства -> Привязка устройства

Авторизация через QR:

В окне Методы API откройте вкладку Параметры и нажмите на кнопку Получить qr в браузере.

У вас должны быть заполнены Параметры инстанса

Автоматически будет сформирована и скопирована ссылка для получения QR кода

Откройте ссылку в любом браузере и нажмите кнопку Get QR. Отсканируйте код телефоном.

Авторизация по коду:

В окне Методы API откройте вкладку Параметры.

У вас должны быть заполнены Параметры инстанса
В блоке "Способы авторизации инстанса" введите подключаемый номер телефона, после чего нажмите Авторизовать по номеру

Автоматически будет сформирован код для подключения номера.

Нажмите на всплывающее уведомление от WhatsApp > Введите код.
Разблокируйте телефон (если у вас включён механизм защиты) и введите на основном устройстве восьмизначный код.

Подробнее читайте в нашей статье "Как выполнить привязку устройства?".
Также рекомендуем ознакомится со статьей "Почему не получается связать устройство с API?".

Как сменить номер телефона?#

Чтобы отключить текущий номер установите чекбокс рядом с кнопкой Выполнить раазлогин и нажмите на неё.
Таким образом номер телефона будет отключен от инстанса, и вы сможете подключить другий номер.

Как перезагрузить инстанс?#

Кнопка Перезагрузить инстанс нужна, чтобы перезапустить инстанс при возникновении прблем с авторизацией или в работе инстанса.

Для перезапуска инстанса на листе Параметры нажмите Перезагрузить инстанс