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

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

Информация

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

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

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

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

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

  1. Установите мобильное приложение WhatsApp
  2. Пройдите регистрацию в личном кабинете
  3. Создайте и авторизуйте инстанс
  4. Получите параметры доступа к инстансу

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

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

**Скачать версию 2.0**

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

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

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

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

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

propirtes

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

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

enable editing

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

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

enable content

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

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

  • idInstance
  • apiTokenInstance
  • mediaUrl
  • apiUrl

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

parameters

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

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

authorization

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

not-authorized

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

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

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

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

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

ready

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

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

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

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

delay

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

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

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

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

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

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

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

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

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

qr1

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

qr2

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

qr3

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

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

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

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

phone1

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

phone2

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

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

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

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

logout

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

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

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

reboot