Everglow Agent API

Base URL: http://agent.ever-glow.ru

Авторизация: заголовок X-API-Key

Формат дат: YYYY-MM-DD

Валюта: RUB (российские рубли)

OpenAPI spec: http://agent.ever-glow.ru/openapi.json

curl -H "X-API-Key: ega_YOUR_KEY" http://agent.ever-glow.ru/analytics/summary?start_date=2025-01-01&end_date=2025-01-31

{
  "data": { ... },
  "metadata": {
    "description": "Описание данных",
    "filters_applied": { "start_date": "2025-01-01", ... },
    "currency": "RUB"
  },
  "field_hints": {
    "leads": "Количество новых лидов за период",
    "revenue": "Выручка в рублях"
  }
}

GET/analytics/summary

Ключевые метрики: лиды, записи, визиты, выручка, конверсии, LTV, ROI.

Параметр	Тип	Обязательный	Описание
start_date	date	нет	Начало периода
end_date	date	нет	Конец периода
source	string	нет	Источник лида (Instagram, VK, Site...)
studio	string	нет	Название студии
status	string	нет	Статус сделки
pipeline_id	int	нет	ID воронки (по умолчанию 2146744)
manager_id	int	нет	ID менеджера

Возвращает: leads, records, visits, revenue, realized_revenue, cost, roi, avg_check, cpl, conversion_record, conversion_visit, sales_cycle, ltv и др.

GET/analytics/trend

Количество лидов по дням/неделям/месяцам.

Параметр	Тип	Обязательный	Описание
start_date	date	нет	Начало периода
end_date	date	нет	Конец периода
group_by	string	нет	day (по умолч.), week, month
source	string	нет	Фильтр по источнику
studio	string	нет	Фильтр по студии
pipeline_id	int	нет	ID воронки
manager_id	int	нет	ID менеджера

Возвращает: массив [{"label": "2025-01-15", "value": 42}]

GET/analytics/funnel

Количество сделок на каждом этапе воронки.

Параметр	Тип	Обязательный	Описание
start_date	date	нет	Начало периода
end_date	date	нет	Конец периода
source / studio / pipeline_id / manager_id	—	нет	Стандартные фильтры

Возвращает: {"total": 5000, "stages": [{"id": "142", "label": "Успешно реализовано", "value": 3200}]}

GET/analytics/sources

Источники лидов с количеством и конверсией в запись.

Параметр	Тип	Обязательный	Описание
start_date / end_date	date	нет	Период
studio / pipeline_id / manager_id	—	нет	Фильтры

Возвращает: массив [{"source": "Instagram", "count": 52, "booked": 44, "conversion_rate": 84.6}]

GET/analytics/roi

ROI по каждому источнику: лиды, расход, выручка, ROI%, CPL.

Параметр	Тип	Обязательный	Описание
start_date / end_date	date	нет	Период
studio / pipeline_id / manager_id	—	нет	Фильтры

Возвращает: [{"source": "VK", "leads": 43, "revenue": 154835, "spend": 50000, "roi": 209.7, "cpl": 1163}]

GET/customers

Поиск клиентов по телефону (автонормализация) или имени.

Параметр	Тип	Обязательный	Описание
search	string	нет	Телефон, имя или фамилия
skip	int	нет	Offset (default: 0)
limit	int	нет	Лимит 1-100 (default: 20)

Возвращает: {"items": [...], "total": 150, "page": 1, "size": 20}

GET/customers/{phone}

Полный профиль клиента: данные, активные пакеты, последние 10 визитов.

Параметр	Тип	Обязательный	Описание
phone	path	да	Телефон в любом формате (79161234567, +79161234567, 89161234567)

Возвращает: phone, first_name, last_name, segment, loyalty_tier, lifetime_value, total_visits, total_revenue, active_packages[], recent_visits[]

GET/deals

Список CRM-сделок с фильтрами. Удалённые сделки автоматически исключены.

Параметр	Тип	Обязательный	Описание
start_date	date	нет	Начало периода
end_date	date	нет	Конец периода
source	string	нет	Источник
studio	string	нет	Студия
status	string	нет	Статус/этап
pipeline_id	int	нет	ID воронки
manager_id	int	нет	ID менеджера
search	string	нет	Поиск по имени, телефону, ID сделки
skip	int	нет	Offset (default: 0)
limit	int	нет	Лимит 1-100 (default: 20)

Возвращает: {"items": [...], "total": 2329, "page": 1, "size": 20}

Поля сделки: id, name, customer_name, customer_phone, stage, stage_name, source_type, budget (RUB), pipeline_name, created_at_external