Документация ›Интеграции и API
CRM-интеграции (Bitrix24 / HubSpot / вебхуки)
Что это.
Четыре способа держать внешнюю CRM в синхронизации с SIPmind. Можно использовать любые комбинации — они сосуществуют.
- Нативно Bitrix24 / HubSpot — одно поле (webhook URL / access token), лиды улетают автоматически как только AI их захватывает
- Нативно amoCRM — полная OAuth2-интеграция со своей страницей (Интеграции → amoCRM); см. отдельный раздел amoCRM ниже
- Исходящие вебхуки — отправляют каждое нужное событие на любой адрес: Zapier, n8n, ваш собственный сервис
- Входящий вебхук — принимает лиды в SIPmind из форм Tilda, Zapier, n8n и форм на сайте
🅱️ Нативная интеграция с Bitrix24.
Пушит лиды (и опционально другие события) в ваш портал Bitrix24 нативно — без Zapier, без ручного экспорта.
Настройка (60 секунд):
- В Bitrix24 → Настройки → Разработчикам → Другое → Входящий вебхук → Создать вебхук
- Дайте scope:
crm. Скопируйте URL (выглядит какhttps://your-portal.bitrix24.com/rest/1/abc123def/) - В Настройки → 🅱️ Bitrix24 вставьте URL → Сохранить
Никакого OAuth, никакого marketplace listing — URL сам по себе является аутентификацией. Каждый новый лид автоматически создаёт Bitrix Lead с заполненными PHONE / EMAIL / SOURCE_DESCRIPTION.
🟧 Нативная интеграция с HubSpot.
Каждый новый лид становится HubSpot Contact (объект Leads доступен только на Enterprise; Contacts работают на любом плане).
Настройка:
- HubSpot → Settings → Account Setup → Integrations → Private Apps → Create app
- Нужный scope:
crm.objects.contacts.write. Скопируйте access token (pat-na1-...) - В Настройки → 🟧 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— две записи одного человека объединены: в данных указано, какая осталась и какая удалена
Настройка:
- В Настройках задайте Lead Webhook URL и, по желанию, Webhook Secret
- По умолчанию приходит только
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 форм.
Настройка:
- В Настройки → 📥 Incoming webhook нажмите Создать URL
- Скопируйте URL:
https://sipmind.net/api/v1/incoming/{tenant_id}/{token} - Вставьте в Tilda destination / Zapier POST action / n8n HTTP node
Безопасность: Токен ЯВЛЯЕТСЯ аутентификацией — неизвестные токены отбиваются 404 (без leak'а сигнала). Ротируйте сразу если утечка; старый URL мгновенно перестаёт работать.
В body должен быть хотя бы phone ИЛИ email — иначе 400. Name / message / notes — опционально. Source ставится incoming_webhook чтобы можно было фильтровать в дашборде.