API для заявок и звонков

Q: Что умеет API?

Три действия: создать заявку ( POST /api/v1/leads ), передать событие звонка ( POST /api/v1/calls ) и загрузить запись разговора файлом ( POST /api/v1/calls/recording ). Чтения данных из CRM в API нет.

Три адреса

Небольшой API, который легко подключить

Только HTTPS и метод POST. Тело запроса в JSON или обычной формой, ответ всегда в JSON.

Заявки

POST /api/v1/leads

Заявка с формы сайта, квиза или вашего сервиса. Достаточно имени, телефона или email.

Звонки

POST /api/v1/calls

События звонка из АТС: начало, итог, длительность и ссылка на запись разговора.

Записи файлом

POST /api/v1/calls/recording

Для АТС, которые не дают публичную ссылку на запись: файл загружается отдельным запросом.

Пример

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

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

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

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

POST /api/v1/calls

curl -X POST https://crm.linkodium.com/api/v1/calls \
  -H "X-API-Key: $CRM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "call_id": "1727517900.1234",
    "direction": "in",
    "client_phone": "+79991234567",
    "status": "answered",
    "duration": 185,
    "started_at": "2026-09-28T14:05:00+05:00"
  }'

# 201 Created
{ "success": true, "data": {
    "lead_number": 128,
    "call_id": "1727517900.1234",
    "created_lead": true } }

Ключи

Отдельный ключ на каждую интеграцию

Форма сайта, телефония и чат-бот работают на своих ключах. Если один попал к посторонним, отзываете только его.

Ключ привязан к компанииВсё, что приходит с ключом, попадает в эту компанию.
Значение показывается один разCRM хранит только отпечаток ключа и показать его снова не может.
Отзыв действует сразуУ компании может быть до 20 действующих ключей.

API-ключиВыпустить ключ

Форма на сайтеПоследний вызов: сегодня, 14:02Действует

ТелефонияПоследний вызов: сегодня, 13:47Действует

Старый сайтПоследний вызов: не былоОтозван

Ключ выпущен. Скопируйте его сейчас: после обновления страницы показать его ещё раз будет невозможно.

Надёжность

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

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

Не получили ответ? Отправьте запрос ещё раз: дубля не будет.

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

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

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

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

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

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

Вопросы

Вопросы об API

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

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

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

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

Что умеет API?

Три действия: создать заявку (POST /api/v1/leads), передать событие звонка (POST /api/v1/calls) и загрузить запись разговора файлом (POST /api/v1/calls/recording). Чтения данных из CRM в API нет.

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

При ответах 429, 500, 503 и обрыве связи повторите запрос с паузой. Повтор безопасен: события звонка склеиваются по его идентификатору, а заявка с тем же телефоном или email распознаётся как повторное обращение.

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

Ключ принадлежит компании и продолжит работать, пока его не отзовут. При исключении сотрудника администратор может сразу отозвать ключи, которые тот выпустил.

Дальше

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

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

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