«Нам нужно, чтобы при создании сделки в CrmAI автоматом создавалась задача в Jira. И наоборот – закрыли задачу, сделка перешла на следующий этап».
Такое слышу от клиентов каждую неделю. Бизнес редко живёт в одной системе – есть бухгалтерия, склад, трекеры, мессенджеры. И всё это должно как-то общаться между собой. Хорошая новость: для такой интеграции не нужна команда разработчиков и месяцы согласований.
В CrmAI мы специально сделали API и вебхуки максимально простыми. Наш рекорд – подключение Telegram-бота к CRM за 7 минут. Разработчик был опытный, но всё равно впечатляет.
API и вебхуки – простым языком
Если вы не программист, эти слова могут пугать. На деле всё проще.
API – это как официант в ресторане. Вы (внешняя система) говорите ему, чего хотите, а он передаёт заказ на кухню (CrmAI) и приносит результат. Через API можно:
- Создать сделку – например, когда клиент заполнил форму на сайте
- Получить список клиентов – чтобы показать их в другой системе
- Обновить статус заказа – когда склад отгрузил товар
- Отправить сообщение в чат – автоматическое уведомление клиенту
То есть API – это когда вы спрашиваете CrmAI или просите его что-то сделать.
Вебхуки (Webhooks) – это обратная история. Теперь уже CrmAI сам сообщает вам, когда что-то произошло. Представьте уведомления на телефоне: вы не проверяете каждую секунду, есть ли новое сообщение – телефон сам вас оповещает. Так же работают вебхуки:
- Создана новая сделка → мгновенно отправить задачу в Jira
- Получено сообщение от клиента → уведомить менеджера в Slack
- Оплачен заказ → автоматически передать данные в 1С
Вместе API и вебхуки создают полноценную двустороннюю связь между системами. Вы можете и запрашивать данные, и получать уведомления – никакой ручной синхронизации.
Готовые коллекции для тестов
Знаете, что бесит разработчиков? Документация, где надо самому собирать запросы по кусочкам. «Вот эндпоинт, вот параметры, а как это работает вместе – разбирайтесь сами».
Мы пошли другим путём и подготовили готовые коллекции для Postman и Insomnia – двух самых популярных инструментов для работы с API. В коллекциях уже есть:
- Все эндпоинты API с реальными примерами запросов и ответов
- Переменные окружения для test и prod – переключаетесь одним кликом
- Готовые тесты, которые проверяют корректность ответов
Весь процесс выглядит так: скачали коллекцию, вставили свой API-ключ, нажали «Send» – и сразу видите результат. Никаких догадок, никакого гадания «а какой формат даты нужен?». Всё работает из коробки.
Кстати, коллекции регулярно обновляются. Добавили новый метод в API – он появляется в коллекции в тот же день.
SDK на русском языке
Работать напрямую с REST API – нормально, но муторно. Вручную формировать запросы, обрабатывать ошибки, парсить JSON. Поэтому сделали SDK – готовые библиотеки, которые берут рутину на себя.
Поддерживаем популярные языки:
- Python – pip install crmai-sdk (идеально для скриптов и автоматизации)
- JavaScript/Node.js – npm install crmai-sdk (для веб-приложений и серверов)
- C#/.NET – NuGet пакет (для корпоративных решений и интеграции с 1С)
- PHP – composer require crmai/sdk (для сайтов на WordPress, Bitrix и других CMS)
Важный момент: вся документация и комментарии в коде – на русском языке. Это не автоматический перевод Google Translate, а нормальный русский текст, написанный нашими разработчиками. Когда вы читаете описание метода или видите подсказку в IDE – всё понятно с первого раза.
Для тех, кто любит учиться на примерах, в каждом SDK есть папка examples с типовыми сценариями: создание сделки, отправка сообщения, работа с контактами. Копируете, подставляете свои данные – и готово.
Нужна помощь с интеграцией?
Не хотите разбираться сами? Наши специалисты помогут подключить CrmAI к вашим системам. Расскажем, какой вариант подойдёт именно вам, и ответим на все вопросы.
Как это работает у клиентов
Теория – хорошо, но давайте посмотрим на практику. Несколько интеграций, которые настроили за последние месяцы:
Телеграм-бот для уведомлений о новых сделках
Один из наших клиентов – небольшое рекламное агентство. У них пять менеджеров, и раньше при появлении нового лида его вручную распределял руководитель. Теперь всё автоматизировано: когда в CrmAI появляется новая сделка, бот мгновенно отправляет сообщение в Telegram-группу. Первый освободившийся менеджер нажимает «Взять в работу» – и сделка закрепляется за ним. Время реакции на заявку сократилось с 15 минут до 2.
Интеграция с сайтом на Tilda
Интернет-магазин косметики на Tilda. Клиент заполняет форму заказа → данные автоматически попадают в CrmAI как новый лид → ИИ-бот отправляет клиенту подтверждение в WhatsApp с деталями заказа и примерным временем доставки. Вся цепочка срабатывает за 3-4 секунды, и клиент сразу видит, что его заказ принят.
Двусторонняя синхронизация с 1С
Оптовая компания, которая продаёт стройматериалы. У них CrmAI для менеджеров и 1С для бухгалтерии. Настроили так: когда заказ в CRM помечается как оплаченный, данные автоматически уходят в 1С. А когда бухгалтер в 1С проводит отгрузку, статус в CrmAI обновляется на «Отгружено». Менеджеры всегда видят актуальную информацию, а бухгалтеры не отвлекаются на вопросы «а отгрузили уже?».
Когда что-то пошло не так
Интеграции – штука надёжная, но иногда что-то ломается. Сервер на той стороне упал, сеть моргнула, формат данных поменялся. В такие моменты важно понять, что именно произошло.
В CrmAI все вызовы API и вебхуки автоматически записываются в историю обменов. Для каждого запроса сохраняется:
- Точные дата и время – с точностью до миллисекунды
- Метод и URL – куда был отправлен запрос
- Полный текст запроса и ответа – можно скопировать и повторить
- Статус: успех или ошибка с кодом и описанием
Это как чёрный ящик в самолёте: если что-то пошло не так, открываете историю и видите всю картину. Не нужно гадать или писать в поддержку «у нас не работает, не знаем почему». Вы сами за минуту находите, где сломалось.
Ещё один плюс – история помогает при отладке новых интеграций. Отправили тестовый запрос, посмотрели, что вернулось, поправили код. Без логов такая отладка превращается в слепой поиск.
Частые вопросы
«А если разработчик уволится – что с интеграцией?»
Ничего страшного. Всё документировано, код в вашем репозитории. Новый разберётся за день – документация понятная, примеры есть. Плюс техподдержка поможет.
«Сколько запросов можно делать через API?»
На тарифах Pro и Enterprise – без ограничений. На базовом тарифе – до 10 000 запросов в день, чего хватает большинству небольших компаний. Если упрётесь в лимит – напишите нам, разберёмся.
«Что если внешний сервис недоступен, когда срабатывает вебхук?»
CrmAI автоматически повторит отправку: сначала через минуту, потом через 5, 15, 60 минут. Если сервис так и не ответил – запрос сохранится в истории с пометкой «не доставлено», и вы сможете перезапустить его вручную.
Готовы попробовать?
Зарегистрируйтесь, получите API-ключ и начните интеграцию уже сегодня. Первые 14 дней – бесплатно и без ограничений.
Что в итоге получаете
Резюмируя, что входит в работу с API и вебхуками CrmAI:
- Полный доступ к REST API – все операции с данными: сделки, контакты, сообщения, задачи
- Гибкая настройка вебхуков – выбираете, на какие события подписаться
- Готовые SDK на Python, JavaScript, C#, PHP с русской документацией
- Коллекции для Postman и Insomnia – тестируйте API без написания кода
- История обменов с полным логированием – для отладки и контроля
- Техподдержка на русском языке – отвечаем в рабочие дни за 2-4 часа
Если вы дочитали до этого места – значит, интеграция вам действительно нужна. Не откладывайте: чем раньше системы начнут работать вместе, тем раньше вы перестанете тратить время на ручную синхронизацию данных.
Остались вопросы?
Напишите нам – разберёмся вместе. Расскажем, какая интеграция подойдёт именно вам, и поможем с настройкой. Консультация бесплатная.