Устранение неполадок кодов ответа на завершение вызовов для Calling SDK, Call Automation SDK, ТСОП, Chat SDK и SMS SDK

Советы по устранению неполадок

При устранении неполадок следует учитывать следующие советы.

• Приложение не получает событие: убедитесь, что конечная IncomingCall Event Grid точка приложения проверена с помощью Event Grid при создании подписки на события. Состояние подготовки подписки на событие отмечается как "успешно", если валидация прошла успешно.
• The field CallbackUri is invalidОшибка: служба автоматизации вызовов не поддерживает конечные точки HTTP. Убедитесь, что указанный URL-адрес обратного вызова поддерживает HTTPS.
• Действие PlayAudio не воспроизводит ничего: в настоящее время поддерживается только формат файла Wave (.wav) для звуковых файлов. Звуковое содержимое в файле волны должно быть моно (одноканально), 16-разрядные образцы с частотой выборки 16 000 (16 КГц).
• Действия в конечных точках ТСОП не работают: для CreateCall, Transfer, AddParticipant и Redirect для номеров телефонов необходимо задать SourceCallerId в запросе действия. Если вы не используете прямую маршрутизацию, идентификатор исходного абонента должен быть номером телефона, принадлежащим ресурсу Служб коммуникации, чтобы действие успешно выполнено.

Дополнительные сведения о проблемах, отслеживаемых командой продуктов, см. в разделе "Известные проблемы".

Понимание ошибок кодов вызова и подкодов

Коды ошибок, подкоды и соответствующие категории результатов помогают разработчикам выявлять и диагностировать ошибки. Эти коды ошибок предоставляются с помощью свойства call.callEndReason после завершения вызова.

Ниже приведены сведения об коде ошибки:

Код — это 3 цифры целых чисел, представляющих состояние ответа клиента или сервера. Категории кода:

• Успешные ответы (200–299)
• Ошибка клиента (400-499)
• Ошибка сервера (500-599)
• Глобальная ошибка (600-699)

Вложенный код — определяется как целое число, где каждое число указывает уникальную причину, конкретную для группы сценариев или конкретных результатов сценария.

Сообщение . Описывает результат и предоставляет указания, как устранить проблему, если результат является сбоем.

ResultCategory — указывает тип ошибки. В зависимости от контекста значение может быть Success, ExpectedErrorUnexpectedClientErrorили UnexpectedServerError.

Azure Communication Services: коды ошибок клиента и подчиненные коды для вызова SDK

Для ошибок клиента, если свойство resultCategories имеет значение ExpectedError, эта ошибка ожидается с точки зрения SDK. Такие ошибки часто возникают при сбоях предварительных условий, таких как неверные аргументы, передаваемые приложением, или когда текущее состояние системы не разрешает вызов API. Приложение должно проверить причину ошибки и логику вызова API.

Понимание ошибок кодов вызова и подкодов

Коды ошибок, подкоды и соответствующие категории результатов помогают разработчикам выявлять и диагностировать ошибки. Эти коды ошибок предоставляются с помощью свойства call.callEndReason после завершения вызова.

Ниже приведены сведения об коде ошибки:

Код — это 3 цифры целых чисел, представляющих состояние ответа клиента или сервера. Категории кода:

• Успешные ответы (200–299)
• Ошибка клиента (400-499)
• Ошибка сервера (500-599)
• Глобальная ошибка (600-699)

Вложенный код — определяется как целое число, где каждое число указывает уникальную причину, конкретную для группы сценариев или конкретных результатов сценария.

Сообщение . Описывает результат и предоставляет указания, как устранить проблему, если результат является сбоем.

ResultCategory — указывает тип ошибки. В зависимости от контекста значение может быть Success, ExpectedErrorUnexpectedClientErrorили UnexpectedServerError.

Коды завершения вызова и подкод завершения вызова

Существуют различные объяснения по поводу того, почему звонок закончился. Ниже приведены значения конца кодов вызовов и подкодов, которые показывают, как вызов может завершиться.

Общие сведения о кодах вызовов и подкодах

Когда получены коды ошибок?

Коды ошибок для автоматизации вызовов могут поступать как синхронные ответы на вызовы API или асинхронные ответы с помощью предоставленного URI обратного вызова. В синхронной ситуации, если вызов API выполнен и он не принят, ACS предоставит код ошибки, описывающий, почему вызов API был отклонен. В асинхронных сценариях, если вызов API выполнен и принимается, но что-то по-прежнему происходит неправильно, получено как событие обратного вызова, так и код ошибки. Пример общего события обратного вызова для сбоев вызовов — событие callDisconnected, которое возникает при отключении вызова. После получения события callDisconnected больше не будет событий обратного вызова для данного вызова. Список событий обратного вызова для вызова см. на этой странице и список событий обратного вызова для действий мультимедиа (эта страница).

Синтаксис кода ошибки

Коды ошибок, подкоды и соответствующие категории результатов помогают разработчикам выявлять и диагностировать ошибки. Ниже приведены сведения об коде ошибки:

Код — это 3 цифры целых чисел, представляющих состояние ответа клиента или сервера. Категории кода:

• Успешные ответы (200–299)
• Ошибка клиента (400-499)
• Ошибка сервера (500-599)
• Глобальная ошибка (600-699)

Вложенный код — определяется как целое число, где каждое число указывает уникальную причину, конкретную для группы сценариев или конкретных результатов сценария.

Сообщение . Описывает результат и предоставляет указания, как устранить проблему, если результат является сбоем.

Помимо кода и подкода, более подробные сведения об устранении неполадок можно найти в журналах вызовов. Дополнительные сведения о включении и доступе к журналам вызовов см. на этой странице с подробными инструкциями.

Коды ошибок пакета SDK для службы автоматизации вызовов

В следующей таблице содержатся наиболее распространенные коды и подкоды. Если ошибка отсутствует в этой таблице, ознакомьтесь с универсальными кодами и подкодами, чтобы получить дополнительные сведения о конкретном сценарии.

Коды ошибок службы автоматизации вызовов

Универсальные коды ошибок

Коды 2xx

Код 2xx представляет успешный ответ. Подкод для успешных ответов будет иметь значение 0.

Коды 4xx

Код 4xx представляет ошибку клиента.

Коды 5xx

Код 5xx представляет ошибку сервера.

Коды 6xx

Код 6xx представляет глобальную ошибку.

Универсальные вложенные коды

Коды диагностики SIP и Q.850 в событиях обратного вызова

События обратного вызова службы автоматизации вызовов теперь поддерживают низкоуровневые диагностические данные через SipDetails поля и Q850Details добавлены в существующий ResultInformation объект.
Эти аналитические сведения об уровне протокола диагностики на уровне телекоммуникационных сигналов, помогающие устранять такие проблемы, как падение вызовов, недоступные назначения или непредвиденные отклонения в сценариях ТСОП и SIP/VoIP.

Доступность

Затронутые события

Следующие события могут включаться SipDiagnosticInfo в их ResultInformation:

• RemoveParticipantsFailed
• AddParticipantsFailed
• CreateCallFailed
• AnswerFailed
• CallDisconnected
• TransferFailed
• CanAddParticipantFailed

На практике любое событие обратного вызова, содержащее ResultInformation эти данные диагностики, при условии SBC/carrier.

Структура

Каждая диагностика представлена как объект:

Эти поля являются необязательными и отображаются только при указании SBC/carrier.

Example

{
  "ResultInformation": {
    "Code": 500,
    "SubCode": 560503,
    "Message": "Unexpected server error",
    "SipDetails": {
      "Code": 486,
      "Message": "Busy Here"
    },
    "Q850Details": {
      "Code": 17,
      "Message": "User busy"
    }
  }
}

Коды ответа вызовов ТСОП с ParticipantEndReason

В этом разделе содержатся сведения об устранении неполадок для различных сочетаний кодов ответов ParticipantEndReason и ParticipantEndSubCode. В таблицах в этом разделе приведены ParticipantEndReason = код и ParticipantEndSubCode = вложенный код.

В качестве общего руководства, если значение ParticipantEndSubCode начинается с 560 или 540, это указывает, что SBC пользователя/оператора сгенерировал код ответа. Это полезно для устранения неполадок с вызовами прямой маршрутизации, так как подкод может помочь определить, исходит ли ошибка из вашего SBC или службы Microsoft. Вложенный код, начинающийся с 560, представляет исходящий вызов, а подкод, начиная с 540, представляет входящий вызов. В любом случае проверьте журналы SBC.

Например, если ParticipantEndSubCode значение равно 560403, это означает, что он был исходящим вызовом, SBC создал окончательный код ответа, а код ответа SIP из SBC составил 403. Начните устранять неполадки с вызовами, проверяя журналы SBC.

Для ParticipantEndSubCode ответов, которые не начинаются с 560 или 540, служба Майкрософт создала окончательный код ответа.

УчастникEndReason 0

Ответ ParticipantEndReason со значением 0 обычно означает обычное очистку вызовов и помечает вызовы, которые завершены без ошибок.

УчастникEndReason 4xx

Ответ ParticipantEndReason со значением 4xx означает, что вызов не подключится.

УчастникEndReason 5xx

Ответ ParticipantEndReason со значением 5xx означает, что вызов завершился ошибкой из-за проблемы с программным или аппаратным компонентом, необходимым для завершения подключения.

УчастникEndReason 603

Ответ ParticipantEndReason со значением 603 означает, что вызов был отклонен без подключения.

Коды ошибок пакета SDK для чата

Пакет SDK чата использует следующие коды ошибок для устранения неполадок чата. Коды ошибок предоставляются через свойство error.code в отклике на ошибку.

Коды ошибок SMS

Пакет SDK SMS использует следующие коды ошибок, чтобы помочь вам устранить проблемы с SMS. Коды ошибок предоставляются в DeliveryStatusDetails поле в отчете о доставке SMS.