Налаштування SMS процесингу

Ви можете надсилати SMS повідомлення через свого постачальника послуг за допомогою процесингу в нашій системі. Для цього вам потрібно налаштувати параметри відправника у своєму профілі. Постачальника підключають через HTTP-інтеграцію, за налаштуваннями, описаними нижче; давніше SMPP-підключення для нових налаштувань не пропонується.

Статус доставки ми отримуємо від провайдера: якщо він повідомив Доставлено, такий статус видно і в звіті. На маршрутах із кількома посередниками — наприклад, у США — повідомлення після цього статусу все одно може не дійти, і визначити, на якому етапі воно загубилося, неможливо. Для критичних повідомлень, як-от коди входу чи відновлення пароля, підключіть процесинг локального провайдера.

Налаштування параметрів відправника

Щоб налаштувати процесинг SMS для зареєстрованих відправників:

1. Перейдіть у свій обліковий запис → Налаштування → Відправники.
2. Виберіть вкладку SMS і натисніть кнопку Новий відправник.

3. У вікні Новий відправник, виберіть опцію Я вже уклав контракт із постачальником послуг і маю зареєстрованого відправника та виберіть свого постачальника послуг зі списку.

4. Введіть необхідні технічні параметри вашого провайдера, як зазначено нижче:

GMS Hyber

• Ім'я відправника
• Логін
• Пароль
• URL
• Таймаут

Використовуйте мітки eSputnik, щоб при вивантаженні звітів з GMS Hyber можна було легко проаналізувати, скільки повідомлень певного типу було надіслано: збір відгуків, встановлення застосунку тощо. Якщо у повідомленні використовується більше однієї мітки, у звіт вони підставляються через кому: tag=tag1, tag2, tag3.

Попросіть GMS Hyber додати IP адреси 52.210.222.17 та 52.16.166.210 до списку дозволених.

Infobip

• Ім'я відправника
• Логін
• Пароль
• Альфа-ім'я

TurboSMS

• Ім'я відправника
• Токен авторизації

Щоб отримувати статуси повідомлень, додайте наступне посилання у своєму кабінеті TurboSMS: https://esputnik.com/dlr/v2/turbosms/status

Omnicell

• Ім'я відправника
• Логін
• Пароль

Щоб отримувати статуси повідомлень, додайте наступне посилання у своєму кабінеті Omnicell: https://esputnik.com/dlr/v1/omnicell/status

Textlocal

• Ім'я відправника
• Ключ API

Щоб отримувати статуси повідомлень, додайте наступні параметри у своєму кабінеті Textlocal:

• для поля https://: esputnik.com/dlr/v1/textlocal/status
• для поля Port: 443

Acemount Media

• Ім'я відправника
• Токен авторизації

Щоб отримувати статуси повідомлень, в обліковому записі Acemount Media у полі Sms URL report додайте посилання https://esputnik.com/dlr/v1/acemount/status

Twilio

• Ім'я відправника
• Account SID
• Токен авторизації

Щоб отримувати статуси повідомлень, додайте наступне посилання у своєму обліковому записі Twilio: https://esputnik.com/dlr/v1/twilio/status

SMSBAT

• Ім'я відправника
• Логін
• Пароль
• Таймаут

Streamtools

• Ім'я відправника
• Логін
• Пароль

Vodafone

• Ім’я відправника (може бути будь-яким, бо відображатиметься лише в адмінці eSputnik).
• Логін.
• Пароль.
• ID відправника — ID відправника з облікового запису Vodafone. Отримувачі повідомлень бачитимуть ім’я відправника, що відповідатиме цьому ID. Зверніть увагу: ID відправника для SMS та Viber різні.

Intel Telecom

• Ім'я відправника. Ви можете знайти це ім'я в меню Альфа Імена в Intel Telecom.
• User name. Це - ім'я користувача для входу в акаунт Intel Telecom.
• API ключ. Створити API ключ в Intel Telecom ви можете в меню Розробники → API ключі.

PROCONTEXT

Провайдер підтримує розсилку повідомлень лише на молдавські номери. Є два типи повідомлень:

• Сповіщення — важливі тригери, відправляються цілодобово і максимально швидко; контент сповіщень потрібно узгоджувати з провайдером.
• Маркетингові — рекламні повідомлення, які відправляються лише в бізнес-час; не потребують узгодження з провайдером.

Параметри для створення відправника:

• Alias — альфа-ім'я;
• Partner‘s ID — логін;
• Пароль.

Щоб підключити PROCONTEXT, залиште заявку на [email protected].

Decision Telecom

Параметри для створення відправника:

• Ім'я відправника
• Токен авторизації — ключ з облікового запису Decision Telecom у форматі BASE64
• Альфа-ім'я

Щоб підключити Decision Telecom, залиште заявку на [email protected].

AlphaSMS

Параметри для створення відправника:

• Ім'я відправника
• API-ключ

Генерування API-ключа

1. У кабінеті AlphaSMS відкрийте Налаштування → Профайл → API.
2. Натисніть Згенерувати новий.
3. У полі Коментар укажіть назву, за якою ви впізнаєте ключ.
4. За потреби заповніть Білий список IP-адрес: адреси IPv4 та IPv6 або підмережі через кому. Порожнє поле означає, що ключ приймається з будь-якої адреси.
5. Лишіть перемикач Активний увімкненим і натисніть Виконати.
6. У вікні Ваш ключ натисніть Копіювати. У списку ключ показується скороченим, тому скопіюйте значення одразу.

Новий ключ з'явиться у списку зі статусом Активно.

ServerSMS

Параметри для створення відправника:

• Ім'я відправника
• User name (ім'я користувача для входу в акаунт ServerSMS).
• Пароль.

SMS Club 2.0

Параметри для створення відправника:

• Ім’я відправника
• Токен авторизації

5. Натисніть Готово.

Тепер ви можете перейти до створення та відправлення SMS-повідомлень. Щоб дізнатися більше, прочитайте цю статтю.

В одному акаунті можна налаштувати кілька відправників із процесингом — повторіть ці кроки для кожного. Якщо провайдер один, у кожного відправника має бути власне альфа-ім'я, зареєстроване на боці провайдера. SMS Club і SMS Club 2.0 — різні провайдери, тому те саме альфа-ім'я можна додати для обох. Потрібного відправника ви обираєте в налаштуваннях повідомлення.

Короткі посилання в SMS

Посилання в SMS скорочуються через домен esclick.me. Скорочене посилання буває довшим, ніж у звичайних скорочувачів на кшталт Bitly, і це впливає на кількість символів, а отже на кількість частин SMS — враховуйте це, коли плануєте довжину повідомлення.

Щоб посилання були коротшими й упізнаваними, додайте власний домен для скорочення посилань. Це налаштування рівня акаунта: воно застосовується до всіх каналів і всіх відправників, зокрема до SMS. Окремого домену для одного відправника чи однієї розсилки не буває.

Зберігайте протокол https:// у посиланнях: без нього багато застосунків для повідомлень не розпізнають текст як клікабельне посилання.

Статус «Невідомо»

«Невідомо» — це проміжний статус: SMS-провайдер ще не повернув ані підтвердження доставлення, ані помилки. Провайдер може передати фінальний статус із затримкою — після цього статус повідомлення оновлюється, наприклад, на «Доставлено».

Статус SMS_UNDELIVERABLE_STATE

SMS_UNDELIVERABLE_STATE — це узагальнений статус недоставлення, який повертає оператор або постачальник SMS, а не конкретна детальна причина. Він може означати неіснуючий чи заблокований номер, вимкнений телефон або відсутність мережі, непідтримувану країну чи інші причини на боці постачальника. Точну причину потрібно шукати в логах самого постачальника.

Помилка SMS_GENERAL_ERROR

SMS_GENERAL_ERROR може означати, зокрема, що номер отримувача перебуває в чорному списку оператора — наприклад, після скарги абонента операторові. Щоб з'ясувати причину і зняти блокування, зверніться до служби підтримки: [email protected].

Помилки постачальника в розсилці

Якщо ви відправляєте через власного постачальника, він може відхилити повідомлення. Таке повідомлення не доходить до отримувача — воно потрапляє в помилки розсилки, а рядок помилки у звіті містить відповідь самого постачальника, тому причина читається там. Порожній баланс на боці постачальника, наприклад, повертається як REQUIRED_BALANCE.

Повторно такі повідомлення не відправляються автоматично, і зняття розсилки з паузи їх не перезапускає. Усуньте причину, яку називає відповідь, наприклад, поповніть баланс постачальника, а потім експортуйте контакти з помилок розсилки в групу й запустіть на цю групу нову розсилку.

Видалення відправника

Щоб видалити відправника: 

1. Перейдіть у свій обліковий запис → Налаштування → Відправники. 
2. Виберіть вкладку SMS і натисніть на значок Видалити праворуч від імені відправника, якого необхідно видалити.

3. У діалоговому вікні виберіть Видалити. На короткий час з’явиться повідомлення про підтвердження.

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

Видалення відправника саме по собі не гарантує зупинку надсилання SMS. Ім'я відправника копіюється у SMS-повідомлення в момент його збереження і залишається в ньому як текстове значення, тому розсилки чи API-запити, що посилаються на це повідомлення, можуть продовжувати надсилатися через тригери, ресурс Send prepared message чи інші API-запити навіть після видалення відправника. Щоб припинити такі відправлення, зупиніть API-запити на боці вашої інтеграції або видаліть відповідні SMS-повідомлення в акаунті. Щоб надійно зупинити всі SMS-розсилки в акаунті, зверніться в службу підтримки — це потрібно робити на рівні акаунту, а не через налаштування відправників чи повідомлень в інтерфейсі.

Зміна відправника SMS

Щоб змінити відправника для наявних SMS повідомлень:

1. Виберіть меню Повідомлення → Повідомлення → SMS та оберіть SMS повідомлення.

2. У розділі Основні параметри, розгорніть список Відправник і виберіть зі списку іншого відправника для цього повідомлення.