Інтеграція з UniTalk (SMS)

UniTalk відомий у Skynum насамперед телефонією, але вміє й доставляти повідомлення: окрема інтеграція виду «SMS» відправляє через нього ручні SMS, масові розсилки і тригерні сповіщення.

Як працюють розсилки у Skynum

Ця сторінка — про підключення UniTalk як сервісу розсилок. Механіка самих повідомлень описана в розділі SMS-розсилки.

Що потрібно підготувати

• Кабінет UniTalk, у якому в розділі Інтеграція підключено Сервіс відправки повідомлень — без нього API повертає помилку на будь-яку відправку.
• Зареєстровані імена відправника: окремо для SMS і окремо для Viber, якщо плануєте обидва канали.
• Ключ API з кабінету UniTalk. Він спільний для всього проєкту: якщо у вас уже підключена телефонія UniTalk, підійде той самий ключ.

Ключ API у кабінеті UniTalk

1. Увійдіть у кабінет UniTalk.
2. Відкрийте сторінку API особистого кабінету.
3. Натисніть Створити API ключ, якщо ключа ще немає.
4. Скопіюйте ключ: далі він знадобиться для поля Токен у Skynum.

Тримайте ключ у секреті

Цей ключ відкриває доступ і до розсилок, і до телефонії вашого проєкту UniTalk. Нікому його не пересилайте.

Що зробити в Skynum

1. Відкрийте Налаштування → Інтеграції → SMS провайдери.
2. Натисніть Додати інтеграцію.
3. Виберіть UniTalk.
4. Заповніть Назва інтеграції.
5. Увімкніть Інтеграція активна.
6. Виберіть Канал.
7. Вкажіть ім'я відправника вибраного каналу: SMS альфа-ім'я або Viber альфа-ім'я.
8. Вставте ключ API в поле Токен.
9. Натисніть Зберегти.
10. Натисніть Перевірити підключення.

Повідомлення Підключення успішно пройшло перевірку означає, що ключ робочий.

Канали

UniTalk надсилає повідомлення одним із двох каналів на вибір:

• SMS;
• Viber.

Гібридного каналу «Viber + SMS» в API UniTalk немає: повідомлення йде тільки вибраним каналом. Потрібен і той, і той — створіть дві інтеграції UniTalk і вибирайте потрібну в полі Провайдер при відправці.

Viber-канал UniTalk передає лише текст. Якщо в розсилці заповнені зображення чи кнопка, Skynum не відправить її через UniTalk і покаже помилку — щоб вкладення не загубилися мовчки. Для Viber-повідомлень із фото і кнопкою скористайтеся іншим сервісом розсилок.

Що перевірити після підключення

• у кабінеті UniTalk підключено Сервіс відправки повідомлень;
• канал інтеграції відповідає зареєстрованому імені відправника;
• тестове повідомлення на власний номер дійшло, а його статус на картці розсилки оновився;
• у картках клієнтів заповнені телефони й увімкнено Дозволити відправку SMS.

Підсумок

Інтеграція розсилок UniTalk живе поруч із телефонією і використовує той самий ключ API. Канали — SMS або Viber (лише текст), кожен у своїй інтеграції. Про створення повідомлень, шаблони і статуси доставки читайте в розділі SMS-розсилки.