Цифра «длительность звонка» неоднозначна. Она может означать всё время от запуска набора до отбоя, только интервал после ответа, продолжительность записи или сумму нескольких плеч. Сначала подпишите метрику в продукте и формулу в коде. Если менеджер ожидает время разговора, обычно нужна разность `end_at - answered_at`, а не `end_at - created_at`.

Не корректируйте расхождение прибавлением фиксированных секунд: ожидание ответа каждый раз разное. Возьмите Call ID, запросите финальную запись провайдера и разложите звонок на события. У Asterisk `duration` считается от Start до End, а `billsec` — от Answer до End; уже здесь две корректные, но разные величины.

Одна карточка содержит несколько часов

ПолеИнтервалДля чего подходит
queue timeдо начала фактического вызованагрузка платформы
ringing timeнабор/создание → ответскорость ответа
talk timeответ → завершениеразговор менеджера
total durationначало → завершениеполный путь вызова
recording durationаудиофайл после обработкиконтроль записи, не замена talk time

В интерфейсе лучше показывать понятное имя: «ожидание 18 с, разговор 2:41». Одно поле с названием duration провоцирует спор между CRM, биллингом и отчётом оператора, хотя каждая система считает собственный интервал.

Исходные timestamps хранятся рядом с результатом

Сохраните время создания, начала набора, ответа и завершения в UTC, а также статус, provider Call ID и версию события. Время в часовом поясе пользователя меняет отображение момента, но не должно менять разность двух UTC timestamps. Значение от провайдера храните отдельно от вычисленного, чтобы расхождение можно было объяснить, а не потерять при очередном webhook.

call_id: CA...
parent_call_id: CA...
created_at: 2026-10-08T18:00:00Z
answered_at: 2026-10-08T18:00:18Z
ended_at: 2026-10-08T18:02:59Z

talk_seconds = 161
total_seconds = 179
source = provider_final_record

У Twilio terminal status callback передаёт `CallDuration` в секундах, а отдельные запросы callback могут прийти не в том же порядке, в котором были отправлены. Поэтому upsert сравнивает последовательность или допустимый переход состояния. После terminal event полезно выполнить reconciliation: прочитать итоговый Call resource и закрыть запись авторитетными данными провайдера.

Перевод и конференция создают новые плечи

При переадресации клиент сначала разговаривает с очередью или первым агентом, затем создаётся другое соединение со вторым агентом. Asterisk описывает CDR как один путь между двумя endpoints; один пользовательский звонок может породить несколько CDR, связанных `linkedid`. У Twilio дочернее плечо содержит `parentCallSid`. Сумма всех legs часто завышает время, потому что интервалы способны пересекаться.

  • Хранить каждое leg отдельной строкой с provider ID и parent/linked ID.
  • Выбрать правило карточки: клиентский разговор, разговор ответственного менеджера или уникальная временная шкала.
  • Не суммировать одновременно bridge и оба его дочерних плеча.
  • Для конференции явно определить, считается ли время комнаты или индивидуальное присутствие агента.

Повторный webhook не добавляет секунды

Сетевой повтор одного события — нормальная ситуация. Обработчик делает idempotent upsert по provider Call ID и типу/версии события, а не `duration = duration + delta`. Переход из terminal состояния обратно в ringing отклоняется. Если пришёл поздний `answered`, он может заполнить пустое поле, но не должен стереть более новый `ended_at`.

  1. Записать raw event в закрытый журнал и подтвердить приём.
  2. Найти call leg по стабильному ID провайдера.
  3. Проверить допустимость перехода и порядок события.
  4. Пересчитать производные интервалы из timestamps.
  5. После terminal статуса сверить итоговый ресурс провайдера.

Пять сценариев ловят большинство расхождений

Набор проверок включает: вызов без ответа, busy, обычный разговор, перевод на второго агента и конференцию с пересечением legs. Для каждого заранее задайте ожидаемые ringing, talk и total значения. Затем дважды доставьте один callback и поменяйте местами `answered` с terminal event: результат обязан остаться тем же.

Исправление готово, когда карточка называет метрику, показывает источник, финальные timestamps совпадают с записью провайдера, а сложный звонок можно раскрыть до отдельных legs. Для поддержки достаточно Call ID, времени UTC, типов событий и вычисленных интервалов; номера участников и запись разговора в обычный технический лог не копируют.

Проверенные источники