Интеграции
Интеграция по API и другим протоколам
Если для вашей системы нет готовой интеграции, мы связываем её с CONTACT.WORK по тому протоколу, который она понимает: REST и вебхуки, SOAP, прямой доступ к базе данных, SIP и AMI для телефонии, SMPP для SMS, IMAP и SMTP для почты, MCP для ИИ-агентов. Данные из системы появляются на экране оператора, а звонки, переписка и итоги разговоров уходят обратно.
GET /api/clients?phone=79000000015 200 · 84 мс
{ "name": "Иван Образцов", "orders": 2, "debt": 0, "manager": "Анна" } Возможности
Что даёт интеграция по API
Примеры
Что связывают через API
Обычно нужно три вещи: увидеть клиента при звонке, сохранить итог разговора и запускать звонки или сообщения по событиям в вашей системе.
Клиент на экране по номеру
При звонке платформа спрашивает вашу систему, кто звонит: имя, заказы, долг, статус заявки. Есть у системы REST или SOAP – берём данные через них, нет – читаем из базы данных или свежей выгрузки.
- Поиск клиента по номеру
- Заказы и статусы – в анкете
- REST, SOAP, SQL или выгрузка
GET /api/clients?phone=79000000015 200 · 84 мс
{ "name": "Иван Образцов", "orders": 2, "debt": 0, "manager": "Анна" } Результат разговора – в вашу систему
Когда разговор закончен, платформа передаёт в вашу систему то, что ей нужно: звонок, ссылку на запись, итог из анкеты, новую заявку или задачу. Сразу через вебхук или пакетом раз в несколько минут – как удобнее системе.
- Вебхук сразу после звонка
- Ссылка на запись и итог анкеты
- Заявка или задача ответственному
POST /hooks/calls
{ "event": "call.finished", "duration": 192,
"result": "Заказ подтверждён", "record": "…/rec/8841" } - Ответ системы: 200 OK
- В CRM создана задача «Отгрузить заказ №1024»
Звонки и сообщения по событию
Ваша система сама запускает действие платформы: новый заказ – звонок-подтверждение, просроченный платёж – напоминание, смена статуса – SMS или сообщение в мессенджер. Для этого у платформы есть API, с которым работают и ваши разработчики.
- Звонок по событию
- SMS и мессенджеры по API
- Вызов API из вашей системы
order.createdЗвонок-подтверждениезапущенpayment.overdueНапоминание роботом3 попыткиstatus.changedSMS клиентудоставленоticket.closedОпрос в MAXотправленГотовые интеграции с CRM, мессенджерами и картами – в соседних разделах. Эта страница о том, как подключить систему, которой там нет.
Как работает
Какие протоколы используем
Веб-сервисы
REST, SOAP и вебхуки
Большинство современных систем отдают данные через REST или SOAP и умеют сообщать о событиях вебхуками. Это самый удобный путь: обмен идёт сразу, а права ограничены ключом доступа.
- REST и JSON
- SOAP и XML
- Вебхуки в обе стороны
RESTработаетSOAPработаетвебхукиработаетRESTтестТелефония и связь
SIP, AMI, ARI, SMPP, IMAP
Вашу АТС подключаем по SIP, у Asterisk читаем события через AMI и ARI, у FreeSWITCH – через ESL. SMS-провайдеров подключаем по их API или SMPP, почту – по IMAP и SMTP.
- Ваша АТС и операторы связи по SIP
- AMI и ARI для Asterisk
- SMPP, IMAP и SMTP
SIPТранк оператора связи – зарегистрированAMIНовый вызов 79000000015 → очередь 501ARIОператор Анна подключена к разговоруSMPPSMS «Ваш заказ готов» – доставленоIMAPНовое письмо в sales@company.ruДанные напрямую
Базы данных, файлы и ИИ-агенты
Если API у системы нет, читаем и пишем в её базу данных – PostgreSQL, MySQL, MS SQL – или обмениваемся файлами по расписанию. Данные и действия для ИИ-агентов открываем через MCP-коннекторы.
- SQL-базы и ODBC
- CSV и Excel по расписанию
- MCP для ИИ-агентов
PostgreSQLЗаказы и статусыонлайнMS SQL · ODBCОстатки на складеонлайнCSV по SFTPПрайс-листкаждые 15 минMCPПоиск клиента для ИИ-агентаонлайнПодключение
Как подключаем вашу систему
- 01ОбследованиеСмотрим, какие данные нужны операторам и куда должны уходить итоги разговоров.
- 02Способ обменаВыбираем путь: API системы, вебхуки, база данных или файлы по расписанию.
- 03ДоступВаш администратор выдаёт ключ или учётную запись только с нужными правами.
- 04РазработкаПишем коннектор и согласуем, какие поля и события передаются.
- 05ПроверкаДелаем тестовые звонки и сверяем данные в обеих системах.
- 06ЗапускВключаем обмен на всех линиях и первую неделю смотрим журнал ошибок.
Требования
Что нужно для интеграции по API
- Система
- Хотя бы один способ достать данные: API, база данных или выгрузка
- Доступ
- Ключ или учётная запись с правами только на нужные данные
- Сеть
- Платформа и ваша система видят друг друга – через интернет или в одной сети
- Документация
- Описание API или структуры базы, если оно есть
- Ответственный
- Администратор системы на время настройки и проверки
- Стоимость
- Работа разработчиков – почасово на «Профи» или в счёт пакета «Макси»
Подготовка
Что подготовить к интеграции по API
Вопросы и ответы
Частые вопросы
Какие системы можно подключить по API?
Любые, у которых есть способ обмена данными: REST или SOAP, вебхуки, база данных или выгрузка в файл. Чаще всего это CRM, ERP, учётные программы, сайты и самописные системы.
Что, если у системы нет API?
Тогда работаем с её базой данных напрямую или обмениваемся файлами по расписанию. Это медленнее, чем API, но для многих задач этого хватает.
Могут ли наши разработчики сами работать с API платформы?
Могут: через API ваша система запускает звонки и сообщения и получает события о разговорах. На старте поможем и подскажем, какие методы нужны под вашу задачу.
Какой доступ к нашей системе получит платформа?
Только тот, который вы сами выдали ключу или учётной записи: например, читать клиентов и заказы и создавать задачи. Если платформа стоит у вас, обмен вообще не выходит за пределы вашей сети.
Чем API отличается от MCP-коннектора?
API – это обмен между системами: данные приходят в анкету оператора и уходят обратно. Через MCP-коннектор данные и действия получает ИИ-агент, чтобы он сам находил нужное и выполнял разрешённые операции.
Что будет, если наша система недоступна?
Звонки и чаты продолжают идти: оператор просто не увидит данных из вашей системы, пока она не вернётся. Итоги разговоров платформа отправит позже, когда система снова ответит.
А если в нашей системе поменяется API?
Поправим коннектор под новую версию. Если вы заранее сообщите об обновлении, сделаем это до переключения, чтобы обмен не прерывался.
Получится ли звонить прямо из нашего приложения?
Получится: звонки и обзвоны запускаются и управляются прямо из ваших корпоративных приложений, и сотруднику не нужно переключаться в другую систему. Так работают крупные компании, у которых уже есть свои решения.
Сколько стоит интеграция по API?
Оплачивается только работа разработчиков – 3 500 ₽ за час на «Профи» или часы из пакета «Макси». Объём работ называем после обследования.
Глоссарий
Термины на этой странице
- API – программный интерфейс для связи систем
- Способ, которым программы обмениваются данными без участия человека. Подробнее →
- Вебхук – уведомление о событии между системами
- Сообщение, которое система сама отправляет другой, когда что-то произошло. Подробнее →
- REST – обмен данными между системами по HTTP
- Обычный способ, которым программы обмениваются данными через интернет. Подробнее →
- SMTP и IMAP – протоколы электронной почты
- Протоколы почты: SMTP отправляет письма, IMAP читает их с сервера. Подробнее →
- MCP – протокол подключения ИИ к системам
- Открытый протокол, по которому ИИ работает с данными и действиями других систем. Подробнее →
- SQL – язык запросов к базам данных
- Язык, на котором программы работают с данными в базах. Подробнее →
- SIP – протокол установления сеансов связи
- Протокол, по которому устанавливаются звонки в IP-телефонии. Подробнее →
- AMI – интерфейс управления Asterisk
- Канал, по которому Asterisk сообщает о звонках и принимает команды. Подробнее →
- SMPP – протокол отправки SMS
- Протокол, по которому система отправляет SMS через оператора связи. Подробнее →
- CRM – система управления отношениями с клиентами
- Здесь компания хранит клиентов, сделки и всю историю общения. Подробнее →
- ERP – система управления ресурсами предприятия
- Заказы, склад и финансы компании в одной системе. Подробнее →
- ARI – свои приложения для звонков в Asterisk
- Интерфейс, через который звонок в Asterisk ведёт ваше собственное приложение. Подробнее →
- Облачное размещение (облако)
- Платформа работает на серверах поставщика, а операторы подключаются через интернет. Подробнее →
- IP-АТС
- Телефонная станция компании, которая работает через интернет и локальную сеть. Подробнее →
- Коннектор
- Готовый модуль, который связывает платформу с телефонией, CRM или другой системой. Подробнее →
Обновлено: