Email

Омніканальність

In-App
Рекомендації в мобільних додатках

Автоматизація

Мультимовність

Документи

Відповідність GDPR

Інтеграція

Інтеграція з сайтом

Як налаштувати інтеграцію для App-Inbox

App Inbox – ще один варіант комунікації з клієнтами, який передбачає відправлення автоматичних та ручних повідомлень у особистий кабінет користувача на будь-якому сайті або в додатку.

Приклад App Inbox

Налаштування App Inbox включає:

  1. Одержання токена аутентифікації.
  2. Встановлення та ініціалізація скрипту.
  3. Інтеграція віджету, що відображається на сайті.

Отримання токена автентифікації

Надішліть запит з боку вашого бекенда до API eSputnik для отримання токена аутентифікації (authToken).

Запит повинен бути автентифікований одним із способів, описаних в інструкції API. Наприклад, API-ключом.

Метод запиту

POST 

URL запиту

https://esputnik.com/api/v1/auth/contact/token

Заголовок запиту

Content-Type: application/json

Тіло запиту

{

"email": string,

"phone": string

}

 

Відповідь: HTTP 200

{

“token”: “string”

}

 

Відповідь: HTTP 400/401

 

У запиті потрібно передати відомі поля користувача: email, phone (хоча одне поле має бути обов'язковим). Ці поля використовуються для пошуку контакту в eSputnik. Надалі authToken використовується скриптом у запитах до сервера eSputnik.

Додаткову інформацію щодо роботи з контактами наведено у статті “Ресурси API для додавання контактів”.

Важливо:

Отримати один раз цей токен не можна, він може бути будь-якої миті інвалідований з міркувань безпеки. Скрипт самостійно оновить його викликом getAuthTokenCallback.

Якщо контакт у системі eSputnik не знайдено, то токен не повернеться і буде повернено наступну відповідь:

{
“token”: “”
}

Установка скрипту

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

Якщо раніше встановлювався скрипт eSputnik для роботи з веб-трекінгом, рекомендаціями або формами, його не потрібно встановлювати повторно. Необхідно викликати ініціалізацію для розширення параметрів для App Inbox.

Приклад

eS('init', {RECOMS: true, TRACKING: false, APP_INBOX: true}, {getAuthTokenCallback: () => yourImplementationOfAuthCallback(),  language: 'ru', });

Важливо!

Команда ініціалізації `init` має бути викликана один раз при кожному завантаженні сторінки.Якщо раніше скрипт не встановлювався, необхідно звернутися до служби підтримки на support@esputnik.com для його отримання (з позначкою: “для App Inbox”).

Ви можете самостійно отримати скрипт у системі eSputnik у розділі “Налаштування” → “Веб-трекінг”.

Меню Веб-трекинг

Інструкція з встановлення коду відстеження представлена тут.

Важливо! У скрипті, який видається на сторінці веб-трекінгу, необхідно модифікувати виклик команди 'init' таким чином:

замість

eS('init')

повинно бути

eS('init', {APP_INBOX: true}, {getAuthTokenCallback: () =>yourImplementationOfAuthCallback(),  language: 'ru', });

Приклад скрипту з ініціалізацією:

<script> !function (t, e, c, n) {var s = e.createElement(c); s.async = 1, s.src = 'https://statics.esputnik.com/scripts/' + n + '.js'; var r = e.scripts[0]; r.parentNode.insertBefore(s, r); var f = function () {f.c(arguments); }; f.q = []; f.c = function () {f.q.push(arguments); }; t['eS'] = t['eS'] || f; }(window, document, 'script', 'UUID'); </script><script>eS('init', {APP_INBOX: true}, {getAuthTokenCallback: () => yourImplementationOfAuthCallback(), language: 'ru', });</script>

Параметри об'єкта, що передається у функцію eSputnik

Назва

Приклад

Опис

getAuthTokenCallback

function yourImplementationOfAuthCallback() {
  return new Promise((resolve, reject) => {

      //  вставте сюди код із запитом API вашого бекенда, виконайте парсинг токена з відповіді та передайте її у запит функції `resolve` 

      resolve('token should be placed here');
  });
}

Обов'язковий

Type: () => Promise<String>

Асинхронна функція буде викликатись скриптом для отримання authToken. Повинна звертатися до Customer Backend та повертати Promise

language

ua

Обов'язковий

Type: String

ISO 639-1

Інтеграція віджету App Inbox

Для інтеграції віджету з сайтом вам необхідно передати в eSputnik наступні дані:

Додатково ви можете надіслати файл у форматі SVG з бажаним дизайном іконки кнопки (Bell button) та зовнішнього вигляду повідомлень.

Також ви можете доручити eSputnik налаштувати зовнішній вигляд іконки та повідомлень.

Залишилися питання?
Спеціалісти обов'язково нададуть відповідь та допоможуть вирішити вашу проблему!
Зворотний дзвінок
Залишіть заявку – і наш спеціаліст зв'яжеться з вами в робочий час.
Відправити заявку
Консультація в чаті
Готові до ваших запитань!
Написати в чат
Електронна пошта
Напишіть в службу підтримки eSputnik.
Надіслати email