Документация ›Интеграции и API

CRM-интеграции (Bitrix24 / HubSpot / вебхуки)

Что это.

Четыре способа держать внешнюю CRM в синхронизации с SIPmind. Можно использовать любые комбинации — они сосуществуют.

  1. Нативно Bitrix24 / HubSpot — одно поле (webhook URL / access token), лиды улетают автоматически как только AI их захватывает
  2. Нативно amoCRM — полная OAuth2-интеграция со своей страницей (Интеграции → amoCRM); см. отдельный раздел amoCRM ниже
  3. Исходящие вебхуки — отправляют каждое нужное событие на любой адрес: Zapier, n8n, ваш собственный сервис
  4. Входящий вебхук — принимает лиды в SIPmind из форм Tilda, Zapier, n8n и форм на сайте

🅱️ Нативная интеграция с Bitrix24.

Пушит лиды (и опционально другие события) в ваш портал Bitrix24 нативно — без Zapier, без ручного экспорта.

Настройка (60 секунд):

  1. В Bitrix24 → Настройки → Разработчикам → Другое → Входящий вебхук → Создать вебхук
  2. Дайте scope: crm. Скопируйте URL (выглядит как https://your-portal.bitrix24.com/rest/1/abc123def/)
  3. В Настройки → 🅱️ Bitrix24 вставьте URL → Сохранить

Никакого OAuth, никакого marketplace listing — URL сам по себе является аутентификацией. Каждый новый лид автоматически создаёт Bitrix Lead с заполненными PHONE / EMAIL / SOURCE_DESCRIPTION.

🟧 Нативная интеграция с HubSpot.

Каждый новый лид становится HubSpot Contact (объект Leads доступен только на Enterprise; Contacts работают на любом плане).

Настройка:

  1. HubSpot → Settings → Account Setup → Integrations → Private Apps → Create app
  2. Нужный scope: crm.objects.contacts.write. Скопируйте access token (pat-na1-...)
  3. В Настройки → 🟧 HubSpot вставьте токен → Сохранить

Если контакт с таким же email уже существует — HubSpot возвращает 409, мы считаем это успехом (контакт в HubSpot есть, просто не создан этим вызовом). Обновления phone / name пойдут на следующих звонках.

Исходящие вебхуки — события в любую систему.

Мы отправляем POST на ваш адрес при каждом значимом событии — в Zapier, n8n, вашу CRM, куда угодно. Одиннадцать событий:

  • lead.created — сохранён лид: агентом, формой, через API или человеком
  • lead.stage_changed — лид перешёл на другую стадию своей воронки
  • contact.created / contact.updated — новый человек или новое имя, телефон, почта, поле, ответственный
  • call.ended — закончился телефонный или WhatsApp-звонок, который вёл агент
  • appointment.created / appointment.cancelled — визит записан или отменён, агентом или в календаре
  • task.created / task.completed — задача поставлена или выполнена
  • contact.merged / lead.merged — две записи одного человека объединены: в данных указано, какая осталась и какая удалена

Настройка:

  1. В Настройках задайте Lead Webhook URL и, по желанию, Webhook Secret
  2. По умолчанию приходит только lead.created. Остальные включаются через API: PUT /api/v1/events/subscription с телом {"events": ["lead.created", "call.ended", "task.completed"]}. GET по тому же адресу покажет все события, а что несёт каждое — на странице для разработчиков. Там же задаётся секрет подписи — обратно он никогда не отдаётся.

Повторы: три попытки с растущей паузой (1 с / 4 с / 16 с) при ошибке сервера или сети. Ответ 4xx окончательный — адрес сломан, повторять бесполезно. Отправка идёт в фоне и не задерживает разговор с клиентом.

📥 Incoming webhook (принимать лиды из внешних систем).

Генерируйте публичный URL → POST'ите JSON с phone / email / name → SIPmind автоматически создаёт контакт + лид. Полезно для: Tilda-форм, Zapier outputs, n8n flows, landing-page форм.

Настройка:

  1. В Настройки → 📥 Incoming webhook нажмите Создать URL
  2. Скопируйте URL: https://sipmind.net/api/v1/incoming/{tenant_id}/{token}
  3. Вставьте в Tilda destination / Zapier POST action / n8n HTTP node

Безопасность: Токен ЯВЛЯЕТСЯ аутентификацией — неизвестные токены отбиваются 404 (без leak'а сигнала). Ротируйте сразу если утечка; старый URL мгновенно перестаёт работать.

В body должен быть хотя бы phone ИЛИ email — иначе 400. Name / message / notes — опционально. Source ставится incoming_webhook чтобы можно было фильтровать в дашборде.