Конфігурація "Відправка повідомлень у Viber: інтеграція з intel-tele.com

Матеріал з Planfix
Версія від 12:48, 14 травня 2024, створена Lyubov (обговорення | внесок)
(різн.) ← Попередня версія | Поточна версія (різн.) | Новіша версія → (різн.)
Перейти до: навігація, пошук


Інтеграція з сервісом https://intel-tele.com/ru/services/viber/ реалізована за допомогою користувацьких операцій сценаріїв.

Сервіс надає послугу розсилки у Viber для власників бізнес-чатів. Ви можете прикріплювати до повідомлення зображення, гіфки, кнопки переходу на сайт або смайли.

Підключення інтеграції

  • Попередньо залиште заявку на сайті. З вами зв'яжеться менеджер та надішле доступ до особистого кабінету.
  • В особистому кабінеті сервісу створіть новий ключ API.
  • Вкажіть IP - один, кілька або діапазон, з якого надходити повідомлення.Для інтеграції вам необхідно вказати IP Планфікса, що відповідає серверу Планфіксу, на якому зареєстровано ваш обліковий запис. Запитати діапазон IP можна у техпідтримки.
  • Поповніть ваш баланс у сервісі intel-tele.com.
  • Встановіть конфігурацію за посиланням: "Відправка повідомлень у Viber: інтеграція з intel-tele.com")


Після встановлення конфігурації в налаштуваннях сценаріїв з'явиться окремий тип операцій, щоб використовувати його створіть новий сценарій. В самому низу списку операцій оберіть “Повідомленя у вайбер через inter-tele.com”:

wk5HqE.png

Запустити операцію можна за допомогою кнопки або через подію в задачі або картці контакту.

Операція містить низку параметрів, які будуть надіслані GET-запитом. Їх необхідно заповнити, вказавши доступні змінні: завдання, контакту, поточного користувача, загальні та системні поля або коментарі:
Параметр Опис Обов'язковий
username Ваш логін Так
api_key Ключ, створений на власній сторінці intel-tele.com Так
to Номер телефону одержувача в міжнародному форматі без «+». Можна вказати кілька номерів, розділених комою, їм надійдуть однакові повідомлення. Так
im_sender Ім'я відправника. Якщо параметр не вказано, ім'я стандартного відправника буде «IntelTele.com» Ні
im_message Повідомлення utf-8 url-encoded. Довгий текст до 1000 символів Так
im_image Посилання на зображення utf-8 url-encoded. Розмір зображення не повинен перевищувати 400x400px. Формат: JPG/JPEG/PNG Ні
im_button_text Текст кнопки, utf-8 url-encoded. Використовується в парі з im_button_link Ні
im_button_link Посилання для переходу, при натисканні на im_button_text, utf-8 url-encoded Ні


Приклади використання

Приклад 1: Створіть завдання для інформування клієнтів про акцію та додайте до неї учасників, яких плануєте оповістити. У коментарі завдання додайте текст повідомлення та картинку. Це повідомлення буде надіслано всім учасникам завдання. Якщо для таких розсилок створено окремий шаблон, то для даних, які будуть включені в повідомлення, включаючи текст на кнопці, можна створити окремі поля та використовувати в сценарії змінні цих полів.

Приклад 2: Можна реалізувати нагадування про завершення покупки, оплату, статус замовлення або інформацію про доставку.

Приклад заповненої операції:

iIH0Wh.png

Приклад відповіді:

{«reply»: [{«status»: «OK», «cost»: «0.200000», «country»: «ua», «mcc»: «250», «number»: «380123456789», «message_id»: «3c32257b-e0b8-4be9-b0e6-e871116b4bdf»}]}

З даних на стороні сервісу формується шаблон повідомлення з картинкою і кнопкою. Потім повідомлення за створеним шаблоном надсилається списку контактів надісланих у запиті:

xnyUtL.png


Інші деталі інтеграції сервісу для Viber-розсилки та розшифровка можливих помилок при відповіді описані тут

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

Склад конфігурації

Якщо конфігурація не підійшла

Якщо описаний підхід до організації роботи вам не підходить, є кілька варіантів подальших дій:

Перейти