Webhook API: как подключить CrmAI к любому сервису за 10 минут

«Нам нужно, чтобы при создании сделки в 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 появляется новая сделка, бот мгновенно отправляет сообщение в 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 и вебхуками CrmAI:

• Полный доступ к REST API — все операции с данными: сделки, контакты, сообщения, задачи
• Гибкая настройка вебхуков — выбираете, на какие события подписаться
• Готовые SDK на Python, JavaScript, C#, PHP с русской документацией
• Коллекции для Postman и Insomnia — тестируйте API без написания кода
• История обменов с полным логированием — для отладки и контроля
• Техподдержка на русском языке — отвечаем в рабочие дни за 2-4 часа

Если вы дочитали до этого места — значит, интеграция вам действительно нужна. Не откладывайте: чем раньше системы начнут работать вместе, тем раньше вы перестанете тратить время на ручную синхронизацию данных.