API Лидлога
Подключите свой ИИ — ChatGPT, Claude, Cursor — или сервис автоматизации, и ставьте задачи в Лидлог прямо из разговора. Доступ — по личному ключу, с теми же правами, что у вас в программе.
Что это
API — это способ для других программ работать с вашими задачами в Лидлоге. Через API можно:
- смотреть проекты, рекламные кампании (РК) и команду проекта;
- смотреть задачи — на день, неделю, по проекту;
- ставить задачи — в проект, в конкретную РК, личные;
- переносить, переименовывать и отмечать задачи выполненными, ставить подзадачи;
- заводить РК, записывать в дневник гипотезы, А/Б-сравнения и «что сделано», снимать результаты;
- писать заметки в базу знаний и искать по всему этому.
Для ИИ-программ есть два способа подключения — MCP (Claude, Cursor и другие) и описание OpenAPI (свой GPT в ChatGPT). Оба работают с одним и тем же ключом.
Шаг 1. Создайте ключ
- Откройте Лидлог → меню Данные → 🔌 API и ИИ-помощники.
- Впишите название, по которому вы узнаете ключ, например «ChatGPT», и нажмите Создать ключ.
- Скопируйте ключ — он начинается с
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: созвон с клиентом по проекту «Виза», высокий приоритет.
Подключить ChatGPT
Через «свой GPT» с действиями (Actions). Нужна подписка ChatGPT, в которой можно создавать GPT.
- ChatGPT → Обзор GPT → Создать → вкладка Настроить.
- Название — например, «Мой Лидлог». В Инструкции вставьте:
Ты помогаешь вести задачи в Лидлоге. Перед тем как поставить задачу по проекту или РК, вызови listProjects и возьми оттуда project_id или campaign_id. Даты передавай как ГГГГ-ММ-ДД, время — ЧЧ:ММ. Перед созданием нескольких задач коротко покажи список и спроси подтверждение. - Внизу — Создать новое действие → Импортировать из URL → вставьте
https://app.lidlog.ru/api/v1/openapi.json. - Аутентификация → API-ключ, тип Bearer, в поле ключа — ваш
lid_…. Сохраните. - Сохраните 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/mcp | MCP для ИИ-программ (JSON-RPC) |
Поля задачи
| Поле | Что это |
|---|---|
title | Название, до 300 символов |
note | Описание, до 5000 символов |
date | Дата ГГГГ-ММ-ДД; пусто — задача без даты |
time | Время ЧЧ:ММ — только вместе с датой |
type | action — дело (по умолчанию), call — созвон, meeting — встреча |
priority | 0 нет, 1 низкий, 2 средний, 3 высокий |
estimate | Оценка времени в минутах — сколько займёт задача (1–10000); 0 — убрать оценку |
project_id | Проект из /projects; без него — задача «без проекта» |
campaign_id | РК из /projects — проект подставится сам |
personal | true — личная задача, видна только вам |
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 | РК — только при создании |
type | hyp — гипотеза (по умолчанию), ab — А/Б-сравнение, task — задача в дневнике РК |
previous_stage_id | Следующий этап записи: РК и тип — как у неё, цель — из её выводов, у А/Б переносятся варианты |
goal, hypothesis, plan | Цель, гипотеза («Если …, то …»), план / ожидаемый результат |
status | idea — запланировано (по умолчанию), work — в работе, done — выполнено |
done_date, measure_date | Дата выполнения и дата, когда снимать результат (ГГГГ-ММ-ДД) |
measure_status | no — не снят, 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 запросов в минуту по одному ключу — подождите минуту |
Безопасность
- Права — как в программе. Через API видно и можно ровно то же, что вам в Лидлоге: свои проекты и проекты, где вы в команде. Чужие личные задачи не видны.
- Паролей нет. Пароли и ключи из паспорта проектов через API недоступны совсем — даже владельцу.
- Ключ хранится только у вас. На сервере — лишь его отпечаток; восстановить ключ по нему нельзя.
- Вы видите каждый ключ: когда создан и когда был последний запрос. Удалить — одной кнопкой.
- Новый ключ — сообщение в Телеграм (если бот подключён). Если ключ создали не вы — удалите его и завершите чужие входы: Данные → Мои входы.
Вопросы и идеи по API — в поддержку в Телеграме.