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

Приложения и интеграции

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

Обзор#

Каталог приложений находится в разделе Настройки → Приложения. Приложение устанавливается один раз на всё рабочее пространство: администратор подключает сервис с учётными данными самого рабочего пространства, и каждый участник с доступом к инбоксу видит соответствующую карточку в панели диалога. Операторы ничего не устанавливают сами — и ИИ-агенты тоже ничего не устанавливают.

Установка на уровне рабочего пространства

Один набор учётных данных на рабочее пространство. Установка, изменение или удаление приложения затрагивает всех сразу.

Карточки в Инбоксе

Каждое установленное приложение рисует в панели диалога карточку с живыми данными о человеке, с которым вы разговариваете.

Без пустышек

Всё, что перечислено в каталоге, можно установить уже сегодня — раздела «скоро» нет. Отдельная плитка запроса позволяет рассказать нам, какого сервиса не хватает.

Для управления приложениями требуется разрешение Установка и настройка приложений (по умолчанию входит в роли Владельца и Администратора и может выдаваться пользовательским ролям). Участники без него по-прежнему видят карточки приложений в диалогах — они просто не могут ничего устанавливать или перенастраивать.

Каталог приложений#

Сегодня доступно шесть приложений:

ПриложениеКатегорияЧто операторы видят в диалоге
StripeПлатежиПодписка и последние платежи человека, с которым вы разговариваете
ShopifyКоммерцияПоследние заказы со статусами оплаты и выполнения
MailchimpМаркетингСтатус подписки, аудитория и теги человека, с которым вы разговариваете
MailerLiteМаркетингСтатус подписки, группы и дата регистрации человека, с которым вы разговариваете
JiraТрекинг задачЗадачи, связанные с этим диалогом, и создание новой в один клик
TracioБезопасностьЧеловек или бот: вердикт Tracio о посетителе чат-виджета

Нужна простая ссылка на ваш собственный бэк-офис? Для неё не нужны ни аккаунт, ни токен, поэтому она живёт в Настройки → Общие → Ссылки на ваши системы, а не в каталоге приложений.

Установка приложения#

Откройте Настройки → Приложения, выберите плитку и заполните учётные данные, которые запрашивает приложение. Каждое поле ссылается на конкретную страницу в панели вендора, где это значение создаётся или находится.

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

На каждой плитке приложения есть чип статуса, который показывает, в каком состоянии установка:

СтатусЗначение
Не провереноУчётные данные сохранены, но приложение ещё не ответило на реальный запрос.
ПодключеноВендор действительно ответил — соединение проверено, а не просто сохранено.
Требует вниманияВендор отклонил сохранённые учётные данные (ключ отозван или истёк). Карточки перестают обращаться к вендору, пока администратор не сохранит или не перепроверит приложение.
ОшибкаЧто-то другое пошло не так — см. тултип.
ОтключеноАдминистратор выключил приложение. Карточка исчезает из Инбокса, но учётные данные не удаляются.

Учётные данные и безопасность#

Учётные данные приложений принадлежат рабочему пространству, и несколько правил берегут их:

  • Шифрование при хранении. Секретные поля (API-ключи, токены) шифруются в хранилище отдельным ключом каждое и никогда не показываются обратно после сохранения.
  • Минимум привилегий там, где вендор это позволяет. Stripe стоит подключать ограниченным ключом с правом чтения Customers, Subscriptions, Charges и Invoices — плюс запись Refunds только если операторы должны делать возвраты из диалога. Ключ с полным доступом тоже сработает, но страница настроек посоветует его заменить.
  • Смена адресата заново запрашивает секрет. Изменение поля, к которому привязаны учётные данные, — домена магазина Shopify, URL сайта Jira — требует ввести токен заново, поэтому сохранённые учётные данные никогда не перенаправить на хост, для которого они не предназначались.
  • Отзыв затрагивает всё рабочее пространство. На каждое приложение — одна установка на рабочее пространство: если вы ротируете или отзываете ключ у вендора, карточка перестаёт работать у всех участников, пока администратор не обновит её в Настройки → Приложения.

Карточки приложений в Инбоксе#

После установки каждое приложение появляется как виджет в панели деталей диалога в Инбоксе. Открытие диалога запрашивает у вендора живую карточку: кто этот клиент в Stripe, его последние заказы в Shopify, статус его рассылки, связанные с тредом задачи Jira или вердикт Tracio о посетителе. Большинство карточек также ведут на соответствующую запись в панели самого вендора — вердикт Tracio живёт целиком в панели.

Карточки честны, когда показывать нечего. Если клиент не найден — или у диалога нет пригодной личности — карточка так и говорит и объясняет почему, вместо того чтобы рисовать пустую коробку. Ответы ненадолго кэшируются, а частота запросов лимитируется на каждое приложение, поэтому открытый инбокс не сжигает 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 или каналов-мессенджеров.