Відправка на Viber (TurboSMS)

Зміст

Загальна інформація

#1. Створення API ключа в TurboSMS

#2. Налаштування Webhook в KeepinCRM

Додаткова інформація

Загальна інформація

Через сервіс TurboSMS можна автоматично і першому відправляти повідомлення у Viber клієнтам. Доступно два типи відправлень:

1. Через свій підпис відправника. Всі такі повідомлення будуть відправлятись по створеному Вами відправнику, мінімальна вартість в місяць яку сплачується сервісу TurboSMS - 8 400 грн
   
2. Через стандартний підпис TurboSMS - Mobibon (сплачується за повідомлення)

Можливості:

• Автоматичне відправлення повідомлень на основі тригерів
• Можливість додавати фото та кнопку з url
• Можливість передавати змінні з KeepinCRM: ТТН, суму замовлення та інше

#1. Створення API ключа в TurboSMS

В кабінеті TurboSMS потрібно згенерувати API-ключ та увімкнути HTTP API. Важливо! ці коригування не впливають на відправку SMS, яку було налаштовано раніше.

#2. Налаштування Webhook в KeepinCRM

В KeepinCRM перейти в розділ: Налаштування => Управління => Тригери та створити новий тригер з типом Webhook.

Налаштувати тригер як на фото:

1. В полі URL чітко вказати - https://api.turbosms.ua/message/send.json
2. В Authorization вказується Basic пробіл свій API-ключ з кроку #1
3. В request body вказати запит:
   • {{client.phone}} - не змінювати, ця змінна відповідає за те, на які номери відправляти повідомлення. Номери беруться з картки клієнта
   • Якщо свій підпис - змінити з Mobibon на свій
   • image_url - фото яке передається в кожному повідомленні
   • caption - текст на кнопці
   • action - url для переходу
4. Якщо кнопки/фото непотрібні - видаліть з запиту

{
  "recipients":[
   "{{client.phone}}"
 ],
  "viber":{
  "sender": "Mobibon",
  "text": "Ваше замовлення: {{title}} відправлено. \nНомер ТТН: {{last_ttn}}",
  "image_url": "https://keepincrm.com/media/1/Images_2x.png",
  "caption": "Перейти на сайт",
  "action": "https://keepincrm.com"
 }
}

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

Можливі помилки:

• Код скопійовано неправильно: пропущена частина коду або лапки не закриті - "
• Не вказано пробіл між словом Basic та API ключем

Додаткова інформація

• Абзаци робити так \n. Наприклад: Ваше замовлення відправлено. \nНомер ТТН
• Інформацію з додаткових полів можна передавати через змінні custom_fields.назва поля
• В умові вказувати при якій дії відправляти запит
• Якщо повідомлення успішно відправлено, в журналі угоди буде відображатись наступна нотатка
  
• В тексті можна використовувати інші змінні по угоді, які в дужках в налаштуваннях полів