Интеграции и API

Интеграция с Bitrix24

Интеграция с Bitrix24 Интеграция связывает переписку в Kulpunai со сделками и контактами в Bitrix24. Что даёт - Контакты из Kulpunai попадают в CRM; - По обращениям создаются сделки; - Переписка привязывается к карточке клиента в Bitrix24; - AI Agent может заполнять поля сделок и контактов данными из диалога. Подключение 1. Откройте Настройки → Интеграции. 2. Найдите Bitrix24 и запустите подключение. 3. Авторизуйтесь в своём портале Bitrix24 и выдайте запрошенные разрешения. Опция подключается в тарифе — см. Настройки → Платёж → Дополнительные опции. Поля для AI Agent В настройках интеграции есть раздел полей, которые ассистент вправе заполнять во время диалога. Для каждого поля добавьте описание — оно объясняет ИИ, какую информацию извлекать из переписки. Например, для поля «Город доставки» подойдёт описание «город, в который клиент просит доставить заказ». Чем точнее описание, тем реже ассистент ошибается. Начните с двух-трёх ключевых полей и расширяйте список по мере проверки результата. Отключение Удаление интеграции останавливает синхронизацию контактов и диалогов. Уже переданные в Bitrix24 данные остаются в CRM. Другие интеграции В разделе Настройки → Интеграции также доступны Slack, Linear, Notion, «Диалог» (Dialogflow), Google Translate и Shopify. Порядок подключения у всех одинаковый: найти приложение в списке и пройти авторизацию.

Webhooks

Webhooks Вебхук отправляет HTTP-запрос на ваш адрес, когда в Kulpunai происходит событие. Так платформу связывают с собственными системами. Настройка 1. Откройте Настройки → Интеграции → Webhooks. 2. Нажмите добавление вебхука. 3. Укажите: - URL — адрес, куда отправлять запросы; - События — на какие изменения реагировать. События - conversation_created — создан диалог; - conversation_updated — диалог изменён; - conversation_status_changed — сменился статус; - message_created — новое сообщение; - message_updated — сообщение изменено; - webwidget_triggered — посетитель открыл виджет на сайте. Формат данных Запрос приходит методом POST с телом в формате JSON: { "event": "message_created", "id": 123, "content": "Здравствуйте", "conversation": { }, "sender": { }, "account": { } } Состав полей зависит от события. Применение - Передача заявок в собственную CRM или учётную систему; - Уведомления в корпоративный чат; - Запись обращений во внешнюю базу; - Запуск своих сценариев обработки. Рекомендации - Используйте адрес по HTTPS. - Отвечайте на запрос быстро: долгий ответ приводит к повторным отправкам. - Предусмотрите повторную обработку — одно и то же событие может прийти дважды. - Проверяйте вебхук на тестовом адресе, прежде чем подключать боевую систему.

Панель приложений

Панель приложений Приложение панели встраивает внешнюю страницу прямо в интерфейс диалога. Оператор видит нужные данные, не переключаясь между системами. Настройка 1. Откройте Настройки → Интеграции → Панель приложений. 2. Нажмите настройку приложения. 3. Укажите название и адрес страницы. Приложение появится в панели рядом с перепиской. Как получить контекст диалога Встроенная страница получает данные о диалоге и контакте через сообщения окна: window.addEventListener("message", (event) => { const data = JSON.parse(event.data); // data содержит информацию о диалоге и контакте }); Запросить актуальные данные можно самостоятельно: window.parent.postMessage( 'kulpunai-dashboard-app:fetch-info', '*' ); Применение - Карточка заказа из вашей системы; - История покупок клиента; - Статус доставки; - Данные из учётной системы. Рекомендации - Страница должна открываться по HTTPS. - Делайте интерфейс узким: он показывается в боковой панели. - Не запрашивайте отдельную авторизацию у оператора — используйте идентификатор контакта из контекста.

API и токен доступа

API и токен доступа Для обращений к API Kulpunai нужен персональный токен доступа. Где найти токен 1. Нажмите на аватар в боковой панели. 2. Выберите Настройки профиля. 3. Найдите раздел с токеном доступа. 4. Скопируйте значение. Использование Токен передаётся в заголовке api_access_token: curl -H "api_access_token: ВАШ_ТОКЕН" https://online.kulpunai.com/api/v1/accounts/1/conversations Идентификатор аккаунта виден в адресной строке панели управления. Что можно делать через API - Получать и создавать диалоги; - Отправлять сообщения; - Управлять контактами; - Читать отчётные данные. Канал API Для собственных интеграций удобно создать источник типа API: сообщения в него отправляются запросами, а операторы отвечают в общем интерфейсе. Источник создаётся в Настройки → Источники → Добавить источник. Безопасность - Токен даёт полный доступ к вашему аккаунту — обращайтесь с ним как с паролем. - Не размещайте токен в коде сайта и в публичных репозиториях: он должен использоваться только на сервере. - Храните токен в переменных окружения. - При подозрении на утечку пересоздайте токен и обновите его во всех интеграциях — старый перестанет работать сразу.