Документація

Застосунки та інтеграції

Підключіть інструменти, якими ваша команда вже користується — Stripe, Shopify, Mailchimp, MailerLite, Jira і Tracio. Встановлені застосунки показують живі дані про клієнта у вигляді карток у панелі розмови Inbox, просто поруч із чатом.

Огляд#

Каталог застосунків живе в Налаштування → Застосунки. Застосунки встановлюються один раз — на весь робочий простір: адміністратор підключає сервіс з обліковими даними робочого простору, і кожен учасник команди з доступом до Inbox бачить відповідну картку в панелі розмови. Оператори нічого не встановлюють самостійно — і AI-агенти теж нічого не встановлюють.

Встановлення на рівні робочого простору

Один набір облікових даних на робочий простір. Встановлення, редагування чи видалення застосунку впливає на всіх одразу.

Картки в Inbox

Кожен встановлений застосунок малює картку в панелі розмови з живими даними про людину, з якою ви розмовляєте.

Без наповнювача

Усе, що є в каталозі, можна встановити вже сьогодні — розділу «скоро буде» немає. Через плитку запиту можна повідомити нам, якого сервісу бракує.

Керування застосунками вимагає дозволу Встановлення й налаштування застосунків (за замовчуванням входить у ролі Owner та Admin, його можна надати власним ролям). Учасники команди без нього все одно бачать картки застосунків у розмовах — вони просто не можуть нічого встановити чи переналаштувати.

Каталог застосунків#

Сьогодні доступні шість застосунків:

ЗастосунокКатегоріяЩо оператори бачать у розмові
StripeПлатежіПідписка та останні платежі людини, з якою ви розмовляєте
ShopifyКомерціяОстанні замовлення зі статусами оплати й виконання
MailchimpМаркетингСтатус підписки, аудиторія і теги людини, з якою ви розмовляєте
MailerLiteМаркетингСтатус підписки, групи й дата реєстрації людини, з якою ви розмовляєте
JiraТрекінг задачЗадачі, пов’язані з цією розмовою, і створення нової в один клік
TracioБезпекаЛюдина чи бот: вердикт Tracio щодо відвідувача чат-віджета

Потрібне просте посилання на ваш власний бек-офіс? Для нього не потрібні ані акаунт, ані токен, тому воно живе в Налаштування → Загальні → Посилання на ваші системи, а не в каталозі застосунків.

Встановлення застосунку#

Відкрийте Налаштування → Застосунки, виберіть плитку і заповніть облікові дані, які просить застосунок. Кожне поле посилається на конкретну сторінку в панелі вендора, де це значення створюється або знаходиться.

КрокОпис
1. Перегляньте прикладПерш ніж ви щось вставите, сторінка налаштування показує зразок саме тієї картки, яку побачать ваші оператори — зібраний із вигаданих даних, щоб ви розуміли, чим ділитеся з робочим простором, ще до збереження облікових даних.
2. Введіть облікові даніВставте API-ключ або токен. Значення обрізаються автоматично — пробіл чи перенос рядка наприкінці після копіювання не зламає встановлення.
3. Збережіть і перевіртеЗбереження зберігає конфігурацію; перевірка з’єднання робить реальний запит до вендора — саме вона робить чип статусу зеленим.

На кожній плитці застосунку є чип статусу, який показує, на якому етапі встановлення:

СтатусЗначення
Не перевіреноОблікові дані збережено, але застосунок ще не відповів на жоден реальний запит.
ПідключеноВендор справді відповів — з’єднання перевірене, а не просто збережене.
Потребує увагиВендор відхилив збережені облікові дані (відкликаний або протермінований ключ). Картки перестають звертатися до вендора, поки адміністратор не збереже або не перевірить застосунок знову.
ПомилкаСталося щось інше — дивіться підказку.
ВимкненоАдміністратор вимкнув застосунок. Картка зникає з Inbox, а облікові дані не видаляються.

Облікові дані та безпека#

Облікові дані застосунків належать робочому простору, і кілька правил тримають їх у безпеці:

  • Шифрування у сховищі. Секретні поля (API-ключі, токени) шифруються окремим ключем кожне і ніколи не показуються після збереження.
  • Мінімальні привілеї там, де вендор це дозволяє. Stripe варто підключати обмеженим ключем, який може читати Customers, Subscriptions, Charges та Invoices — плюс запис у Refunds лише якщо оператори мають повертати кошти з розмови. Якщо ви вставите ключ із повним доступом, він теж працюватиме, але сторінка налаштувань порадить його замінити.
  • Зміна призначення знову просить секрет. Редагування поля, до якого прив’язано облікові дані — домену магазину Shopify, URL сайту Jira — вимагає ввести токен ще раз, тож збережений секрет ніколи не можна перенаправити на хост, для якого він не призначався.
  • Відкликання зачіпає весь робочий простір. На робочий простір існує одне встановлення кожного застосунку: якщо ви ротуєте чи відкликаєте ключ у вендора, картка перестає працювати в кожного учасника команди, поки адміністратор не оновить її в Налаштування → Застосунки.

Картки застосунків в Inbox#

Після встановлення кожен застосунок з’являється як віджет у панелі деталей розмови в Inbox. Відкриття розмови підтягує живу картку від вендора: хто цей клієнт у Stripe, його останні замовлення в Shopify, статус у розсилці, задачі Jira, пов’язані з тредом, або вердикт Tracio щодо відвідувача. Більшість карток також посилаються на відповідний запис у панелі самого вендора — вердикт Tracio живе цілком у панелі.

Картки чесно кажуть, коли показати нічого. Якщо клієнта не знайдено — або в розмови немає придатної особи — картка так і каже й пояснює чому, замість того щоб рендерити порожню коробку. Відповіді ненадовго кешуються, а кожен застосунок має власний бюджет запитів, тож відкритий Inbox не спалює ліміти API вендора.

Картки йдуть за верифікованою особою#

Stripe, Shopify, Mailchimp та MailerLite шукають клієнта за email-адресою — і лише за адресою, яка справді верифікована: покритою підписаною особою віджета (верифікація особи) або адресою From у розмові email-каналу. Адреса, яку відвідувач просто надрукував у чаті, для пошуку не використовується взагалі — інакше будь-хто міг би ввести email справжнього клієнта й побачити його історію платежів. У такому разі картка пояснює, що адреса не підкріплена верифікованою особою.

Jira і Tracio не прив’язані до email — картки Jira належать пов’язаним задачам розмови, а Tracio — відвідувачу віджета, тож вони працюють навіть коли верифікованої адреси немає.

Якщо власна адреса розмови нічого не знаходить, Respondo також пробує іншу відому адресу контакту (наприклад, після злиття контактів) і підписує картку адресою, яку використав.

Що показує кожен застосунок#

Stripe#

Вікно лише для читання в білінг клієнта: ім’я, email, баланс акаунта і копійований ID клієнта, плюс підписка — бейдж статусу, план, місячна вартість і дата початку — та останні платежі з номерами інвойсів. Повернення коштів — єдиний необов’язковий запис: адміністратор має увімкнути Дозволити повернення з панелі розмови в налаштуваннях застосунку (за замовчуванням вимкнено), оператору потрібен дозвіл Повернення коштів і скасування, і кожне повернення треба підтвердити, набравши REFUND — Stripe не може відкликати повернення після відправки.

Shopify#

Останні замовлення лише для читання — номер замовлення, дата, сума, статуси оплати й виконання — з посиланнями на кожне замовлення і на запис клієнта у вашій адмінці Shopify. Підключається доменом магазину і токеном Admin API з кастомного застосунку зі скоупами read_customers і read_orders.

Mailchimp#

Підписник таким, яким його бачить Mailchimp: бейдж статусу, аудиторія, теги, залученість і остання активність у кампаніях (відправлення, відкриття, кліки). Доступна одна дія: Відписати — щоб виконати прохання «перестаньте мені писати», не виходячи з розмови. Через API вона незворотна — Mailchimp дозволяє людині повернутися лише через форму підписки самостійно — тому вимагає набраного підтвердження. Зверніть увагу: ключі API Mailchimp не мають скоупів — підключений ключ може читати й писати все в акаунті.

MailerLite#

Статус підписки, групи, дата реєстрації, залученість і остання активність у кампаніях. Дві дії: Відписати (зворотна — API MailerLite підтримує повторну підписку) і Підписати знову — щоб повернути людину до списку на її власне прохання.

Jira#

Двосторонній зв’язок між розмовами й задачами Jira Cloud. Картка показує задачі, пов’язані з цією розмовою, з їхнім поточним статусом, і пропонує Створити задачу (заводиться у вибраному проєкті й пов’язується автоматично) та Пов’язати наявну / Відв’язати для задач, які вже існують. Зміни статусу, зроблені в Jira, повертаються через вебхук: сторінка налаштувань застосунку показує секретну адресу вебхука, яку треба вставити у ваш сайт Jira, і відтоді картка віддзеркалює живий статус задачі. Задачі створюються від імені підключеного акаунта Atlassian, і картка бачить рівно те, що бачить цей акаунт.

Кожна дія з панелі закрита дозволами ролей — Дії застосунків для відписки, повторної підписки та задач Jira, і Повернення коштів і скасування для повернень. Там, де застосунок має ще й перемикач можливості на рівні робочого простору — сьогодні це Дозволити повернення з панелі розмови у Stripe — перемикач вирішує, чи існує можливість узагалі, і його вимкнення блокує всіх, включно з власником робочого простору.

Tracio: людина чи бот#

Tracio відповідає на одне питання про відвідувача чат-віджета: це людина чи бот? Встановлення застосунку вмикає SDK детекції Tracio всередині вашого чат-віджета Respondo — нові розмови з віджета отримують вердикт автоматично, показаний як чип на картці Tracio в панелі розмови.

ЧипЗначення
ЛюдинаСерверна перевірка Tracio не знайшла бот-сигналів для цього відвідувача.
Бот · 93%Виявлено бота, з упевненістю Tracio. Картка також показує сигнали, що стоять за вердиктом.
Не перевіреноСерверна перевірка Tracio зараз недоступна — картка відкочується до вердикту, повідомленого браузером, і чесно про це каже.
Підроблений IDID відвідувача, який надіслав браузер, невідомий Tracio — заява схожа на підробку.

Підключаються два ключі: публічний, що активує SDK у віджеті, і секретний ключ Data API для серверної перевірки вердикту. Без серверної перевірки браузерній заяві «не бот» саму по собі довіряти не можна — а коли заява браузера розходиться з серверним вердиктом, картка показує обидва.

Tracio працює лише для розмов з чат-віджета. Email, Telegram та інші канали не мають відвідувача, якого можна перевірити, тож їхня картка Tracio пояснює, що перевіряти нічого. Відсутність вердикту — не привід для підозри: блокувальники реклами постійно вирізають SDK у справжніх людей, а старі розмови, розпочаті до підключення Tracio, вердикту теж не мають.
SDK Tracio знімає цифровий відбиток відвідувачів вашого сайту. Отримати згоду відвідувачів (через ваш CMP / банер cookie) — ваш обов’язок як власника сайту.

Обмеження#

  • Картки Stripe і Shopify — лише для читання; єдиний запис у всьому застосунку Stripe — необов’язкова, явно ввімкнена дія повернення коштів.
  • Застосункам із пошуком за email (Stripe, Shopify, Mailchimp, MailerLite) потрібна верифікована email-адреса. Розмови від анонімних відвідувачів віджета чи з каналів без адреси показують чесну картку «немає за чим шукати».
  • Підтримка Jira охоплює лише Jira Cloud.
  • Mailchimp не має повторної підписки: після відписки повернутися може лише сама людина через форму підписки. Якщо цей сценарій для вас важливий — використовуйте повторну підписку MailerLite.
  • Вердикти Tracio існують лише для розмов з віджета із завантаженим SDK — ніколи для email чи месенджерів.