Войти
  1. Главная
  2. Возможности
  3. API

API для заявок, звонков, почты и чатов

HTTP API с ключами сотрудников: заявки, звонки, выгрузка XLSX, почта и чаты с правами сотрудника, настройки компании и ИИ-ассистенты по MCP.

Начать бесплатно Как начать
Возможности

От заявки с сайта до ответа клиенту в чате

Только HTTPS. Ответы и ошибки в JSON, а файлы (выгрузка XLSX, вложения писем и комментариев, записи звонков) отдаются как есть. Методы GET, POST, PATCH, PUT и DELETE, тело запроса в JSON или обычной формой.

Заявки

GET, POST, PATCH /api/v1/leads

Создание с сайта, список с фильтрами, карточка, правка полей и ответственного, статус, архив, объединение.

Звонки

POST /api/v1/calls

События звонка из АТС, записи разговоров ссылкой или файлом. Заявку по номеру клиента CRM находит сама.

Лента и комментарии

/api/v1/leads/{номер}/events

События заявки со звонками, записями и расшифровками. Комментарии с файлами.

Выгрузка

GET /api/v1/leads/export.xlsx

Тот же файл XLSX, что кнопка «Скачать XLSX» в CRM, с теми же фильтрами.

Почта

/api/v1/mail

Ящики сотрудника, переписка, письма и вложения. Отправка писем и ответов с файлами, привязка к заявке.

Чаты

/api/v1/chats

Чаты Telegram, MAX, Авито и виджета, сообщения и файлы. Ответ клиенту от бота компании, привязка к заявке.

Компания и сотрудники

/api/v1/company, /members, /invites

Настройки компании, права доступа, роли, приглашения, услуги и быстрые ссылки.

Интеграции и ключи

/api/v1/integrations, /api-keys

Боты Telegram и MAX, виджет на сайт и его настройки, выпуск и отзыв ключей.

Импорт и расшифровка

/api/v1/leads/import, /calls/recordings

Загрузка заявок из XLSX и CSV тем же мастером, что в CRM, расшифровка записей звонков по запросу.

Всё, что сотрудник делает в кабинете, доступно и через API: от заявок и чатов до настроек компании, сотрудников и интеграций. API компании, сотрудников и интеграций

Пример

Звонок из АТС одним запросом

Передайте идентификатор звонка и номер клиента. CRM сама найдёт активную заявку с этим номером или создаст новую по входящему.

  • Ключ в заголовкеX-API-Key или Authorization: Bearer. В адресе запроса ключ не принимается.
  • Номер заявки в ответеТот же номер менеджеры видят в списке заявок.
  • Неизвестные поля не мешаютЛишнее в запросе звонка или заявки молча игнорируется.

Документация API

Ключи

Ключ сотрудника с нужными областями

Ключ привязан к сотруднику и действует с его правами. При выпуске выбираются области: форме сайта хватит создания заявок, телефонии звонков, синхронизации с учётной системой чтения и правки.

  • Права сотрудникаКлюч видит те же заявки, что сотрудник, и не делает запрещённого. Комментарии и изменения подписаны им с пометкой «через API».
  • Отдельный ключ на каждую интеграциюЕсли один ключ попал к посторонним, отзываете только его. Значение показывается один раз.
  • Отзыв действует сразуКлюч отзывает администратор или сам сотрудник в профиле. У компании до 100 ключей, у сотрудника до 10.
MCP

ИИ-ассистенты по MCP

Тот же API доступен ИИ-ассистентам по протоколу MCP: Claude, ChatGPT и Cursor ищут заявки, читают переписку и готовят ответы с правами сотрудника. Подключение через OAuth за минуту, без копирования ключей.

  • По умолчанию только чтениеИзменения и ответы клиентам сотрудник разрешает отдельно при подключении.
  • Отправка с подтверждениемПеред отправкой сообщения или письма клиенту CRM просит ассистента показать текст и дождаться согласия. Спрашивает ли он, зависит от настроек ИИ-приложения.
  • Пометка «через MCP»Каждое изменение заявки видно в её ленте.

Подробнее об ассистентах Как подключить

Надёжность

Заявка не должна потеряться по дороге

Безопасные повторы

Не получили ответ? Повторите запрос с тем же Idempotency-Key: действие не выполнится дважды.

Понятные ошибки

Код ошибки, сообщение и список причин в каждом отказе.

Запас по лимитам

До 3000 запросов за 5 минут на один ключ, списки страницами до 100 строк.

Номер запроса

В каждом ответе есть заголовок X-Request-ID для обращения в поддержку.

Вопросы

Вопросы об API

Где взять ключ API?

Администратор выпускает ключ для любого сотрудника в «Настройках компании», на странице «API-ключи». Сотрудник может выпустить ключ себе в «Профиле», если администратор это не запретил. При выпуске выбираются области: что ключ может делать. Почтовые области и области управления компанией и профилем сотрудник получает только в ключе, который выпустил себе сам. Полное значение показывается один раз: скопируйте его сразу и сохраните в настройках своего сервера.

Можно ли вызывать API прямо из кода страницы сайта?

Нет. Ключ в коде страницы или в JavaScript увидит любой посетитель. Запросы должны идти от вашего сервера: форма отправляет данные на ваш сервер, а он передаёт их в CRM.

Что умеет API?

Всё, что сотрудник делает в кабинете. Создавать заявки и передавать звонки с записями разговоров. Читать список и карточки заявок, менять поля, статус и ответственного, отправлять в архив, объединять, писать комментарии с файлами, получать ленту событий с расшифровками звонков, загружать и выгружать заявки в XLSX. Читать почту сотрудника и отправлять письма, управлять ящиками, читать чаты и отвечать клиентам в Telegram, MAX, Авито и виджете сайта. Администратор через API меняет настройки компании, права, сотрудников и приглашения, ключи и интеграции: API компании. Новые возможности открывают новые области: ключ получает их, только если их отметили при выпуске.

Можно ли подключить ИИ-ассистента?

Да. Claude, ChatGPT, Cursor и другие ассистенты подключаются по протоколу MCP к адресу https://crm.linkodium.com/api/v1/mcp и работают с правами сотрудника. Подключение через OAuth, без копирования ключа: инструкция.

С какими правами работает ключ?

С правами сотрудника, к которому он привязан: видит те же заявки, не делает того, что сотруднику запрещено, работает только с его почтовыми ящиками и с чатами по его режиму доступа. Почту ключ читает и отправляет, только если сотрудник выпустил его себе сам: ключ, выпущенный администратором на имя сотрудника, к его письмам доступа не даёт. Комментарии и изменения в ленте заявки подписаны сотрудником с пометкой «через API». Области ключа могут только сузить эти права.

Что делать, если запрос не прошёл?

При ответах 429, 500, 502, 503, 504 и обрыве связи повторите запрос с растущей паузой, а если в ответе есть заголовок Retry-After, не раньше указанного в нём времени. События звонка склеиваются по его идентификатору call_id, поэтому их можно просто прислать ещё раз. Создание заявки и остальные действия повторяйте с тем же заголовком Idempotency-Key, что и в первой попытке: только так вторая заявка не появится. Повторное обращение CRM распознаёт лишь у активной заявки с email или телефоном от 10 цифр, поэтому заявка только с именем, с телефоном короче 10 цифр без email или с dedup: false, а также заявка сразу со статусом «Спам», «Успешно» или «Провал» без ключа идемпотентности создастся второй раз. Подробнее: ошибки и повторы.

Что будет с ключом, если сотрудник уйдёт?

Ключ, привязанный к сотруднику, перестаёт действовать, когда сотрудника исключают из компании. Поэтому ключ для формы сайта и телефонии выпускайте на того, кто остаётся с компанией, например на владельца. Ключи, выпущенные до появления ключей сотрудников, остаются ключами компании: они по-прежнему создают заявки и передают звонки.
Дальше

Что ещё посмотреть

Документация API

Все поля, ответы, коды ошибок и примеры на PHP и curl.

Открыть

API компании

Настройки, права, сотрудники, ключи, интеграции и профиль.

Открыть

ИИ-ассистенты (MCP)

Claude, ChatGPT и Cursor работают с заявками с правами сотрудника.

Открыть

Формы сайта

Как передать заявку с формы через свой сервер.

Открыть

Телефония и АТС

Как передать звонки и записи разговоров.

Открыть

Подключение ассистента

Пошагово для Claude, ChatGPT, Cursor и других клиентов MCP.

Открыть

Соберите все заявки в одном месте

Регистрация по коду из письма занимает минуту. Банковская карта не нужна.

Начать бесплатно