#Таймлайн CRM

Логируйте действия AI-агентов и интеграций в таймлайне CRM-сущностей. Создавайте записи, добавляйте заметки, закрепляйте важные события и привязывайте к нескольким сущностям одновременно.

#Обзор

Timeline Logs API оборачивает Bitrix24 REST API (crm.timeline.logmessage.*, crm.timeline.note.*, crm.timeline.item.*, crm.timeline.bindings.*) в 12 RESTful-эндпоинтов. Позволяет вести журнал событий прямо в карточке CRM-сущности (сделки, лида, контакта, компании). Идеально подходит для:

Логирования действий AI-агентов (что сделал бот, какие данные обработал)
Фиксации событий из внешних систем (оплата, доставка, уведомление)
Создания аудиторского следа интеграции
Заметок и комментариев от автоматизации

Требуемый скоуп: crm

Базовый URL: https://vibecode.bitrix24.tech/v1

Авторизация: заголовок X-Api-Key с вашим API-ключом.

#Быстрый старт

#1. Создайте запись в таймлайне сделки

Terminal

curl -X POST https://vibecode.bitrix24.tech/v1/timeline-logs \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityTypeId": 2,
    "entityId": 100,
    "title": "AI-агент обработал заявку",
    "text": "Проанализированы данные клиента. Рекомендация: предложить тариф Enterprise."
  }'

Ответ:

JSON

{
  "success": true,
  "data": {
    "LOG_ID": 5012
  }
}

#2. Закрепите запись

Terminal

curl -X POST https://vibecode.bitrix24.tech/v1/timeline-logs/5012/pin \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityTypeId": 2,
    "entityId": 100
  }'

#3. Добавьте заметку

Terminal

curl -X POST https://vibecode.bitrix24.tech/v1/timeline-logs/5012/note \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityTypeId": 2,
    "entityId": 100,
    "text": "Клиент обычно отвечает в течение 2 дней."
  }'

#Записи таймлайна (Log Messages)

#POST /v1/timeline-logs

Создаёт новую запись в таймлайне CRM-сущности. Bitrix24: crm.timeline.logmessage.add

Параметры:

Параметр	В	Тип	Обяз.	По умолч.	Описание
`entityTypeId`	body	number	да	—	Числовой тип сущности (см. Типы сущностей)
`entityId`	body	number	да	—	ID сущности в CRM
`title`	body	string	да	—	Заголовок записи
`text`	body	string	нет	—	Текст записи (поддерживает BB-код)
`fields`	body	object	нет	—	Дополнительные поля для Bitrix24 (передаются как `FIELDS`)

Пример (curl):

Terminal

curl -X POST https://vibecode.bitrix24.tech/v1/timeline-logs \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityTypeId": 2,
    "entityId": 100,
    "title": "Статус обновлён автоматически",
    "text": "Сделка переведена в стадию \"Подготовка документов\" на основе данных из 1С."
  }'

Пример (JavaScript):

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/timeline-logs', {
  method: 'POST',
  headers: {
    'X-Api-Key': VIBE_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    entityTypeId: 2,
    entityId: 100,
    title: 'Статус обновлён автоматически',
    text: 'Сделка переведена в стадию "Подготовка документов" на основе данных из 1С.'
  })
})

const { data } = await res.json()
console.log('Log ID:', data.LOG_ID)

Ответ (201):

JSON

{
  "success": true,
  "data": {
    "LOG_ID": 5012
  }
}