Документация

Сообщения уходят с SIM-карты вашего телефона. Поэтому сначала на телефон ставится приложение SemySMS Connect (Android 7 и новее), а потом каждая SIM привязывается к аккаунту своим кодом.

1. Установите SemySMS Connect из Google Play или файлом APK со страницы приложения. При первом запуске выберите его приложением для СМС по умолчанию: без этого телефон не отправляет задания с сайта.

2. В приложении откройте «Настройки» → «SemySMS Connect» и нажмите «Включить Connect». Приложение покажет, какие данные и когда будут уходить на сайт. Нажмите «Согласен, включить».

   

   

3. Внизу появится вкладка Connect. У каждой SIM на ней свой код привязки, рядом кнопка, чтобы его скопировать.

   

4. На сайте откройте «Устройства» и нажмите «Добавить устройство».

   

5. Введите код и нажмите «Добавить». Каждая SIM становится отдельным устройством со своим ID: для второй SIM повторите с её кодом.

   

Готово: устройство появилось в списке, а в приложении у SIM вместо кода стоят её ID и статус «На связи».

Проверка связи

Отправьте с сайта СМС на тестовый номер +7 000 000‑00‑00. Телефон примет задание, запишет его в журнал на вкладке Connect и сразу сообщит сайту «доставлено». Настоящая СМС при этом не отправляется.

В разделе «Устройства» собраны все подключённые устройства: SIM-карты телефонов и аккаунты WhatsApp и MAX. Каждое устройство - отдельная строка со своим ID.

• ID - номер устройства на сайте. Его указывают в API, чтобы отправить сообщение именно с этого устройства.
• Название устройства - модель телефона и SIM, у мессенджеров - модель и [WhatsApp] или [MAX]. Точка слева зелёная, если устройство на связи и принимает задания, и красная, если нет. Время последней связи - в подсказке у точки. Карандаш справа открывает настройки устройства (раздел 03).
• # - примечание устройства, например «Офис».
• Свойства:
  заряд батареи, во время зарядки рядом молния;
  пауза между сообщениями в секундах, если она задана.
• Версия ПО - метка Connect с версией приложения.
• Оператор - оператор SIM и номер, если он известен. У мессенджеров - WhatsApp или MAX и номер аккаунта.
• Скорость отправки (СМС в минуту) - сколько сообщений в минуту сайт выдаёт устройству. Меняется карандашом.
• Фактическая скорость отправки - сколько сообщений в минуту устройство отправляет на самом деле. Зелёная стрелка рядом - идёт отправка, голубая - приходят отчёты о доставке.
• Сервис в телефоне - «Включен», если устройство принимает задания. «Остановлен» - телефон сейчас не видит эту SIM или из мессенджера вышли: задания не выдаются, ID сохраняется.
• Использовать устройство в рассылке - брать ли устройство в массовые рассылки.
• Включить отчёт о доставке - получать ли подтверждение, что сообщение дошло.
• Лимит СМС - сколько сообщений устройство может отправить за час, сутки или месяц. Рядом - сколько использовано и сколько осталось.

Настройки устройства есть в двух местах: на сайте, в окне «Настройки устройства», и в приложении, в карточке SIM.

На сайте

Карандаш у названия устройства в списке открывает окно «Настройки устройства»:

• Примечание устройства - подпись в колонке #, например «Офис». Её видно и в приложении.
• Настройка оповещения о входящем смс - адрес, на который сайт передаст каждое входящее сообщение этого устройства. Галочка «Отправить тело сообщения» добавляет к оповещению текст.
• WebHook статусов исходящих сообщений - адрес, на который сайт сообщит, что сообщение отправлено и (или) доставлено. Какие статусы передавать, выбирается галочками.
• SemySMS Connect - «Включить работу с WhatsApp» и «Включить работу с MAX» (раздел 04). Этот блок есть только у устройств Connect.

В приложении

На вкладке Connect нажмите на SIM, откроется её карточка:

• Примечание и лимит меняются и здесь, и на сайте.
• Пауза между СМС задаётся здесь, на сайте она видна в колонке «Свойства».
• Отправка в роуминге выключена, пока не включите её переключателем.
• Отправлять на сайт - входящие СМС, СМС с кодами, СМС с коротких и буквенных номеров, входящие звонки. Всё выключено, пока не включите (раздел 06).
• Отвязать от аккаунта - SIM перестанет быть устройством аккаунта и получит новый код привязки и новый ID.

Общие настройки телефона - в «Настройки» → «SemySMS Connect»: временно выключить Connect, мессенджеры, тестовый номер, отвязать телефон от сайта.

Аккаунт WhatsApp или MAX на телефоне с Connect можно сделать отдельным устройством сайта: отправлять с него сообщения с сайта и через API и получать входящие. Отправка через мессенджеры доступна на платном тарифе.

1. Включите на сайте. «Устройства» → карандаш у SIM этого телефона → «Настройки устройства». В блоке «SemySMS Connect» отметьте «Включить работу с WhatsApp» или «Включить работу с MAX» и сохраните.

   Настройки устройства

   SemySMS Connect

   Включить работу с WhatsApp

   Включить работу с MAX

2. Войдите в приложении. «Настройки» → «SemySMS Connect» → «Мессенджеры» → WhatsApp или MAX. Приложение покажет, что будет уходить на сайт, нажмите «Согласен, войти».

   Вход - по QR-коду с другого телефона, где открыт этот аккаунт: в WhatsApp - «Связанные устройства» → «Привязка устройства», в MAX - «Настройки» → «Устройства» → «Войти по QR-коду». Если WhatsApp стоит на этом же телефоне, нажмите «Войти по номеру»: приложение покажет код из 8 знаков, его вводят в WhatsApp.

   

3. Привяжите аккаунт. На вкладке Connect у аккаунта появится свой код привязки. Введите его на сайте так же, как код SIM: «Устройства» → «Добавить устройство».

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

   

Задания на аккаунт отправляются по его ID, как на SIM. «Доставлено» у WhatsApp значит, что сообщение дошло до получателя, у MAX - что получатель его прочитал.

Прокси. Если мессенджер недоступен напрямую, задайте для него прокси SOCKS5 или HTTP: строка «Прокси для WhatsApp» (или MAX) в карточке аккаунта или кнопка на экране входа. Кнопка «Проверить» проверит соединение через прокси.

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

Откройте раздел «СМС» и нажмите «Отправить смс».

Заполните форму:

• Телефон - в международном формате: с плюсом и кодом страны. Несколько номеров - через запятую.
• Устройство - SIM или аккаунт мессенджера, с которого уйдёт сообщение. «Автовыбор» - сайт выберет устройство сам.
• Сообщение - текст. Над полем видно, сколько СМС займёт сообщение.

Сообщение уйдёт, когда устройство на связи: Connect включён, а на вкладке Connect стоит «На связи». В списке устройств у него зелёная точка.

Телефон может передавать в кабинет входящие СМС и звонки. По умолчанию это выключено и включается у каждой SIM отдельно, в приложении.

1. На вкладке Connect нажмите на SIM и в блоке «Отправлять на сайт» включите входящие СМС и, если нужно, входящие звонки.

2. СМС с кодами (для входа и оплаты) и СМС с коротких и буквенных номеров (банки, сервисы, операторы) передаются, только если включить их отдельно, там же.

Входящие видны в разделе «СМС» на вкладке «Полученные СМС и звонки», звонок отмечен как «Входящий звонок». Сообщения WhatsApp и MAX приходят туда же, если включить их в карточке аккаунта (раздел 04).

Чтобы входящие сразу попадали в вашу систему, укажите её адрес в «Настройки устройства» → «Настройка оповещения о входящем смс» (раздел 03).

Входящие СМС передаются, пока SemySMS Connect - приложение для СМС по умолчанию.

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

Чтобы создать группу, нажмите «Создать группу» и введите название.

Группа появится в списке с числом контактов в ней. Кнопки справа - редактировать и удалить.

Контакты можно переносить между группами и удалять по несколько сразу: отметьте их флажками и выберите действие. Чтобы работать со всеми контактами группы, выберите группу или раздел слева.

Чтобы отметить все контакты группы, поставьте флажок рядом с кнопкой «Действия» и нажмите появившуюся ссылку «Выбрать все».

Контакты создаются и редактируются в разделе «Контакты».

Добавить контакт можно вручную или импортом из файла.

Вручную: нажмите «Добавить контакт» и заполните поля. Красным отмечены обязательные и важные поля.

Из файла: откройте вкладку «Импорт».

Импортировать можно тремя способами:

• Файл Excel - таблица Excel;
• Импорт из текста - вставка скопированного текста;
• Текстовый файл - файл без форматирования.

Для Excel выберите «Импорт» → «Импорт из Excel» и в каждом поле укажите букву столбца с этими данными. Красным отмечены обязательные поля, синим - рекомендуемые. Дату рождения храните в Excel в текстовой ячейке в формате ГГГГ-ММ-ДД, например 1990-02-28, иначе она может прочитаться неверно.

Для импорта из текста выберите этот пункт и вставьте данные. Разделители: двоеточие, точка с запятой, запятая, пробел.

Выгрузить контакты можно кнопкой «Экспорт»: в файл Excel или в CSV, который принимает телефонная книга почти любого устройства.

Откройте раздел «Рассылки» и нажмите «Создать рассылку».

Введите название рассылки.

Рассылка появится в списке с основными параметрами. Для полной настройки нажмите «Управление рассылкой».

Укажите период действия, время отправки и число повторов. Можно включить повтор в день рождения, если дата рождения указана у контакта.

Ниже выберите устройство для рассылки и группу контактов, а в последнем поле напишите текст. В тексте можно использовать подстановки из полей контакта:

• [Фамилия], [Имя], [Отчество] - фамилия, имя и отчество получателя;
• [Номер телефона] - его номер;
• случайное число и другие.

Ещё один инструмент - вариативный шаблон. Варианты пишутся в квадратных скобках через вертикальную черту, например [Здравствуйте|Добрый день|Привет]. При отправке они подставляются в сообщения по очереди.

Нажмите «Сохранить рассылку».

Созданная рассылка запускается своей кнопкой включения.

После рассылки бывает нужно повторить отправку на номера, где были ошибки. Для этого есть выборочная рассылка.

В разделе «Рассылки» нажмите «Выборочная рассылка». Кнопка станет активной, когда все сообщения предыдущей рассылки будут отправлены.

В окне четыре фильтра, у каждого три значения:

• Отправленные - переданы на устройство, но ещё не ушли оператору;
• Отправленные фактически - ушли с устройства оператору;
• Доставленные - доставлены получателю;
• Ошибки отправки - отправить не удалось.

Значение «Не важно» - фильтр не учитывается. Число выбранных контактов видно в заголовке окна. Нажмите «Отправить», и сервис создаст новое задание на рассылку.

В разделе «Рассылки» нажмите «Отчет по рассылке» и сохраните файл CSV. Он открывается в Excel как обычная таблица.

Столбцы таблицы:

• A - порядковый номер контакта;
• B - номер телефона;
• C - сколько сообщений нужно отправить;
• D - дата отправки;
• E - сколько отправлено;
• F - сколько доставлено;
• G - сколько ошибок отправки;
• H - текст сообщения.

В разделе «API» нажмите «Создать токен».

Откроется окно параметров токена, обязательные поля отмечены красным:

• Дата окончания - срок действия токена;
• Время отправки - в какие часы отправлять сообщения;
• Лимиты сообщений - сколько сообщений можно отправить по токену. Сверх лимита сообщение не примется, API вернёт ошибку превышения лимита;
• Мгновенная отправка - для премиум-аккаунтов: сообщения уходят сразу, минуя лимиты и ограничения.

Нажмите «Создать». Токен появится в списке с его параметрами, изменить их можно кнопкой редактирования. Методы и параметры - в справочнике API.