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

MS Excel Max интеграция версия 2.0

Для рассылки файлов выполните следующие действия:

1. Начало работы#

• Откройте окно Методы API и заполните вкладку Параметры по инструкции

• Перейдите на лист Отправка файлов

2. Заполните столбцы:#

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

Столбец C - Идентификатор чата (номер клиента)#

В ячейках этого столбца указываются номера получателей сообщения.

• Для отправки на личный номер указывается chatID (номер телефона в международном формате)
• Для отправки в группу указывается groupID.

Как быстро выгрузить контакты с аккаунта?

Для автоматической выгрузки контактов в таблицу:
1. Откройте окно Методы API
2. Откройте страницу Отправка файлов
3. В ячейке Выгрузить контакты выберите необходимый вариант:
- "Все контакты" - в таблицу выгрузятся все контакты аккаунта (группы и личные чаты)
- "Личные чаты" - в таблицу выгрузятся все личные чаты аккаунта (группы не будут выгружаться)
- "Группы" - в таблицу выгрузятся все группы акканта (личные чаты не будут выгружаться)
- "Ранее был чат" - в таблицу выгрузятся все контакты, с которыми была переписка
- "Сохранённые" - в таблицу выгрузятся все контакты, сохранённые в контактной книге аккаунта
4. Нажмите кнопку Выгрузить контакты

Столбец D - Идентификатор чата (личный, группа)#

Заполняется для определения, является ли идентификатор в ячейке слева личным или групповым.

• Если слева указан личный номер, то в ячейку пишется личный
• Если слева указана группа, то в ячейку пишется группа

Столбец E - Ссылка на файл#

Ссылка на отправляемый файл.

Как получить ссылку на файл?

Для получения ссылки на файл, нажмите на кнопку Методы APIи откройте лист Параметры.
Внизу окна нажмите на кнопку Выгрузить файл

После выбора файла с устройства, появится окно Выполнено.
Нажмите Скопировать ссылку, чтобы скопировать полученный адрес файла.

Вставьте ссылку в ячейку столбца E - Ссылка на файл

Максимальный размер отправляемых файлов равен 100 Мбайт.
Список файловых форматов, которые успешно отправляются и принимаются через API

Столбец F - Название файла с расширением#

Название файла с указанием его расширения.
Примеры: file.docx / photo.jpeg / picture.png / sheet.xlsx / voice.mp3 / song.aac

Столбец G - Описание#

В ячейках указывается текст отправляемого сообщения.
Перенос строки в ячейке оформляется символом \n

• Как правильно форматировать текст
• Как отправлять смайлики и эмодзи

Необязательные столбцы: A, B

• Столбец A - №

Заполняется для наглядности порядкового номера строки.

• Столбец B - Пользователь (Имя, почта)

Заполняется для идентификации указанных номеров по имени, почте или другим данным.

При необходимости включите проверку номера#

Для проверки наличия WhatsApp аккаунта на номере откройте окно Методы API и включите чекбокс Проверка номера

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

После отправки сообщений вы получите статус
{"existsWhatsapp":false} либо {"existsWhatsapp":true}:
- false - означает, что на номере нет аккаунта WhatsApp или в номере допущена ошибка;
- true - означает, что на номере есть аккаунт WhatsApp.

3. Начните рассылку#

После заполнения всех необходимых ячеек откройте окно Методы API на странице Отправка файлов и нажмите кнопку Начать рассылку

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

После окончания рассылки появится окно с оповещением. Не выключайте таблицу до пояления этого окна.

Как остановить рассылку#

Чтобы остановить рассылку, нажмите Остановить рассылку на странице Отправка файлов

• Чтобы очистить очередь сообщенй на отправку, нажмите Очистить очередь на странице Отправка файлов.

  Рекомендуем нажимать данную кнопку перед запуском рассылки.

Столбец F - Наличие аккаунта WhatsApp

В ячейках указывается наличие/отсутствие WhatsApp аккаунта на номере.

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

Для осуществления проверки при рассылке установите чекбокс в окне Методы API - Отправка файлов

Столбец G - Статус сообщения#

В ячейках указывается статус сообщения. Возможные статусы:

• Сообщение отправлено - сообщение было успешно отправлено
• Сообщение НЕ отправлено - сообщение не было отправлено

Столбец H - Тело ответа (id сообщения)#

Содержит ID сообщения при успешной отправке и описание проблемы при ошибке.

• В случае отправки: {"idMessage":"id вашего сообщения"}
• В случае ошибки: Отсутствует Whatsapp аккаунт

Статистика сообщений#

Для проверки статусов сообщений необходимо включить уведомления в вашем личном кабинете.
Применение новых настроек может занять до 5 минут.

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

Откройте окно Методы API и на странице Отправка файлов нажмите кнопку Статус сообщений

Возможные статусы:
- sent - сообщение отправлено
- delivered - сообщение отправлено
- read - сообщение прочитано
- Сообщение не найдено - сообщение находится в очереди на отправку либо было отправлено на несуществующий аккант

Для обновления статусов отправленных сообщений нажмите кнопку Обновить статистику

Подробнее о статусах можно узнать в нашей статье "Какие бывают статусы сообщений в WhatsApp?"

Как удалить отправленные сообщения#

Чтобы удалить сообщения, отправленные из таблицы:

1. Откройте окно Методы API
2. Откройте страницу Отправка файлов
3. Установите чекбокс рядом с кнопкой Удалить сообщения
4. Нажмите кнопку Удалить сообщения

После удаления выходит окно "Выполнено", а статус сообщения меняется на Сообщение удалено

Как быстро очистить лист#

Чтобы очистить текущий лист:

1. Откройте окно Методы API
2. Откройте страницу Отправка файлов
3. Установите чекбокс рядом с кнопкой Очистить таблицу
4. Нажмите кнопку Очистить таблицу

В окне-предупреждении подтвердите своё намерение очистить таблицу.

После удаления выходит окно "Выполнено", а статус сообщения меняется на Сообщение удалено

Как добавить контакты в группу#

Чтобы добавить номера в группу

1. Создайте группу с устройства или через API методом createGroup
2. Заполните столбец C - Идентификатор чата (номер клиента). Остальные столбцы можно оставить пустыми.

1. Откройте окно Методы API
2. Откройте страницу Отправка файлов
3. Введите ID созданной группы в поле Идентификатор группы
4. Нажмите кнопку Добавить в группу

После окончания добавления появляется окно "Выполнено"

В столбце H - Тело ответа будет указан результат добавления:

• Почему участник не добавляется в группу?