Храните готовность аудиозаписи, результат распознавания и доставку в 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 временно недоступна, но текст сохранён.
- Контакт объединён до прихода текста: цель пересматривается безопасно.
- Оператор исправил текст раньше позднего ответа сервиса.
Не теряйте связь с активностью при объединении контактов или переносе сделки. Перед записью позднего результата подтвердите актуальную цель и разрешённый проект. Если активность удалена, не создавайте случайную новую карточку по номеру: оставьте результат в ограниченной очереди разбора. Для первого внедрения полезнее схема состояний и журнал доставки на искусственном аудио, чем массовая отправка всей истории разговоров.