У цій статті ви дізнаєтесь як створити необхідний акаунт в Twilio, як налаштувати та підключити функцію SMS by Twilio до RemOnline.
Що таке Twilio?
Twilio - це платформа з комунікаційних API, яка дозволяє розробникам і компаніям легко інтегрувати засоби зв'язку, такі як телефонія, SMS, чати та відео, у свої додатки та вебсайт. За допомогою Twilio можна надсилати текстові повідомлення, здійснювати телефонні дзвінки, налаштовувати автоматичні відповіді та багато іншого. Нам Twilio допоможе інтегрувати функцію SMS в RemOnline.
Створення акаунту Twilio
Що потрібно для початку?
Платний акаунт Twilio. Нові користувачі можуть створити безкоштовний акаунт і перейти на платну версію. Дізнатись про те, як перейти на платну версію можна у статті Як оновити акаунт і купити номери у Twilio у розділі Як перейти на платну версію акаунта Twilio?
Номер телефону Twilio. Дізнатись про те, як купити номер телефону Twilio можна у статті Як оновити акаунт і купити номери у Twilio у розділі Як купити номер Twilio?
Важливо: на даний момент купівля українського номера неможлива у Twilio, тому підключення SMS by Twilio до Remonline недоступне, якщо ви перебуваєте в Україні та хочете використовувати український номер. Якщо ви перебуваєте в іншій країні, ви можете придбати та використовувати номер телефону з кодом цієї країни, якщо такі номери доступні.
Наступний крок для підключення SMS до RemOnline – створення Messaging Service.
Створення Messaging Service
Щоб створити Messaging Service, перейдіть у розділ Messaging > Services і натисніть Create Messaging Service.
Крок 1. Визначте назву та мету сервісу
Messaging Service friendly name – придумайте назву своєму Messaging Service (наприклад Order Chats)
Зверніть увагу: ця назва відображатиметься лише у Twilio. Ваші клієнти при отриманні повідомлень бачитимуть лише номер, з якого отримали SMS.
Select what you want to use Messaging for – оберіть функцію, яка найкраще підходить для ваших чатів.
Натисніть Create Messaging Service.
Крок 2. Додайте номер
Натисніть Add senders, оберіть Phone Number і оберіть номер для якого ви хочете включити Messenger Service.
На цьому ж кроці ви можете додатково налаштувати обраний номер.
Sticky Sender – забезпечує послідовність комунікації для одержувачів повідомлень, вибираючи той самий номер телефону відправника, який ви раніше використовували в розмові з даним клієнтом.
Area Code Geomatch – надсилаючи повідомлення до США та Канади, використовуйте місцеві телефонні номери з кодом міста, який збігається або накладається на номер телефону одержувача.
Ці функції за замовчуванням увімкнені. Щоб їх вимкнути – натисніть на перемикач.
Також ви можете додати ще номери, якщо не обрали кілька номерів на попередньому кроці, натиснувши на кнопку Add Senders або видалити вже доданий номер, натиснувши Remove навпроти нього.
Позначте ті номери, з якими ви хочете працювати, і натисніть Step 3. Set up integration.
Крок 3. Налаштуйте вебхуки
На цьому кроці потрібно налаштувати вебхуки для автоматизації процесів і для синхронізації даних між вашими обліковими записами в Twilio та RemOnline.
Оберіть опцію Send a webhook, і вставте необхідні посилання в наступні поля:
В полях Request URL та Fallback URL те саме посилання:
В полі Callback URL:
Біля полей Request URL та Fallback URL має стояти опція HTTP Post.
В полі Validity period ми рекомендуємо залишити те значення, яке там стоїть по замовчуванню - 14400. Це кількість секунд, протягом яких повідомлення, надіслані з вашого поштового сервісу, залишатимуться на платформі Twilio. Якщо час, необхідний для відправлення повідомлення, перевищує Validity period, Twilio відхиляє повідомлення і надсилає запит на вашу Callback URL, щоб повідомити вас про помилку.
Щоб продовжити, натисніть Step 4: Add compliance info.
Крок 4. Додайте інформацію про дотримання вимог
Важливо: цей крок є обов`язковим лише якщо ви використовуєте американський номер.
Це можна зробити з допомогою реєстрації для A2P 10DLC (10-значного коду) в США.
Це система у США, яка дозволяє бізнесам надсилати повідомлення з програми людині (A2P) за допомогою 10-значних телефонних номерів (10DLC). Реєстрація для A2P 10DLC через Twilio включає кілька кроків:
налаштування вашого облікового запису;
реєстрацію вашого бренду;
реєстрацію ваших сценаріїв використання
реєстрацію телефонних номерів.
Заповнення форми займає кілька хвилин, якщо ви підготували всю потрібну інформацію.
Остаточне схвалення вашої реєстрації займає 1-2 тижні. Ви можете скористатися консоллю Twilio, щоб перевірити свій статус реєстрації US A2P 10DLC.
Ви можете завершити створення та налаштування Messaging Service до остаточного схвалення вашої реєстрації A2P 10DLC. Це дозволить вам підготувати систему до повноцінної роботи одразу після завершення реєстрації. Використайте цей час для тестування та налаштування всіх необхідних компонентів, щоб забезпечити безперервну роботу вашої служби.
Зверніть увагу, що поки ваша реєстрація не завершена, можуть бути обмеження на кількість та частоту відправлених повідомлень, а відправлення великих обсягів повідомлень до завершення реєстрації може призвести до блокування або зниження пріоритету ваших повідомлень.
Повністю ознайомитись з процесом реєстрації A2P 10DLC можна тут.
Отже, щоб завершити створення Messaging Service, натисніть Complete Messaging Service Setup.
Готово! Останнім кроком є підключення до RemOnline, після чого ви зможете використовувати SMS для спілкування з вашими клієнтами.
Підключення до RemOnline
Щоб підключити номер SMS by Twilio до RemOnline:
1. На дашборді Twilio перейдіть у розділ Account Info. Тут ви знайдете Account SID та Auth Token, які вам потрібні для підключення до чатів RemOnline. Скопіюйте ці дані.
2. Потім перейдіть у розділ Messaging > Services та знайдіть Messaging Service, який ви створили. Скопіюйте його Sid.
3. В RemOnline перейдіть у розділ Налаштування > Чати та натисніть + Канал. Оберіть ресурс SMS від Twilio.
4. Заповніть усі поля:
Назва каналу - придумайте назву своєму SMS каналу, який використовувати для спілкування з клієнтами.
Account SID - вставте код Account SID скопійований з вашого Twilio акаунту.
Важливо: якщо канал з ідентичним Account SID вже підключений іншою компанією, система не дозволяє під'єднати новий канал з тим самим кодом в RemOnline. Щоб це виправити, необхідно видалити вже наявну інтеграцію в іншій компанії, і тоді додати канал з цим Account SID в RemOnline.
Auth Token - тут вставте код Auth Token, скопійований з вашого Twilio акаунту.
Номер телефону - впишіть той номер телефону, який ви зареєстрували в Twilio та використовуватиме для спілкування з клієнтами.
Зверніть увагу: на один номер ви можете підключити лише один канал. Тобто, якщо у вас вже підключений канал WhatsApp на цей же номер, ви не зможете створити канал SMS.
Sid сервісу повідомлень – тут потрібно вставити код Messaging Service Sid скопійований з сторінки Messaging Service.
5. Налаштуйте Доступ до каналу:
Всі – доступ до налаштування Чату матимуть всі співробітники компанії при умові, що такий доступ дозволений їм системою;
Обрані – доступ до налаштування Чату матимуть лише обрані співробітники при умові, що такий доступ дозволений їм системою;
Власник – доступ до налаштувань матиме лише Власник компанії.
Щоб поміняти налаштування доступу співробітників до Чату і налаштувань Чату, потрібно перейти у Налаштування > Співробітники > Ролі та відредагувати необхідні налаштування.
6. Натисніть Створити.
Готово! Тепер ви можете спілкуватися з клієнтами за допомогою SMS безпосередньо в RemOnline. Дізнатись більше про те, як працюють чати можна тут.