КАРАДЕСК / API и интеграции
Работает внутри ваших систем
CRM, телефония, мессенджеры, почта, 1С и медицинские системы. Интеграции включены в цену продукта, для своих систем — REST API и вебхуки с документацией уровня банковской приёмки.
Системы
Карта полей, стадии и правила — под каждое подключение
По продуктам
С чем работает каждый продукт
| Продукт | Интеграции |
|---|---|
| ИИ-менеджер | Битрикс24, amoCRM, Мегаплан, СберCRM; SIP, Манго Офис, АТС; WhatsApp, Telegram, ВКонтакте, МАКС, SMS; почта и календари; REST API и вебхуки |
| Администратор | YCLIENTS, DIKIDI, Arnica, 1С, медицинские информационные системы; звонки, WhatsApp, Telegram, ВКонтакте, МАКС, виджет на сайте |
| Бухгалтерия | 1С: Бухгалтерия, ЗУП, Управление торговлей; банковские выписки; ЭДО: Контур, СБИС, Такском; сканы, почта, мессенджеры |
| Аналитика | CRM в режиме только чтения; записи звонков из телефонии; выгрузки для отчётности и группы компаний |
| Аналитика врачей | IP-телефония, МИС, настольные микрофоны и аудиобейджи; уведомления в Telegram и на почту |
| IT-специалист | Любые системы клиента: сайты, CRM, 1С, сервисы с API — разрабатывает и дорабатывает интеграции сам |
API и вебхуки
Документация уровня банковской приёмки
OpenAPI 3.1, идемпотентные команды, условные изменения, длительные операции, вебхуки с подписью и ошибки в формате problem+json.
curl -X POST "$CARADESK_API_BASE/v1/calls" \
-H "Authorization: Bearer $CARADESK_API_TOKEN" \
-H "Idempotency-Key: lead-4821-call-1" \
-H "Content-Type: application/json" \
-d '{"campaign_id":"cmp_01",
"contact_id":"cnt_01",
"external_id":"lead-4821"}'
# 201 Created — повтор с тем же ключом
# вернёт тот же звонок, а не второйX-Caradesk-Timestamp: 1790060400
X-Caradesk-Signature: v1=5f2c…a91e
{
"event_id": "evt_01J8…",
"event_type": "call.completed",
"schema_version": "1.0",
"resource_id": "call_01",
"data": { "status": "completed" }
}
# HMAC-SHA256 по timestamp.raw_body, окно ±300 сЧто есть в документации для интеграторов:
Подключение
От паспорта подключения до работающей интеграции
Паспорт подключения
Какие системы, какие данные, кто участвует в обработке и где всё хранится — до работы с реальными данными.
Карта полей и стадий
Какие поля заполняются, в какие стадии можно переводить сделку, как искать существующие записи без дублей.
Контрольный тест
Проверка на тестовых данных и контрольный звонок с протоколом. Маршрут считается готовым только после него.
Работа и журнал
Каждое действие во внешней системе — в журнале: кто, когда, по какой версии и с каким результатом.
Безопасность интеграций
Ваши ключи и данные — под контролем
Интеграция выполняет только действия из утверждённого каталога. Текст разговора или письма не превращается в команду.
Секреты вне браузера
Ключи интеграций хранятся на сервере, есть ротация и отзыв.
Минимальные права
Доступ только к нужным полям и стадиям, аналитика — только на чтение.
Изоляция организаций
Чужие данные не читаются ни через API, ни через выгрузку.
Подпись вебхуков
HMAC-SHA256 с меткой времени и окном ±300 секунд.
Идемпотентность
Повтор команды с тем же ключом не создаёт дубль.
Данные в России
Персональные данные — по 152-ФЗ, размещение в России.
Вопросы
Частые вопросы об интеграциях
Есть ли у КАРАДЕСК API?
Да: REST API по спецификации OpenAPI 3.1, идемпотентные команды, вебхуки с подписью HMAC-SHA256 и ошибки в формате problem+json.
С какими CRM вы интегрируетесь?
Битрикс24, amoCRM, Мегаплан, СберCRM, а также любые системы через REST API и вебхуки.
Берёте ли вы деньги за интеграции?
Нет, интеграции включены в цену продукта. Корпоративные интеграции по техническому заданию согласуются отдельно.
Нужен ли программист на нашей стороне?
Для типовых подключений — нет, их настраиваем мы. Для собственных систем через API — по техническому заданию. Если своего программиста нет, поможет IT-специалист КАРАДЕСК.
Нашей системы нет в списке. Что делать?
Подключим через API, вебхуки или импорт и экспорт. Расскажите, какая у вас система, — предложим вариант.
Можно подключить свою телефонию и номера?
Да: через SIP-транк, переадресацию с вашей АТС или номера у поддерживаемых операторов. Маршрут считается готовым после контрольного звонка.
Где техническая документация?
На docs.caradesk.ru. Доступ открывается компаниям, которые подключаются к КАРАДЕСК или оценивают интеграцию: укажите компанию и контакты — документация откроется сразу.
Интеграция
Расскажите, какие у вас системы
Подскажем, как подключить продукт к вашей CRM, телефонии, 1С или МИС, и откроем доступ к документации.