Храните готовность аудиозаписи, результат распознавания и доставку в CRM как три разных состояния. Завершённый звонок ещё не гарантирует доступное аудио, а готовый текст не означает созданную заметку. Начните с одной синтетической записи и проследите её ключ до конкретной активности CRM, не пересылая настоящие разговоры ради диагностики.

Обработка должна иметь разрешённое назначение и ограниченный доступ. Не отправляйте полное аудио или расшифровку в сторонний сервис только потому, что его API доступен. Сначала согласуйте допустимые данные, получателей и срок хранения по правилам проекта. Здесь разбирается техническая доставка уже разрешённого материала; юридическое основание записи не устанавливается этим конвейером.

Начинать распознавание следует после готовности записи

В Twilio Recordings resource перечислены состояния записи, включая processing, completed, absent и deleted; документация проверена 22 октября 2026 года. Состояние звонка не заменяет проверку ресурса записи. Адаптеру нужен отдельный путь для ожидания готовности и для случая, когда аудио отсутствует. Бесконечно повторять скачивание отсутствующей записи бессмысленно.

Условная цепочка:
call activity -> recording id
recording ready -> разрешённое задание распознавания
transcript revision -> проверенный результат
delivery key = project + activity + transcript revision
CRM note id -> подтверждение доставки
повтор доставки -> сверка того же результата

Связывайте текст с конкретной записью и разговором, а не с одним телефонным номером. Номер может участвовать в нескольких вызовах подряд. Храните также версию обработки: повторное распознавание другой моделью или исправление оператором создаёт новый результат. Старый ответ фонового сервиса не должен заменять более свежую проверенную редакцию.

Разведите ожидание и потерю результата

СостояниеСледующее действие
Аудио ещё обрабатываетсяОграниченное ожидание готовности
Аудио отсутствуетПричина и разбор без пустой расшифровки
Текст готов, CRM недоступнаПовторить доставку этой версии
CRM ответила, но ответ потерянСверить результат до нового создания
Текст исправлен человекомПрименить политику версий, не затирать молча

При потере ответа CRM нельзя считать заметку точно несозданной. Если API поддерживает ключ идемпотентности, используйте его по контракту; иначе нужен собственный реестр внешних ID и процедура сверки. Успешный HTTP-ответ о принятии фоновой задачи тоже не доказывает наличие текста в карточке. Проверяйте документированный конечный результат.

Показывайте оператору ссылку на исходную активность, статус текста и причину задержки. В общие логи достаточно технических ключей, размера и состояния: сами реплики могут содержать чувствительные данные. Маскирование перед доставкой и доступ к оригиналу — отдельные правила, а не замена контроля прав на заметки CRM.

Проверьте поздний текст и повторную доставку

  • Готовность записи приходит позже завершения вызова.
  • Повторный callback не создаёт второе распознавание той же версии.
  • CRM временно недоступна, но текст сохранён.
  • Контакт объединён до прихода текста: цель пересматривается безопасно.
  • Оператор исправил текст раньше позднего ответа сервиса.

Не теряйте связь с активностью при объединении контактов или переносе сделки. Перед записью позднего результата подтвердите актуальную цель и разрешённый проект. Если активность удалена, не создавайте случайную новую карточку по номеру: оставьте результат в ограниченной очереди разбора. Для первого внедрения полезнее схема состояний и журнал доставки на искусственном аудио, чем массовая отправка всей истории разговоров.

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