Интеграция с сервисом SMSGOROD.RU

Важно! Сервис Автопилот не несет ответственности за проблемы с модерацией / доставкой смс и т.д. Если сомневаетесь в сервисе smsgorod, можете использовать сервис smsc.ru.

Если Автопилот вернул вам ответ success, то это не значит, что СМС будет доставлено вовремя. Это значит, что запрос от АП ушел, а уж сформируется ли смс и будет ли отправлено сообщение, зависит от smsgorod. У сайта smsgorod своя модерация и пока вы ее не пройдете, СМС не будет отправлено.

Итак, сегодня мы настроим интеграцию с сервисом SMS-сообщений smsgorod.ru.

Регистрация проста и понятна. Уверены, что проблем с ней не возникнет.

Для формирования запроса на отправку смс: откройте Управление → API→ Эмулятор запросов

или по этой ссылке.

Тут тоже все понятно. Заполняем данными и формируем запрос.

Важно! СМС не будет отправлена это просто эмулятор, чтобы посмотреть формат данных. Саму инструкцию по API можете прочесть здесь.

Не пугайтесь, отсюда нам нужен только ключ. Пример команды будет ниже.

Команда: «Отправка СМС»

Информация! Команда реагирует на заполнение формы сбора заявок и отправляет запрос для отправки смс в указанное время. В примере, мы указываем плановую отправку запроса во время, которое указано во временной переменной.
Важно! По заявлению техподдержки smsgorod.ru модерация занимает от 30 минут в рабочее время, так что будьте бдительны.

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

События:

Важно! Событие: «Заполнил форму сбора заявок» позволяет собрать у клиента актуальную информацию, например, email или номер телефона.

1) Событие: «Заполнил форму сбора заявок»

Действия:

1) Для записи актуального номера телефона используем действие: «Обновить профиль Автопилота», которое запишет введенный пользователем телефон в профиль Автопилота.

2) Для отправки запроса на формирование смс в определенное время мы можем создать временную переменную %planned% и указать время отправки запроса.

Например, вы создаете команду, которая создает запрос на отправку смс, строго в рабочее время. т.к. модерация у них ручная, об этом говорится в видео. Допустим, мы хотим отправить запрос 14 октября 2022 в 21:30, тогда в переменной пишем следующее:

{date}%s||2022-10-14 21:30{/date}

Данная функция переведет время 2022-10-14 21:30 в UNIX-формат. т.к. smsgorod планирует время только в UNIX-формате. Если не будете использовать отправку запросов в запланированное время, то переменную можно не использовать.

3) В переменной %text% формируем текст приглашения на вебинар. Если вы проходили шаблон для отправки модерации на сайте smsgorod, то убедитесь, что текст сообщения до запятой совпадает с текстом шаблона, иначе будете ждать ручную модерацию.

На тесте шаблон был принят такой:

Привет, %w!
Вот ваша ссылка на веб

А в переменной Автопилота было написано:

 ПРивет, %first_name%!

для smsgoroda - это разный шаблон, поэтому все шаблоны, тесты проводите с техподдержкой сервиса smsgorod.ru, ибо они проверяют каждую запятую. Мы предупредили.

4) Для отправки запроса действием «Отправить POST/GET запрос» методом JSON POST на адрес:

https://new.smsgorod.ru/apiSms/create

с параметрами:

• apiKey = ваш ключ API
• sms.0.channel= char
• sms.0.phone = %phone%
• sms.0.text = %text%
• sms.0.sender = VIRTA
• sms.0.plannedAt= %planned%

Рассмотрим параметры подробнее:

• apiKey - API- ключ вашего аккаунта. В примере: Flh48sDcVZUFqkRdZ6We8ST1UuZIyJSwSl5DXLLtmu6NSMVbL6RVxvSPi9CZ
• sms.0.channel- тип канала для отправки смс. Есть дорогой канал char, а есть альтернативный канал digit

Digit- это:

Неофициальный sms-канал с низкой стоимостью сообщений и нестабильным процентом доставки (от 30% и более). При рассылке возможны задержки в доставке сообщений. Нет возможности использовать своё имя отправителя. Канал рекомендуется для массовых рекламных рассылок с целью охвата большого диапазона номеров. 

• sms.0.phone- номер телефона на который будет отправлена смс. В примере переменная %phone%.
• sms.0.text- текст смс-сообщения. В примере переменная %text%.
• sms.0.sender- подпись для смс-сообщения. В примере VIRTA.
• sms.0.plannedAt- время планируемого отправления запроса. Если вы хотите, чтобы запрос на модерацию и отправку смс уходил сразу, то не указывайте параметр. В примере время 2022-10-14 21:30 указанное в unix-формате.

5) Для того, чтобы проверить статус запроса во временной переменной %stat%через JSON.PATH достаем статус запроса:

%response.status%

6) Опционально: для того, чтобы сохранить текст отправляемого сообщения из запроса во временной переменной %mess%через JSON.PATH достаем его:

%response.data.0.message%

7) Действием: «Отправить сообщение» отправляем сообщение сотруднику с текстом:

#ответ_смсгорода
Клиент: %vk_link%
Ответ сервера: %response%

Статус: %stat%
Сообщение: %mess%
Время отправки в юникс: %planned%

8) Действие: «Прервать/продолжить выполнение команды» с переключателем продолжено, если временная переменная %stat% содержит error

Поясним: допустим, что у вас не хватает денег на балансе и smsgorod по какой-то причине вернул ошибку, т.е. errorв таком случае, вы оперативно уведомите сотрудников и решите проблему. Дальнейшие блоки будут выполняться только если есть ошибка от smsgorod.

9) Опционально: для уведомления о проблемах действием «Отправляем сообщение» сотруднику текст с нужным текстом:

Проверь баланс

Важно! Всю информацию о тарифах, о мобильных операторах и т.д. можно уточнить в техподдержке smsgorod.ru.
Если при отправке запроса, ответ сервера smsgorod, вернул вам ответ success, то это не значит, что СМС будет доставлено вовремя (это значит, что запрос от АП ушел, а уж сформируется ли смс и будет ли отправлено сообщение, зависит от smsgorod).

На этом все. Тестируем.

Проверяем в кабинете smsgorod.ru

Пару слов про шаблоны. Можете попытаться пройти модерацию для мгновенной передачи сообщений по этой ссылке, может вам повезет больше, чем Андрею.

Творческих взлетов и успешного внедрения!