Войти

API Лидлога

Подключите свой ИИ — ChatGPT, Claude, Cursor — или сервис автоматизации, и ставьте задачи в Лидлог прямо из разговора. Доступ — по личному ключу, с теми же правами, что у вас в программе.

«Разбери созвон и поставь задачи»Вставляете заметки со встречи — ИИ сам раскладывает их по проектам и датам.
«Что у меня на завтра?»ИИ читает ваши задачи и помогает спланировать день.
Своя автоматизацияЗаявка из CRM или письмо → задача в Лидлоге через n8n, Make или скрипт.

Что это

API — это способ для других программ работать с вашими задачами в Лидлоге. Через API можно:

После созвона. Дайте ИИ-помощнику запись или текст разговора и попросите: «разнеси по Лидлогу». Он сам найдёт проект и РК, покажет, что собирается создать, и после вашего «да» поставит задачи, запишет гипотезы, А/Б, изменения и заметку о встрече. Удалять через API нельзя — только в программе.

Для ИИ-программ есть два способа подключения — MCP (Claude, Cursor и другие) и описание OpenAPI (свой GPT в ChatGPT). Оба работают с одним и тем же ключом.

Тариф. API и подключение ИИ входят в тарифы «Про» и «Для организаций», а также в пробный период. На тарифе «Базовый» ключи не работают.

Шаг 1. Создайте ключ

  1. Откройте Лидлог → меню Данные → 🔌 API и ИИ-помощники.
  2. Впишите название, по которому вы узнаете ключ, например «ChatGPT», и нажмите Создать ключ.
  3. Скопируйте ключ — он начинается с lid_. Ключ показывается один раз: потом в программе видны только его название и последние 4 символа.

В том же окне — адреса для подключения, их можно скопировать кнопкой:

Для чегоАдрес
MCP (Claude, Cursor и др.)https://app.lidlog.ru/api/v1/mcp
Описание OpenAPI (ChatGPT)https://app.lidlog.ru/api/v1/openapi.json
Обычные запросыhttps://app.lidlog.ru/api/v1/…
Храните ключ как пароль: с ним можно смотреть и ставить ваши задачи. Не публикуйте его в чатах и общих документах. Если ключ утёк — удалите его в том же окне, он сразу перестанет работать. Для каждой программы лучше заводить свой ключ.

Подключить Claude

Claude Code (терминал)

Чтобы ключ не остался в истории команд, сначала введите его скрыто, затем подключите. macOS и Linux:

read -s LIDLOG_KEY        # вставьте ключ и нажмите Enter — на экране его не видно
claude mcp add --transport http lidlog https://app.lidlog.ru/api/v1/mcp \
  --header "Authorization: Bearer $LIDLOG_KEY"

Windows (PowerShell):

$env:LIDLOG_KEY = Read-Host -MaskInput "Ключ Лидлога"
claude mcp add --transport http lidlog https://app.lidlog.ru/api/v1/mcp --header "Authorization: Bearer $env:LIDLOG_KEY"

Claude Desktop

Откройте Настройки → Developer → Edit Config и добавьте в файл claude_desktop_config.json (нужен установленный Node.js):

{
  "mcpServers": {
    "lidlog": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.lidlog.ru/api/v1/mcp",
               "--header", "Authorization: Bearer lid_ВАШ_КЛЮЧ"]
    }
  }
}

Перезапустите Claude Desktop — в списке инструментов появится «lidlog». Попробуйте:

Поставь в Лидлог задачу на завтра в 11:00: созвон с клиентом по проекту «Виза», высокий приоритет.

Веб-версия claude.ai подключает внешние коннекторы через вход по OAuth — его в Лидлоге пока нет. Используйте Claude Desktop или Claude Code.

Подключить ChatGPT

Через «свой GPT» с действиями (Actions). Нужна подписка ChatGPT, в которой можно создавать GPT.

  1. ChatGPT → Обзор GPT → Создать → вкладка Настроить.
  2. Название — например, «Мой Лидлог». В Инструкции вставьте:
    Ты помогаешь вести задачи в Лидлоге. Перед тем как поставить задачу по проекту или РК,
    вызови listProjects и возьми оттуда project_id или campaign_id. Даты передавай как ГГГГ-ММ-ДД,
    время — ЧЧ:ММ. Перед созданием нескольких задач коротко покажи список и спроси подтверждение.
  3. Внизу — Создать новое действие → Импортировать из URL → вставьте https://app.lidlog.ru/api/v1/openapi.json.
  4. Аутентификация → API-ключ, тип Bearer, в поле ключа — ваш lid_…. Сохраните.
  5. Сохраните GPT с доступом «Только я» — ключ ваш личный.

Вот заметки с планёрки: … Разложи по проектам и поставь задачи на эту неделю.

Cursor и другие MCP-программы

Программы, которые поддерживают MCP по адресу (Streamable HTTP) с заголовками, подключаются так. Пример для Cursor — файл ~/.cursor/mcp.json:

{
  "mcpServers": {
    "lidlog": {
      "url": "https://app.lidlog.ru/api/v1/mcp",
      "headers": { "Authorization": "Bearer lid_ВАШ_КЛЮЧ" }
    }
  }
}

Если программа умеет запускать MCP только командой — используйте тот же вариант с mcp-remote, что и для Claude Desktop.

Инструменты MCP: задачи — list_projects, list_tasks, create_task, update_task; дневник — list_campaigns, create_campaign, update_campaign, list_entries, create_entry, update_entry, add_change, measure_result, create_hypotheses (одна гипотеза в несколько РК); Директ — list_direct_campaigns, sync_direct; база знаний — list_kb_folders, create_kb_note; и search. Поля — как в справочнике и дневнике.

n8n, Make и свои скрипты

Обычные HTTP-запросы с заголовком Authorization: Bearer lid_…. В n8n и Make — узел HTTP Request, тип авторизации Bearer.

Поставить задачу

curl -X POST https://app.lidlog.ru/api/v1/tasks \
  -H "Authorization: Bearer lid_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"title": "Созвон с клиентом", "date": "2026-10-20", "time": "11:00",
       "type": "call", "project_id": "ID_ПРОЕКТА", "priority": 3}'

Задачи на неделю

curl "https://app.lidlog.ru/api/v1/tasks?from=2026-10-19&to=2026-10-25" \
  -H "Authorization: Bearer lid_ВАШ_КЛЮЧ"

Отметить выполненной

curl -X PATCH https://app.lidlog.ru/api/v1/tasks/ID_ЗАДАЧИ \
  -H "Authorization: Bearer lid_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" -d '{"done": true}'

Python

import requests

API = "https://app.lidlog.ru/api/v1"
H = {"Authorization": "Bearer lid_ВАШ_КЛЮЧ"}

projects = requests.get(f"{API}/projects", headers=H).json()["projects"]
viza = next(p for p in projects if p["name"] == "Виза")
task = requests.post(f"{API}/tasks", headers=H, json={
    "title": "Проверить ставки", "date": "2026-10-20", "project_id": viza["id"],
}).json()
print(task["url"])   # ссылка на задачу в программе

Команды

Адрес — https://app.lidlog.ru/api/v1. Ответы — JSON. Полное машинное описание — openapi.json.

ЗапросЧто делает
GET/meКто вы: логин, имя, тариф, название ключа
GET/projectsПроекты: id, название, РК (id, название, номера), команда (логин, имя, роль)
GET/tasksЗадачи. Параметры: from, to (ГГГГ-ММ-ДД), done = false (по умолчанию) / true / all, project_id, mine=true — только где вы ответственный или исполнитель, limit (до 1000)
GET/tasks/{id}Одна задача
POST/tasksПоставить задачу. Обязательно только title
PATCH/tasks/{id}Изменить задачу: любые поля из таблицы ниже и done — отметить выполнение
GET/search?q=Поиск по РК, записям дневника, задачам и базе знаний
GET/campaignsРК. Параметры: project_id, q (название или номер)
POST/campaignsЗавести РК: project_id, names (список), numbers, group
PATCH/campaigns/{id}Изменить РК: names, numbers, group, archived
GET/entriesЗаписи дневника. Параметры: campaign_id, project_id, type (hyp/ab/task), measure = wait (не снят) / due (пора снять) / done (снят), q, limit
GET/entries/{id}Одна запись
POST/entriesЗаписать гипотезу, А/Б или задачу в дневник РК (поля — ниже)
PATCH/entries/{id}Изменить запись
POST/entries/{id}/changes«Что сделано»: text и date (по умолчанию сегодня)
POST/entries/{id}/measureСнять результат: result, conclusions, winner (у А/Б), date
POST/entries/hypothesesОдна гипотеза сразу в несколько РК: campaign_ids (список, до 30) и поля гипотезы; у каждой РК — своя запись, где уже были гипотезы — следующий этап
GET/projects/{id}/directКампании из Яндекс Директа в проекте: номер, название, статус (on/off/archive), аккаунт, campaign_id — если такая РК уже есть в Лидлоге; когда подтянуто и ошибки
POST/projects/{id}/direct/syncПодтянуть кампании из Директа сейчас (не чаще раза в минуту на проект) — ответ как у GET /projects/{id}/direct
GET/kb/foldersПапки базы знаний, куда можно писать
POST/kb/notesЗаметка в базу знаний: title, text (абзацы, списки «- », заголовки «# »), folder_id
POST/mcpMCP для ИИ-программ (JSON-RPC)

Поля задачи

ПолеЧто это
titleНазвание, до 300 символов
noteОписание, до 5000 символов
dateДата ГГГГ-ММ-ДД; пусто — задача без даты
timeВремя ЧЧ:ММ — только вместе с датой
typeaction — дело (по умолчанию), call — созвон, meeting — встреча
priority0 нет, 1 низкий, 2 средний, 3 высокий
estimateОценка времени в минутах — сколько займёт задача (1–10000); 0 — убрать оценку
project_idПроект из /projects; без него — задача «без проекта»
campaign_idРК из /projects — проект подставится сам
personaltrue — личная задача, видна только вам
responsible, executorЛогины из команды проекта. Не указаны — как в программе: по правилам команды
parent_idТолько при создании: id задачи — тогда это её подзадача. Проект и люди — как у задачи; без date подзадача стоит в том же дне, что и задача
doneТолько при изменении: true / false. Повторяющиеся задачи отмечайте в программе

В ответе задачи есть ещё id, project и campaign (названия), author, done_at, repeat, parent_id (у подзадачи), subtasks (подзадачи: id, title, done, date; каждую можно читать и менять как обычную задачу) и url — ссылка, которая открывает задачу в программе. В истории задачи видно, что она создана или изменена через API и каким ключом.

Поля записи дневника

ПолеЧто это
campaign_idРК — только при создании
typehyp — гипотеза (по умолчанию), ab — А/Б-сравнение, task — задача в дневнике РК
previous_stage_idСледующий этап записи: РК и тип — как у неё, цель — из её выводов, у А/Б переносятся варианты
goal, hypothesis, planЦель, гипотеза («Если …, то …»), план / ожидаемый результат
statusidea — запланировано (по умолчанию), work — в работе, done — выполнено
done_date, measure_dateДата выполнения и дата, когда снимать результат (ГГГГ-ММ-ДД)
measure_statusno — не снят, yes — снят, na — снятие не нужно
first_changeПервое «что сделано»: {"date": "…", "text": "…"}
ab_kindУ А/Б — что сравниваем: creatives, headlines, campaigns, audiences, other
variantsУ А/Б — 2–10 вариантов [{"name": "старый", "text": "…"}, …]; в ответе — буквы A, B… Картинки к креативам добавляются в программе
winnerУ А/Б — кто победил: буква варианта или draw (ничья)
result, conclusionsРезультат и выводы

Ошибки и лимиты

При ошибке ответ — {"error": "понятное описание"} с кодом:

КодКогда
400Неверные данные: дата не в том формате, неизвестное поле и т. п.
401Нет ключа, ключ неверный или удалён
403Нет прав (как в программе: например, исполнитель не переназначает чужие задачи) или тариф без API
404Задача, проект или РК не найдены — или они вам не видны
429Больше 120 запросов в минуту по одному ключу — подождите минуту

Безопасность

Данные уходят в выбранный вами сервис. Подключая ChatGPT, Claude или другую программу, вы сами передаёте ей свои задачи и проекты. Эти сервисы могут обрабатывать данные за пределами России — по их собственным правилам. Подробнее — в Пользовательском соглашении, пп. 3.5–3.7.

Вопросы и идеи по API — в поддержку в Телеграме.