Як надсилати SMS клієнтам: підключення сервісу

6 хв

Смс розсилка клієнтам в Elbuz іде через ваш сервіс SMS: ви один раз вписуєте ключ сервісу, а далі SMS ідуть самі — з процесів, із замовлення, про покинутий кошик і з кодом підтвердження для AI-підтримки.

Коли це знадобиться:

  • Клієнт має дізнатися, що замовлення відправлено — процес надсилає SMS із номером замовлення, щойно менеджер змінив статус.
  • Клієнти не читають SMS, зате читають Viber — повідомлення йде спершу у Viber, а якщо не доставлене — звичайним SMS.
  • SMS «не дійшло», а чому — незрозуміло — журнал відправок показує кожну спробу й відповідь сервісу: немає грошей, невірне альфа-ім'я, немає телефону.

З чого почати: виберіть сервіс і вставте ключ, потім натисніть «Надіслати тест».

Що вміє розсилка SMS

Де це і хто має доступ

Окремого пункту меню в розсилки немає: форма живе серед інших інтеграцій, у групі «Телефонія».

Відкрити
Кабінет → Налаштування системи → «Інші налаштування» → «Зовнішні сервіси та інтеграції»
Рядок
група «Телефонія» → «Рассылка SMS» → олівець у рядку
Право доступу
вікно «API та токени доступу» у «Правах груп»
Підготувати
кабінет у сервісі SMS, його API-ключ і зареєстроване альфа-ім'я
Група «Телефонія» у вікні «Зовнішні сервіси та інтеграції» з рядком «Рассылка SMS»
1Рядок «Рассылка SMS»
2Олівець «Редагувати»
  1. Рядок «Рассылка SMS» стоїть у групі «Телефонія» поруч з операторами телефонії.
  2. Олівець у рядку відкриває форму налаштування SMS.

Як підключити сервіс SMS

Підключення — це три поля: сервіс, ключ і відправник. Форма зберігає зміни сама, кнопки «Зберегти» немає: унизу вікна з'являється «Збережено».

  1. У списку «Сервіс» виберіть свій сервіс. Форма покаже поля саме для нього.
  2. Вставте ключ із кабінету сервісу — назви полів у таблиці нижче.
  3. Впишіть «Відправник (альфа-ім'я)» (детальніше).
  4. Надішліть тестове SMS на свій номер.
Картка «Сервіс SMS» у формі «Налаштування - Рассылка SMS»
1Сервіс
2API-токен
3Відправник (альфа-ім'я)
4Транслітерація
5Документація API сервісу
  1. Сервіс — вибір SMS-провайдера, тут TurboSMS.
  2. API-токен — ключ із кабінету сервісу; збережений ключ не показується, поле лишають порожнім.
  3. Відправник (альфа-ім'я) — ім'я, зареєстроване в сервісі.
  4. Транслітерація — надсилання латиницею, щоб довге повідомлення не розбивалось на кілька SMS.
  5. Документація API сервісу — посилання на опис API провайдера.
Що вписати для кожного сервісу
СервісПоля ключаViber
TurboSMS«API-токен»так
AlphaSMS«API-ключ»так
eSputnik«API-ключ»так
SendPulse«Client ID» і «Client Secret»ні
Kyivstar Business«Client ID» і «Client Secret»так
Infobip«Base URL (xxxxx.api.infobip.com)» і «API-ключ»так
Twilio«Account SID» і «Auth Token»ні

Під полями є посилання «Документація API сервісу» — воно веде на сторінку вибраного сервісу, де пояснено, де взяти ключ.

Ключ після збереження

Збережений ключ у форму не повертається: поле порожнє, а в ньому підказка «збережено — залиште порожнім». Порожнє поле означає «не змінювати». Щоб замінити ключ, вставте новий.

Якщо змінити сервіс і не вписати новий ключ, старий ключ стирається: ключ одного сервісу іншому не підходить.

Відправник (альфа-ім'я)

Альфа-ім'я — назва, яку клієнт бачить замість номера, наприклад назва магазину латиницею. Впишіть те, яке зареєстровано у вашому кабінеті сервісу, до 20 символів. Незареєстроване ім'я сервіс зазвичай відхиляє, і причина з'явиться в журналі.

Для Twilio в це поле вписується ваш номер Twilio.

Транслітерація

Перемикач «Транслітерація» переводить текст SMS і Viber на латиницю. За замовчуванням вимкнено. Одне SMS кирилицею вміщує 70 символів, латиницею — 160, тож довгі повідомлення латиницею розбиваються на менше частин.

Як надсилати спершу Viber, а потім SMS

Повідомлення може йти спершу у Viber, а якщо Viber не доставлений — звичайним SMS. Це вміють TurboSMS, AlphaSMS, eSputnik, Kyivstar Business та Infobip; для інших сервісів картки «Viber» у формі немає.

  1. Увімкніть «Надсилати через Viber».
  2. Впишіть «Відправник Viber» — ім'я, яке для вас зареєстрував сервіс.
  3. За потреби задайте «Час життя, с» — скільки секунд сервіс чекає доставки у Viber, перш ніж надіслати SMS.

Текст Viber той самий, що й у SMS. Відправника Viber реєструє сам сервіс, у програмі його створити не можна.

Картка «Viber» у формі налаштування SMS
1Надсилати через Viber
2Відправник Viber
3Час життя, с
  1. Надсилати через Viber — спершу Viber, а якщо він не доставлений, то SMS; перемикач вимкнено.
  2. Відправник Viber — ім'я відправника, яке реєструє сервіс.
  3. Час життя, с — скільки секунд намагатись доставити Viber, перш ніж перейти на SMS.

Як перевірити, що SMS доходять

У картці «Перевірка» впишіть свій номер у форматі 380XXXXXXXXX і натисніть «Надіслати тест». Прийде SMS «Тестове повідомлення від» і назва вашого магазину.

Тест іде тим самим шляхом, що й SMS із процесів і замовлень. Якщо сервіс відмовив, під кнопкою з'явиться «SMS не надіслано» і причина, а в журналі — рядок «помилка».

Щоб налаштувати процеси, не витрачаючи гроші, виберіть у списку «Сервіс» «Тестовий режим (лише запис у журнал)». SMS тоді нікуди не йдуть, а кожна відправка записується в журнал як надіслана. Перед роботою з клієнтами поверніть справжній сервіс.

Картки «Перевірка» та «Журнал відправок» у формі налаштування SMS
1Телефон
2Надіслати тест
3Рядок «надіслано»
4Рядок «помилка» з причиною
  1. Телефон — номер, на який піде тестове повідомлення (380670000001).
  2. Надіслати тест — відправляє тест тим самим шляхом, що й реальні відправки.
  3. Рядок «надіслано» — повідомлення прийняте сервісом.
  4. Рядок «помилка» — у результаті видно причину відмови сервісу.

Як дізнатися, чому SMS не дійшло

Картка «Журнал відправок» у тій самій формі показує останні 30 відправок з усіх місць програми, новіші зверху: час, сервіс, телефон і результат. У рядку «помилка» поруч стоїть причина — текст програми або відповідь сервісу.

«надіслано» означає, що сервіс прийняв повідомлення. Чи дійшло воно до телефону, видно в кабінеті сервісу.

Розбір частих причин — у розділі «Що робити, коли SMS не надсилається».

Звідки програма надсилає SMS

Усі відправки йдуть через сервіс із цієї форми. Не вибрано сервіс — не піде жодне SMS, і кожне місце покаже помилку.

ЗвідкиКоли йде SMSКуди
Процеси, дія «Надіслати SMS»коли спрацювало правило, наприклад змінився статус замовленнятелефон із замовлення, якщо там порожньо — з картки клієнта
Картка замовлення, «Надіслати» → SMSменеджер править текст і надсилає вручнутелефон у вікні відправки
Покинуті кошикипокупець залишив товари в кошику; текст до 160 символів пише AIтелефон, залишений на сайті
AI-підтримка, код підтвердженняклієнт просить змінити замовлення з каналу, який не підтверджує особутелефон із замовлення

Сценарії

Перше підключення TurboSMS

Що зробити. Виберіть «TurboSMS», вставте «API-токен» із кабінету TurboSMS, впишіть зареєстроване там альфа-ім'я і надішліть тест на свій номер.

Що вийде. На телефон прийде тестове SMS від вашого альфа-імені, у журналі з'явиться рядок «надіслано». З цієї миті SMS надсилають процеси й замовлення.

Клієнти частіше читають Viber

Що зробити. У TurboSMS або AlphaSMS увімкніть «Надсилати через Viber» і впишіть «Відправник Viber».

Що вийде. Клієнт із Viber отримує повідомлення у Viber, решта — звичайне SMS. Сервіс сам досилає SMS, якщо Viber не доставлено.

Налаштувати процеси без витрат

Що зробити. Виберіть «Тестовий режим», налаштуйте правила процесів і перевірте журнал відправок.

Що вийде. Видно, кому й коли пішло б SMS, а клієнти нічого не отримують. Потім поверніть справжній сервіс.

Що робити, коли SMS не надсилається

Помилки в журналі відправок
Що ви бачитеЧому такЩо зробити
«Сервіс SMS не вибрано»у списку «Сервіс» стоїть «Не вибрано»виберіть сервіс і вставте ключ (підключення)
«Немає номера телефону.»у замовленні й картці клієнта порожній телефон, або в тесті номер коротший за 10 цифрдодайте телефон у замовлення чи картку клієнта
«Порожній текст SMS.»у дії процесу чи вікні відправки не заповнено текствпишіть текст повідомлення
«Документ або контрагента не знайдено.»замовлення чи клієнта видалили до відправкиперевірте, чи запис існує
«Сервіс SMS не підтвердив відправку.»сервіс не відповів «прийнято»перевірте ключ, баланс і альфа-ім'я в кабінеті сервісу
текст англійською від сервісусервіс відмовив: невірний ключ, немає грошей, незареєстроване альфа-ім'явиправте причину в кабінеті сервісу і надішліть тест ще раз

Часті запитання

Скільки коштує SMS?

Elbuz за SMS нічого не списує: ви платите сервісу за його тарифами з власного рахунку. Витрати видно в кабінеті сервісу.

У списку сервісу написано «більше не підтримується». Що робити?

Це сервіс, який був підключений раніше і якого вже немає в списку. Виберіть сервіс зі списку і вставте його ключ (підключення).

Чи можна підключити два сервіси одночасно?

Ні. Усі відправки йдуть через один вибраний сервіс; запасний сервіс задати не можна.

У журналі «надіслано», а клієнт SMS не отримав. Чому?

Сервіс прийняв повідомлення, але доставка відбувається вже в нього. Статус доставки дивіться в кабінеті сервісу.

Чи можна вставити в SMS номер і суму замовлення?

Так, у тексті дії процесу підставляються поля замовлення й клієнта — так само, як у шаблоні листа (поля команди).

Суміжні теми

Чи була стаття корисною?