Цифра «длительность звонка» неоднозначна. Она может означать всё время от запуска набора до отбоя, только интервал после ответа, продолжительность записи или сумму нескольких плеч. Сначала подпишите метрику в продукте и формулу в коде. Если менеджер ожидает время разговора, обычно нужна разность `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`.
- Записать raw event в закрытый журнал и подтвердить приём.
- Найти call leg по стабильному ID провайдера.
- Проверить допустимость перехода и порядок события.
- Пересчитать производные интервалы из timestamps.
- После terminal статуса сверить итоговый ресурс провайдера.
Пять сценариев ловят большинство расхождений
Набор проверок включает: вызов без ответа, busy, обычный разговор, перевод на второго агента и конференцию с пересечением legs. Для каждого заранее задайте ожидаемые ringing, talk и total значения. Затем дважды доставьте один callback и поменяйте местами `answered` с terminal event: результат обязан остаться тем же.
Исправление готово, когда карточка называет метрику, показывает источник, финальные timestamps совпадают с записью провайдера, а сложный звонок можно раскрыть до отдельных legs. Для поддержки достаточно Call ID, времени UTC, типов событий и вычисленных интервалов; номера участников и запись разговора в обычный технический лог не копируют.