API коллтрекинга

REST API даёт программный доступ ко всем звонкам, проектам и источникам. Используется для интеграций с собственной BI, CRM, дашбордами и сквозной аналитикой.

Авторизация

Ключ API создаётся в ЛК Мультиком → «Интеграции» → «Ключи API». Передаётся в заголовке:

Authorization: Bearer ВАШ_ТОКЕН

Основные эндпоинты

Метод и путь	Назначение
GET /api/calltracking/projects	Список ваших проектов коллтрекинга
GET /api/calltracking/calls	Журнал звонков с UTM и источниками
GET /api/calltracking/sources	Агрегат по источникам
POST /api/calltracking/webhook	Регистрация вебхука для событий в реальном времени

Пример запроса

curl -H "Authorization: Bearer ТОКЕН" \
     "https://api.mcm.ru/api/calltracking/calls?project_id=12&date_from=2026-04-01&date_to=2026-04-20"

Формат ответа

{
  "calls": [
    {
      "id": 987654,
      "date": "2026-04-15 14:22:05",
      "from": "+79161234567",
      "to": "+74951234567",
      "duration": 185,
      "answered": true,
      "recording": "https://api.mcm.ru/rec/...",
      "utm": {"source":"yandex","medium":"cpc","campaign":"brand","term":"мультиком"},
      "page": "https://example.ru/landing/"
    }
  ]
}