Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se describe la solución de problemas de códigos de respuesta de finalización de llamadas para el SDK de llamadas, la automatización de llamadas y las llamadas RTC.
Sugerencias de solución de problemas
Tenga en cuenta las siguientes sugerencias al solucionar problemas:
- La aplicación no recibe un evento
IncomingCall Event Grid: asegúrese de que el punto de conexión de la aplicación se valide con Event Grid al crear una suscripción de eventos. El estado de aprovisionamiento de la suscripción de eventos se marca como correcto si la validación se ha realizado correctamente. - Para el error
The field CallbackUri is invalid: la automatización de llamadas no admite puntos de conexión HTTP. Asegúrese de que la dirección URL de devolución de llamada que proporcione admita HTTPS. - La acción
PlayAudiono reproduce nada: actualmente solo se admite el formato de archivo Wave (.wav) para los archivos de audio. El contenido de audio del archivo Wave debe ser mono (un canal), muestras de 16 bits con una frecuencia de muestreo de 16 000 (16 KHz). - Las acciones en los puntos de conexión RTC no funcionan: para
CreateCall,Transfer,AddParticipantyRedirectpara números de teléfono, debe establecer enSourceCallerIdla solicitud de acción. A menos que use enrutamiento directo, el identificador del autor de la llamada de origen debe ser un número de teléfono propiedad del recurso de Communication Services para que la acción se realice correctamente.
Para obtener más información sobre los problemas que realiza el seguimiento del equipo del producto, consulte Problemas conocidos.
Note
Las categorías de mensajes y resultados enumeradas en las tablas siguientes se encuentran en versión preliminar pública. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.
Descripción de los códigos de llamada y errores de subcódigos
Los códigos de error, los subcódigos y las categorías de resultados correspondientes ayudan a los desarrolladores a identificar y diagnosticar errores. Estos códigos de error se exponen a través de la propiedad call.callEndReason después de que finaliza una llamada.
Los detalles del código de error incluyen:
Código: son números enteros de 3 dígitos que representan el estado de respuesta de cliente o servidor. Categorías de código:
- Respuestas correctas (200-299)
- Error de cliente (400-499)
- Error de servidor (500-599)
- Error global (600-699)
Subcódigo: se define como un entero, donde cada número indica un motivo único, específico de un grupo de escenarios o un resultado de escenario específico.
Mensaje: describe el resultado y proporciona sugerencias sobre cómo mitigar el problema si un resultado es un error.
ResultCategory: indica el tipo de error. Según el contexto, el valor puede ser Success, ExpectedError, UnexpectedClientError o UnexpectedServerError.
Códigos de error de cliente del SDK de llamadas de Azure Communication Services
En el caso de los errores de cliente, si la propiedad resultCategories es ExpectedError, normalmente significa que el error se espera desde la perspectiva del SDK. Estos errores se suelen encontrar en errores de condición previa, como argumentos incorrectos pasados por la aplicación o cuando el estado actual del sistema no permite la llamada API. La aplicación debe comprobar el motivo del error y la lógica para invocar la API.
| Subcode | Code | Message | Categoría de resultado | Advice |
|---|---|---|---|---|
| 40101 | 408 | No se ha podido crear CallAgent. Inténtelo de nuevo, si el problema persiste, recopile los registros de la consola del explorador, el archivo .HAR y póngase en contacto con el soporte técnico de Azure Communication Services. |
UnexpectedClientError | |
| 40104 | 408 | No se ha podido crear CallAgent. Inténtelo de nuevo, si el problema persiste, recopile los registros de la consola del explorador, el archivo .HAR y póngase en contacto con el soporte técnico de Azure Communication Services. |
UnexpectedClientError | |
| 40114 | 408 | No se ha podido conectar a la infraestructura de Azure Communication Services. Inténtelo de nuevo y compruebe las solicitudes de red del explorador. Si las solicitudes siguen fallando, recopile los registros de la consola del explorador, el archivo .HAR y póngase en contacto con el soporte técnico de Azure Communication Services. |
UnexpectedClientError | Para obtener más información, consulte Requisitos de red. |
| 40115 | 412 | No se ha podido crear CallAgent; no se ha podido inicializar la conexión a la infraestructura de Azure Communication Services. Inténtelo de nuevo y compruebe las solicitudes de red del explorador. Si las solicitudes siguen fallando, recopile los registros de la consola del explorador, el archivo .HAR y póngase en contacto con el soporte técnico de Azure Communication Services. |
UnexpectedClientError | Para obtener más información, consulte Requisitos de red. |
| 40216 | 500 | No se ha podido crear CallAgent. Inténtelo de nuevo, si el problema persiste, recopile los registros de la consola del explorador y póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 40228 | 409 | No se ha podido crear CallAgent; ya existe una instancia de CallAgent asociada a esta identidad. Elimine CallAgent existente o cree uno nuevo con una identidad diferente. | ExpectedError | |
| 40230 | 409 | No se ha podido crear TeamsCallAgent, ya existe una instancia de TeamsCallAgent asociada a esta identidad. Elimine TeamsCallAgent existente antes de crear uno nuevo. | ExpectedError | |
| 40606 | 405 | Error al enumerar altavoces, no es posible enumerar o seleccionar altavoces en Android Chrome, iOS Safari ni macOS Safari. | ExpectedError | La enumeración o selección del altavoz no se admite en Android Chrome, iOS Safari ni macOS Safari. El sistema operativo selecciona automáticamente el altavoz (dispositivo de salida). Obtenga más información sobre la administración de dispositivos y cómo mitigar mejor estos problemas. |
| 40613 | 400 | No se ha podido obtener permiso para usar el micrófono o la cámara, se ha denegado o ha fallado. Asegúrese de permitir los permisos en el explorador y en la configuración del sistema operativo. | ExpectedError | Obtenga más información sobre cómo controlar mejor los permisos de dispositivo. |
| 40614 | 500 | No se pudo solicitar permisos de dispositivo Asegúrese de permitir los permisos en la configuración del explorador y en la configuración del sistema operativo e inténtelo de nuevo. Si el problema persiste, recopile los registros de la consola del explorador y póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | Obtenga más información sobre cómo controlar mejor los permisos de dispositivo. |
| 41006 | 400 | No se ha podido aceptar la llamada entrante, no está en estado de llamada. Suscríbase al evento incomingCall de CallAgent para aceptar la llamada entrante. |
ExpectedError | Consulte los siguientes artículos para identificar la causa principal del problema - Recepción de una llamada entrante - Suscripción a eventos del SDK |
| 41007 | 400 | No se ha podido rechazar la llamada entrante, no está en estado de llamada. Suscríbase al evento incomingCall de CallAgent para rechazar la llamada entrante. |
ExpectedError | Consulte los siguientes artículos para identificar la causa principal del problema - Recepción de una llamada entrante - Suscripción a eventos del SDK |
| 41015 | 500 | No se ha podido desactivar el micrófono. Inténtelo de nuevo, si el problema persiste, recopile los registros de la consola del explorador y póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 41016 | 400 | No se ha podido reactivar el micrófono. Inténtelo de nuevo, si el problema persiste, recopile los registros de la consola del explorador y póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 41025 | 400 | No se ha podido iniciar el vídeo, la instancia de LocalVideoStream no es válida o está vacía. Pase una instancia de LocalVideoStream. | ExpectedError | Asegúrese de que el objeto pasado para iniciar el vídeo es una instancia de LocalVideoStream. Construya un LocalVideoStream mediante un objeto VideoDeviceInfo o un objeto MediaStream. Consulte los artículos siguientes para identificar la causa principal del problema: - Realización de una llamada con videocámara - Inicialización y detención del envío de vídeo local durante una llamada - Acceso al vídeo sin procesar |
| 41027 | 400 | No se ha podido iniciar el vídeo, el vídeo ya se ha iniciado. | ExpectedError | Vínculos útiles: - Realización de una llamada con videocámara - Inicialización y detención del envío de vídeo local durante una llamada |
| 41030 | 400 | No se ha podido detener el vídeo, el vídeo ya está detenido. | ExpectedError | Vínculos útiles: - Realización de una llamada con videocámara - Inicialización y detención del envío de vídeo local durante una llamada |
| 41032 | 400 | No se ha podido detener el vídeo, argumento no válido. LocalVideoStream usado como entrada no se está enviando actualmente. | ExpectedError | LocalVideoStream que se envía en la llamada, se almacena en la matriz Call.localVideoStreams[] y es de tipo Video o RawMedia. Consulte los artículos siguientes para identificar la causa principal del problema: - Realización de una llamada con videocámara - Inicialización y detención del envío de vídeo local durante una llamada - Acceso al vídeo sin procesar |
| 41033 | 500 | No se ha podido mantener la llamada. Inténtelo de nuevo, si el problema persiste, recopile los registros de la consola del explorador y póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 41034 | 500 | No se ha podido reanudar la llamada. Inténtelo de nuevo, si el problema persiste, recopile los registros de la consola del explorador y póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 41035 | 400 | No se ha podido iniciar el recurso compartido de pantalla, el recurso compartido de pantalla ya se ha iniciado. | ExpectedError | Obtenga más información sobre cómo iniciar y detener el uso compartido de pantalla mientras se realiza una llamada |
| 41041 | 400 | No se ha podido detener el recurso compartido de pantalla, el recurso compartido de pantalla ya está detenido. | ExpectedError | Obtenga más información sobre cómo iniciar y detener el uso compartido de pantalla mientras se realiza una llamada |
| 41048 | 410 | No se ha podido iniciar el vídeo durante el proceso de configuración de llamadas. Asegúrese de permitir permisos de vídeo en la configuración del explorador y en la configuración del sistema operativo y asegúrese de que otro proceso no use el dispositivo de cámara. | UnexpectedClientError | - El dispositivo de cámara puede estar deshabilitado en el sistema. - Otra cámara está siendo utilizada por otro proceso. |
| 41056 | 412 | No se ha podido iniciar o unirse a la llamada, la directiva de voz empresarial de Teams no está habilitada para este recurso de Azure Communication Services. Siga el tutorial en línea para habilitarlo. | ExpectedError | Vea cómo habilitar usuarios para la Telefonía IP empresarial en línea y el correo de voz del Sistema telefónico para habilitar la directiva de voz empresarial de Teams |
| 41071 | 412 | No se ha podido iniciar el recurso compartido de pantalla, la llamada no está en estado Conectado. - Suscríbase al evento stateChanged de la llamada para saber cuándo está conectada la llamada. |
ExpectedError | Vínculos útiles: - Comprobación de las propiedades de llamada - Suscripción a eventos del SDK |
| 41073 | 412 | No se ha podido obtener o establecer MediaStream personalizado, esta funcionalidad está deshabilitada actualmente por Azure Communication Services. | ExpectedError | |
| 43000 | 412 | No se ha podido iniciar el vídeo, otro proceso o aplicación está usando el dispositivo de vídeo. Deje de usar la cámara en el otro proceso o aplicación y vuelva a intentarlo. | ExpectedError | Más información sobre la mejor manera de tratar con una cámara que está siendo utilizada por otro proceso |
| 43001 | 403 | No se ha podido iniciar el vídeo, no se ha concedido permiso para usar el dispositivo de vídeo seleccionado. Asegúrese de que los permisos del dispositivo de vídeo están concedidos en la configuración del explorador y en la configuración del sistema. | ExpectedError | Asegúrese de que se conceden permisos de cámara en la configuración del explorador y en la configuración del sistema del dispositivo. Asegúrese de que las cámaras no están deshabilitadas en la configuración del sistema del dispositivo. En macOS, asegúrese de que se permite la grabación de pantalla desde la configuración del sistema. Vínculos útiles: - Solicitud de permisos de dispositivo- Permisos de uso compartido de pantalla en macOS - Enumeración o acceso de dispositivos para Safari en macOS y iOS |
| 43002 | 500 | No se ha podido iniciar el vídeo, error desconocido. Inténtelo de nuevo. Si el problema persiste, póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 43004 | 400 | No se ha podido cambiar el dispositivo de vídeo, entrada no válida. La entrada debe ser de un tipo VideoDeviceInfo. | ExpectedError | Use el administrador de dispositivos para obtener una lista de objetos VideoDeviceInfo y, a continuación, use el objeto VideoDeviceInfo para cambiar el origen. Obtenga más información sobre cómo iniciar y detener el envío de vídeo local mientras se realiza una llamada |
| 43005 | 400 | No se ha podido cambiar el dispositivo de vídeo, no se puede cambiar al mismo dispositivo de vídeo, ya está seleccionado. | ExpectedError | |
| 43013 | 412 | No se ha podido iniciar el vídeo, no se ha encontrado ningún dispositivo de vídeo. Asegúrese de que los dispositivos de vídeo están conectados y habilitados en la configuración del sistema. | ExpectedError | Asegúrese de que tiene una cámara conectada e instalada en el dispositivo. |
| 43014 | 412 | No se ha podido iniciar el vídeo, error al solicitar la secuencia multimedia. Inténtelo de nuevo, si el problema persiste, póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 43015 | 412 | No se ha podido iniciar el vídeo, se ha agotado el tiempo de espera de la solicitud de transmisión multimedia. Permita el permiso en el símbolo del sistema del explorador para acceder a la cámara e inténtelo de nuevo. | ExpectedError | Este error puede producirse si el usuario no realiza ninguna acción en la solicitud de permiso del explorador para permitir el acceso a la cámara. |
| 43016 | 412 | No se ha podido iniciar el vídeo, permisos denegados por el sistema. Asegúrese de que los permisos del dispositivo de vídeo están concedidos en la configuración del explorador y en la configuración del sistema. | ExpectedError | - Asegúrese de que se conceden permisos de cámara en la configuración del explorador y en la configuración del sistema del dispositivo. - Asegúrese de que las cámaras no están deshabilitadas en la configuración del sistema del dispositivo. - En macOS, asegúrese de que se permite la grabación de pantalla desde la configuración del sistema. Vínculos útiles: - Solicitud de permisos de dispositivo - Permisos de uso compartido de pantalla en macOS - Enumeración o acceso de dispositivos para Safari en macOS y iOS |
| 43017 | 412 | No se ha podido iniciar el vídeo, secuencia no admitida. Inténtelo de nuevo, si el problema persiste, póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 43018 | 412 | No se ha podido iniciar el vídeo, no se pudieron establecer restricciones. Inténtelo de nuevo, si el problema persiste, póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | Obtenga más información sobre cómo establecer restricciones de vídeo |
| 43019 | 412 | No se ha podido iniciar el vídeo, no se seleccionó ningún dispositivo. Asegúrese de pasar un objeto LocalVideoStream construido con un VideoDeviceInfo e inténtelo de nuevo. Si el problema persiste, póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | Vínculos útiles: - Realización de una llamada con videocámara - Inicialización y detención del envío de vídeo local durante una llamada |
| 43200 | 412 | No se ha podido representar la secuencia de vídeo, esta secuencia no está disponible. Suscríbase a la propiedad isAvailable de la secuencia para recibir notificaciones cuando el participante remoto tenga su vídeo activado y la secuencia esté disponible para su representación. | ExpectedError | Vínculos útiles: - Representación de secuencias de vídeo o pantallas de participantes remotos - Adición de videollamadas 1:1 a la aplicación - Suscripción a eventos del SDK |
| 43202 | 404 | No se ha podido representar la secuencia de vídeo, esta secuencia ya no está disponible. El participante remoto ha desactivado su vídeo. | ExpectedError | El participante remoto ha desactivado su vídeo al intentar crear una vista para él. |
| 43203 | 408 | No se ha podido representar la secuencia de vídeo, la representación se ha interrumpido mientras se esperaban los fotogramas de vídeo. Inténtelo de nuevo, si el problema persiste, póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 43204 | 500 | No se ha podido representar la secuencia de vídeo, no se ha podido suscribir al vídeo en la infraestructura de Azure Communication Services. Inténtelo de nuevo, si el problema persiste, póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 43209 | 405 | No se ha podido representar la secuencia de vídeo, VideoStreamRenderer se ha eliminado durante el proceso de inicialización. | ExpectedError | |
| 43210 | 400 | No se pudo eliminar VideoStreamRenderer porque ya se ha eliminado. | ExpectedError | |
| 43220 | 400 | No se ha podido crear la vista, el número máximo de vistas activas RemoteVideoStream ya se ha alcanzado. Puede eliminar una para crear una nueva. |
ExpectedError | Obtenga más información sobre cómo admitir correctamente el mejor número de secuencias de vídeo entrantes |
| 71005 | 401 | Error en la llamada debido a un error de validación en Azure Communication Services. Inténtelo de nuevo, si el problema persiste, póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 480 | Punto de conexión remoto del cliente no registrado. | Asegúrese de que el punto de conexión remoto está disponible. | ||
| 481 | No se pudo controlar la llamada entrante. | Envíe una solicitud de soporte técnico mediante Azure Portal. | ||
| 487 | Llamada cancelada, rechazada localmente, finalizada debido a un problema de falta de coincidencia de punto de conexión o no se pudo generar una oferta multimedia. | Comportamiento esperado. | ||
| 490, 491, 496, 497, 498 | Problemas de red en el punto de conexión local. | Compruebe la red. | ||
| 503, 504 | Error de infraestructura de Communication Services. | Envíe una solicitud de soporte técnico mediante Azure Portal. | ||
| 600 | Ocupado en todas partes. El participante contactó correctamente, pero la señal de la línea estaba ocupada. | Comportamiento esperado. | ||
| 603 | Un participante remoto de Communication Services ha rechazado globalmente la llamada. | Comportamiento esperado. | ||
| 604 | No existe en ningún lugar. El URI solicitado no existe. | Comportamiento esperado. | ||
| 606 | No es aceptable. El participante ha contactado correctamente, pero no puede asistir a la sesión descrita. | Comportamiento esperado. |
Descripción de los códigos de llamada y errores de subcódigos
Los códigos de error, los subcódigos y las categorías de resultados correspondientes ayudan a los desarrolladores a identificar y diagnosticar errores. Estos códigos de error se exponen a través de la propiedad call.callEndReason después de que finaliza una llamada.
Los detalles del código de error incluyen:
Código: son números enteros de 3 dígitos que representan el estado de respuesta de cliente o servidor. Categorías de código:
- Respuestas correctas (200-299)
- Error de cliente (400-499)
- Error de servidor (500-599)
- Error global (600-699)
Subcódigo: se define como un entero, donde cada número indica un motivo único, específico de un grupo de escenarios o un resultado de escenario específico.
Mensaje: describe el resultado y proporciona sugerencias sobre cómo mitigar el problema si un resultado es un error.
ResultCategory: indica el tipo de error. Según el contexto, el valor puede ser Success, ExpectedError, UnexpectedClientError o UnexpectedServerError.
Llamar a códigos de finalización de llamada y subcódigos
Hay diferentes explicaciones de por qué finalizó una llamada. Estos son los significados de los códigos de finalización de llamada y los subcódigos que muestran cómo puede terminar una llamada.
| Subcode | Code | Message | Categorías de resultados | Advice |
|---|---|---|---|---|
| 0 | 0 | La llamada la finalizó correctamente el participante local. | Success | |
| 0 | 487 | La llamada finalizó correctamente porque el autor de llamada la canceló. | Success | |
| 0 | 603 | La llamada finalizó correctamente porque el destinatario la rechazó. | Success | La llamada finalizó porque se rechazó del usuario objetivo a través del SDK de cliente, automatización de llamadas, Graph, PSTN o la función de rechazo de Teams. |
| 7 | 496 | La llamada finalizó porque el cliente perdió la conexión de red abruptamente y, a pesar de reintentar varias veces, no pudo conectarse | ExpectedError | El explorador está sin conexión o tiene problemas de red. Compruebe la conexión de red del explorador y vuelva a intentarlo. |
| 3100 | 410 | Error en la configuración de la llamada debido a un problema de red inesperado en el cliente. Compruebe la red del cliente y vuelva a intentarlo. | UnxpectedClientError | Compruebe la configuración de red y asegúrese de que sigue los requisitos de red de llamadas de comunicación de Azure. |
| 3101 | 410 | La llamada finalizó debido a un problema de red inesperado en el cliente. Compruebe la red del cliente y vuelva a intentarlo. | UnxpectedClientError | Compruebe la configuración de red y asegúrese de que sigue los requisitos de red de llamadas de comunicación de Azure. |
| 3111 | 410 | Error en la configuración de la llamada; no se puede procesar la oferta de elementos multimedia al conectar la llamada. | UnxpectedClientError | Inténtelo de nuevo. Si el problema persiste, recopile la información de la llamada, los registros del cliente, los registros de la consola del explorador y póngase en contacto con el soporte técnico de Azure Communication Services. |
| 3112 | 410 | Error en la configuración de la llamada debido a un problema de configuración de red en el lado cliente. Compruebe la configuración de red del cliente y vuelva a intentarlo. | ExpectedError | Obtenga más información sobre una llamada que termina con un subcódigo de 3112 aquí. |
| 4097 | 0 | El organizador de la reunión finalizó la llamada para todos los usuarios. | Success | |
| 4502 | 490 | Error de llamada debido a problemas de conectividad de red; el explorador no pudo completar la solicitud HTTP de red. | UnexpectedClientError | El cliente no pudo completar la solicitud y la respuesta HTTP. Inténtelo de nuevo. Si el problema persiste, recopile la información de la llamada, los registros del cliente, los registros de la consola del explorador y póngase en contacto con el soporte técnico de Azure Communication Services. |
| 4506 | 408 | Tiempo de espera de llamada agotado. Compruebe si el destinatario recibió y aceptó la llamada. | UnexpectedClientError | Inténtelo de nuevo. Si el problema persiste, recopile la información de la llamada, los registros del cliente, los registros de la consola del explorador y póngase en contacto con el soporte técnico de Azure Communication Services. |
| 4507 | 495 | La llamada finalizó porque la aplicación no proporcionó un token de Azure Communication Services válido. | UnexpectedClientError | Asegúrese de que la aplicación implementa correctamente el mecanismo de actualización de tokens. |
| 4521 | 0 | La llamada finalizó porque el usuario se desconectó de la llamada abruptamente. Esto puede deberse a que un usuario ha cerrado la aplicación que hospeda la llamada, por ejemplo,si un usuario finalizó la aplicación cerrando la pestaña del explorador sin terminar la llamada correctamente. | ExpectedError | |
| 5000 | 0 | La llamada finalizó para este participante. Participante eliminado de la conversación por otro participante. | Success | |
| 5003 | 0 | Azure Communication Service finalizó la llamada ya que la llamada ha finalizado. | Success | |
| 5300 | 0 | La llamada finalizó para este participante porque otro participante le retiró de la conversación. | Success | La llamada finalizó para este participante ya que otro participante lo quitó; podría ser otro cliente, la API de automatización de llamadas, Graph API. |
| 5317 | 0 | El participante de destino se quita debido a una actualización del rol de participante. | ExpectedError | |
| 5828 | 403 | La unión no está autorizada para la reunión en Salas, ya que el usuario no forma parte de la lista de invitados. | UnexpectedClientError | |
| 5829 | 403 | No se permite unirse a la reunión en Salas después de la hora de finalización o antes de la hora de inicio de la reunión. | UnexpectedClientError | |
| 5830 | 403 | Solo se permite al usuario de Communication Services unirse a la reunión en Salas. | ExpectedError | |
| 7000 | 0 | La API de automatización de llamadas de Azure Communication Service o un bot de servidor finalizaron la llamada. | Success | La API de automatización de llamadas de ACS o el bot de Graph finalizaron la llamada. |
| 10003 | 487 | La llamada se canceló para este punto de conexión de usuario ya que otro punto de conexión la aceptó en otro lugar. | Success | Se ha iniciado una llamada al usuario de destino (llamada inicial, agregar participante, transferencia); el usuario de destino tenía varios puntos de conexión activos al mismo tiempo; en uno de los puntos de conexión, el usuario aceptó la llamada. Este es un comportamiento normal: solo un punto de conexión puede aceptar y conectarse a una llamada. Todos los demás puntos de conexión reciben el subcódigo 10003 para indicar que ya se aceptó la llamada. |
| 10004 | 487 | La llamada se canceló en tiempo de expiración, ya que el usuario de destino no la aceptó ni la rechazó a tiempo. Asegúrese de que el usuario vea la notificación o que la aplicación pueda controlarla automáticamente e intentar iniciar esa llamada de nuevo. | ExpectedError | La llamada se canceló después de una cantidad de tiempo predefinida (normalmente 2 minutos) ya que el usuario de destino no la aceptó ni rechazó. |
| 10009 | 401 | Identidad no autenticada. Asegúrese de que el token de Azure Communication Services es válido y no ha expirado. | UnexpectedClientError | |
| 71005 | 401 | Error en la llamada debido a un error de validación en Azure Communication Services. Inténtelo de nuevo, si el problema persiste, póngase en contacto con el soporte técnico de Azure Communication Services. | UnexpectedClientError | |
| 10024 | 487 | La llamada finalizó correctamente. Llamada rechazada por todos los puntos de conexión de la llamada. | Success | Intente volver a realizar la llamada. |
| 10037 | 480 | El usuario de destino no tenía ningún punto de conexión registrado con ACS. Asegúrese de que el usuario de destino tenga al menos un punto de conexión activo y esté en línea. | ExpectedError | Si el usuario de destino usa el SDK de llamadas de Azure Communication Services, asegúrese de que el SDK se inicializa correctamente en su aplicación cliente. Si el usuario de destino es un usuario de Teams, asegúrese de que su cliente esté en línea. Asegúrese de que el identificador del usuario de destino (CommunicationUserIdentifier, MicrosoftTeamsUserIdentifier o MicrosoftTeamsBotIdentifier) sea correcto. Si user de Graph API tiene la propiedad department establecida en Microsoft Communication Application Instance, se debe especificar MicrosoftTeamsBotIdentifier. |
| 10057 | 408 | Error de llamada, el destinatario de la llamada no pudo finalizar la configuración de la llamada. Lo más probable es que el destinatario perdiera la red o finalizara la aplicación abruptamente. Asegúrese de que los clientes están conectados y disponibles. | ExpectedError | |
| 10076 | 480 | El usuario de destino se registró, pero no estaba en línea en el momento de la llamada. Asegúrese de que el usuario de destino tenga al menos un punto de conexión activo y esté en línea. | ExpectedError | Si el usuario de destino usa el SDK de llamadas de Azure Communication Services, asegúrese de que el SDK se inicializa correctamente en su aplicación cliente y que su punto de conexión esté en línea. Si el usuario de destino es un usuario de Teams, asegúrese de que su cliente esté en línea. |
| 10077 | 480 | El usuario de destino se ha registrado con ACS o para las notificaciones de inserción, pero no estaba en línea en el momento de la llamada. Asegúrese de que el usuario de destino tenga al menos un punto de conexión activo y esté en línea. | ExpectedError | Si el usuario de destino usa el SDK de llamadas de Azure Communication Services, asegúrese de que el SDK se inicializa correctamente en su aplicación cliente y que su punto de conexión esté en línea. Si la aplicación aprovecha las notificaciones de inserción, asegúrese de que estén configuradas correctamente. Si el usuario de destino es un usuario de Teams, asegúrese de que su cliente esté en línea. |
| 10078 | 480 | Punto de conexión de cliente remoto no registrado o no accesible. Asegúrese de que el punto de conexión de cliente remoto envía correctamente las solicitudes de red a Azure Communication Services. | ExpectedError | - Si el usuario de destino usa el SDK de llamadas de Azure Communication Services, asegúrese de que el SDK se inicializa correctamente en su aplicación cliente y que su punto de conexión esté en línea. Si la aplicación aprovecha las notificaciones de inserción, asegúrese de que estén configuradas correctamente. - Si el usuario de destino es un usuario de Teams, asegúrese de que su cliente esté en línea. |
| 301004 | 410 | La infraestructura de Azure Communication Services quitó al participante de la llamada debido a la incapacidad de establecer la conectividad multimedia con la infraestructura de Azure Communication Services durante la configuración de llamadas. Compruebe la configuración de red del usuario, incluida la red local, los firewalls, la configuración de VPN y vuelva a intentarlo. | UnexpectedClientError | Asegúrese de que la red del usuario esté configurada correctamente y siga la documentación pública de “Recomendaciones de red”. |
| 301005 | 410 | Participante quitado de la llamada por la infraestructura de Azure Communication Services debido a la pérdida de conectividad multimedia con la misma infraestructura. Esto suele ocurrir si el participante deja la llamada abruptamente o pierde la conectividad de red. Si el participante quiere continuar la llamada, puede volver a conectarse. | UnexpectedClientError | Asegúrese de que usa el SDK más reciente en un entorno compatible. |
| 540000 | 0 | La llamada la finalizó correctamente el autor de llamada de RTC local. | Success | |
| 510403 | 403 | Llamada bloqueada: - No se encontró ninguna ruta de voz coincidente para el número marcado. - Id. alternativo no proporcionado para la llamada. - Número de teléfono no permitido por los usuarios del Controlador de límites de sesión (CLS). - Anteriormente marcaba como correo no deseado y ahora bloqueado. |
ExpectedError | Para obtener más información sobre el identificador alternativo, vea Administrar llamadas. - Confirme que tiene una ruta de voz válida para el número marcado. - Asegúrese de que especificó un identificador alternativo válido. Debe ser un número de teléfono que pertenezca al recurso que está usando. - Compruebe que posee el recurso que usa para realizar una llamada. - Para las llamadas de enrutamiento directo, compruebe por qué el controlador de borde de sesión no permitió la llamada. - Asegúrese de que el token de Communication Services sea válido y no haya expirado. |
| 540487 | 487 | La llamada finalizó correctamente porque el autor de llamada la canceló. | Success | |
| 560000 | 0 | La llamada la finalizó correctamente el participante RTC remoto. | Success | Causas posibles: - El usuario finalizó la llamada. - Llamada finalizada por el agente multimedia. |
| 560486 | 486 | La llamada finalizó porque el participante RTC remoto estaba ocupado. El número llamado ya estaba en una llamada o tenía problemas técnicos. | Success | - Para las llamadas de enrutamiento directo, compruebe los registros y la configuración del Control de borde de sesión y la configuración de los tiempos de espera. Posibles causas: El número llamado ya estaba en una llamada o tenía problemas técnicos. |
| 404 | Llamada no encontrada. | Asegúrese de que el número al que llama (o la llamada a la que se une) existe. | ||
| 408 | Se agotó el tiempo de espera del controlador de llamadas. | Se agotó el tiempo de espera del controlador de llamadas mientras esperaba los mensajes de protocolo de los puntos de conexión de usuario. Asegúrese de que los clientes están conectados y disponibles. | ||
| 410 | Error de infraestructura de medios o de pila de medios locales. | Asegúrese de que usa el SDK más reciente en un entorno compatible. | ||
| 430 | No se puede enviar el mensaje a la aplicación cliente. | Asegúrese de que la aplicación cliente se está ejecutando y está disponible. | ||
| 480 | Punto de conexión remoto del cliente no registrado. | Asegúrese de que el punto de conexión remoto está disponible. | ||
| 481 | No se pudo controlar la llamada entrante. | Envíe una solicitud de soporte técnico mediante Azure Portal. | ||
| 490, 491, 496, 497, 498 | Problemas de red en el punto de conexión local. | Compruebe la configuración de red y asegúrese de que sigue los requisitos de red de llamadas de comunicación de Azure. | ||
| 500, 503, 504 | Error de infraestructura de Communication Services. | Envíe una solicitud de soporte técnico mediante Azure Portal. |
Descripción de los códigos de llamada y los subcódigos
¿Cuándo se reciben códigos de error?
Los códigos de error de Automatización de llamadas pueden aparecer como respuestas sincrónicas a llamadas API o respuestas asincrónicas a través del URI de devolución de llamada proporcionado. En la situación sincrónica, si se realiza una llamada API y no se acepta, ACS proporcionará un código de error que describe por qué se rechazó la llamada API. En escenarios asincrónicos si se realiza una llamada API y se acepta, pero algo sigue siendo incorrecto, se reciben un evento de devolución de llamada y un código de error. Un ejemplo de un evento de devolución de llamada común para los errores de llamada sería el evento callDisconnected que se muestra cada vez que se desconecta una llamada. Una vez recibido el evento callDisconnected , no habrá más eventos de devolución de llamada para esa llamada dada. Para obtener una lista de eventos de devolución de llamada de señalización de llamadas, consulte (esta página) y para obtener una lista de eventos de devolución de llamada para acciones multimedia, consulte (esta página).
Sintaxis de código de error
Los códigos de error, los subcódigos y las categorías de resultados correspondientes ayudan a los desarrolladores a identificar y diagnosticar errores. Los detalles del código de error incluyen:
Código: son números enteros de 3 dígitos que representan el estado de respuesta de cliente o servidor. Categorías de código:
- Respuestas correctas (200-299)
- Error de cliente (400-499)
- Error de servidor (500-599)
- Error global (600-699)
Subcódigo: se define como un entero, donde cada número indica un motivo único, específico de un grupo de escenarios o un resultado de escenario específico.
Mensaje: describe el resultado y proporciona sugerencias sobre cómo mitigar el problema si un resultado es un error.
Además del código y el subcódigo, puede encontrar información de solución de problemas más detallada en los registros de llamadas. Para más información sobre cómo habilitar y acceder a los registros de llamadas, consulte esta página para obtener instrucciones detalladas.
Códigos de error del SDK de automatización de llamadas
La tabla siguiente contiene los códigos y subcódigos más comunes. Si el error no está en esta tabla, consulte los códigos genéricos y los subcódigos para obtener más información sobre su escenario específico.
Códigos de error de Automatización de llamadas
| Evento de devolución de llamada | Code | Subcode | Description | Mitigation |
|---|---|---|---|---|
| Crear llamada fallida/Respuesta fallida | 404 | 8522 | Código de error genérico que indica que no se encuentra el recurso. Los recursos pueden incluir llamadas y participantes. | Comprobar el estado de la llamada: es posible que la llamada ya haya finalizado o que el participante haya dejado la llamada. |
| Crear llamada fallida/Respuesta fallida | 400 | 8523 | Código de error genérico que indica que algo en el cuerpo de la solicitud no es válido. | Compruebe que todos los parámetros son válidos. Consulte el mensaje de error para determinar qué parámetro produce el error. |
| Respuesta fallida | 400 | 8501 | Acción no admitida: llamada no establecida | La acción asociada al mensaje de error se activó mientras la llamada no estaba activa. Asegúrese de que las nuevas acciones de llamada no se inician después de desconectar la llamada. Este error también podría deberse a acciones invocadas mientras la llamada está activa si están cerca del tiempo de desconexión de la llamada. |
| Respuesta fallida | 400 | 8500 | Modo multimedia no válido | Compruebe el estado de las operaciones multimedia para ver si alguna de ellos ya está activa o si el participante de destino ya está en una operación multimedia. Si hay una operación multimedia activa, espere a que finalice la operación y vuelva a intentarlo. |
| CallDisconnected | 400 | 8559 | Acción no admitida: solo una aplicación de marcado única permitida | Solicitud de grabación de inicio duplicada, grabación ya iniciada o en curso. Compruebe el estado de la grabación para asegurarse de que está inactiva antes de enviar una nueva llamada de grabación de inicio. |
| Respuesta fallida | 400 | 8528 | Acción no admitida: llamada terminada | La acción asociada al mensaje de error se activó mientras finalizaba la llamada. Asegúrese de que las nuevas acciones de llamada no se inician una vez finalizada la llamada. Este error también podría deberse a acciones invocadas mientras la llamada está activa si están cerca de la hora de finalización de la llamada. |
| Creación de llamada fallida/Conexión fallida | 409 | 8519 | Conflict | Asegúrese de que no se realizan varias acciones en el mismo recurso en paralelo. Consulte el mensaje de error para identificar qué dos acciones están en conflicto. |
| Creación de llamada fallida | 403 | 7507 | Identidad de origen de llamada no válida | La identidad de la aplicación del token de autorización no coincide con la identidad de la aplicación en el origen de la llamada. Compruebe que está usando la cadena de conexión del recurso de ACS en el que se configuró el webhook de llamada entrante (el número de teléfono debe ser propiedad del mismo recurso de ACS que responde a la llamada). |
| Creación de llamada fallida | 403 | 7504 | Permisos de aplicación insuficientes | Código genérico para permisos insuficientes, compruebe el mensaje de error para ver el contexto sobre qué recurso carece de permisos. |
| Respuesta fallida | 400 | 8585 | Acción no válida en el estado actual de llamada | La llamada no se establece o está desconectada: espere a que se establezca la llamada antes de volver a intentar la acción multimedia. |
| Creación de llamada fallida | 405 | 8520 | Funcionalidad no admitida en este momento | Error esperado: el flujo de trabajo no se admite actualmente. Consulte nuestro blog de versión para ver si hay un SDK actualizado que ha habilitado estas funcionalidades. Consulte la página Limitaciones conocidas de Automatización de llamadas para obtener una lista de flujos de trabajo no admitidos. |
| Creación de llamada fallida | 412 | 8583 | Error en la condición previa | Haga referencia a esta página en la que se enumeran las acciones multimedia incompatibles para asegurarse de que no ejecuta ni pone en cola acciones incompatibles. |
| Creación de llamada fallida | 400 | 8567 | Entidad de servicio del recurso de ACS no habilitada | El recurso de Azure Cognitive Service no está configurado correctamente. Consulte esta página para obtener una guía sobre cómo configurar el recurso de Azure Cognitive Service. |
| Creación de llamada fallida | 405 | 8522 | Configuración que falta | Compruebe el mensaje de error para obtener más contexto sobre qué configuración debe establecerse. Esta configuración debe producirse al invocar AnswerCall API. |
| CallDisconnected | 200 | 0 | La llamada finalizó correctamente por el participante local. | No se necesita ninguna acción; la llamada finalizó según lo previsto. |
| CallDisconnected | 200 | 4521 | El participante se desconecta repentinamente (por ejemplo, aplicación cerrada, pestaña o explorador sin colgar). | Se recomienda lógica de bloqueo correcta en el cliente. Use los registros de cliente para comprobar si la aplicación estaba cerrada por fuerza. |
| CallDisconnected | 200 | 5000 | Participante quitado por otro participante. | Compruebe la lógica de control de llamadas para las operaciones de eliminación. Confirme si la eliminación fue intencionada. |
| CallDisconnected | 200 | 5010 | La llamada finalizó porque solo permaneció un participante. | Este es el comportamiento esperado. Vuelva a unirse con varios participantes si la llamada estaba pensada para continuar. |
| CallDisconnected | 200 | 5013 | La llamada finalizó porque nadie más se unió a la llamada grupal. | Compruebe el tiempo de las combinaciones de participantes. |
| CallDisconnected | 200 | 7000 | Llamada finalizada por Azure Communication Services, Call Automation o un bot del lado servidor. | Confirme si la lógica del bot desencadenó el final de la llamada. Revise la implementación del bot y el flujo de llamadas. |
| CallDisconnected | 200 | 7015 | La llamada finalizó por servicio después de la transferencia correcta. | No se necesita ninguna acción; la llamada se finalizó como parte del comportamiento de transferencia esperado. |
| CallDisconnected | 487 | 0 | La llamada finalizó correctamente porque el autor de llamada la canceló. | No se requiere ninguna acción. Asegúrese de que la cancelación es intencionada. |
| CallDisconnected | 487 | 10003 | Otro punto de conexión aceptó la llamada (por ejemplo, otro bot respondió a la llamada). Asegúrese de que los bots solo responden a las llamadas dirigidas a ellos. | La lógica de la aplicación debe comprobar la prioridad del punto de conexión o volver a enrutar la lógica. |
| CallDisconnected | 487 | 10024 | Todos los puntos de conexión de llamada rechazaron la llamada. | No se requiere ninguna acción. |
| CallDisconnected | 500 | 10045 | Error de infraestructura de Azure Communication Services. | Capture registros y póngase en contacto con el soporte técnico si el problema persiste. |
| CallDisconnected | 503 | 560503 | Evento de servidor inesperado. | Error interno del servidor, recopilación de registros y incidencia de soporte técnico abierta |
| Creación de llamada fallida | 401 | 10009 | Identidad no autenticada. | Asegúrese de que el token de Azure Communication Services es válido, con ámbito y no ha expirado. |
| Creación de llamada fallida | 403 | 510403 | Llamada marcada como correo no deseado y bloqueada. | Revise el patrón de llamada saliente. Asegúrese de que cumple con las directivas contra correo no deseado. |
| Creación de llamada fallida | 403 | 560403 | La llamada estaba prohibida, cancelada o rechazada. | Valide los permisos y el estado del usuario de destino. |
| Creación de llamada fallida | 404 | 4500 | El identificador de llamada no existe o ya ha finalizado la llamada. | Compruebe el identificador de llamada y el ciclo de vida de las llamadas. Asegúrese de que no hace referencia a una llamada expirada. |
| Creación de llamada fallida | 480 | 10078 | Participante remoto no registrado o accesible. | Confirme que la aplicación cliente del destinatario se está ejecutando y registrando. Vuelva a intentarlo más adelante si es necesario. |
| Creación de llamada fallida | 480 | 560480 | No hay respuesta del destinatario. | Confirme la disponibilidad del usuario. |
| Creación de llamada fallida | 487 | 540487 | Llamada cancelada por el originador. | No se requiere ninguna acción. Compruebe que la aplicación de origen canceló la llamada según lo previsto. |
| ConnectFailed | 408 | 10057 | Tiempo de espera durante la unión a la reunión o aceptación de llamadas. | Valide la presencia del participante y la preparación del cliente. |
| ConnectFailed | 429 | 10110 | Se superó la duración máxima de la llamada. | Revise las directivas de duración de llamadas. Considere la posibilidad de programar la reconexión si es necesario. |
| ConnectFailed | 480 | 10076 | Usuario de destino registrado pero sin conexión. | El destino debe estar en línea. Confirme el estado de la aplicación o la reserva al correo de voz o al mensaje asincrónico. |
| ConnectFailed | 484 | 560484 | Dirección de destinatario no válida o incompleta. | Valide el identificador de destinatario (por ejemplo, el número de teléfono, el identificador de ACS). Corrija y vuelva a intentarlo. |
| Respuesta fallida | 401 | 71005 | Error de validación de tokens al responder a la llamada. | Asegúrese de que la solicitud AnswerCall tiene un token válido y no expirado. |
| Respuesta fallida | 404 | 404 | No se puede responder. | Recopilación de registros y apertura de incidencias de soporte técnico |
| Respuesta fallida | 408 | 4506 | Tiempo de espera: el destinatario no respondió a tiempo. | Validar la disponibilidad de la aplicación y las notificaciones push. |
| Respuesta fallida | 495 | 4507 | Token de Azure Communication Services no válido. | Compruebe la generación y el ámbito de los tokens. Vuelva a generar el token si es necesario. |
| Respuesta fallida | 430 | 10315 | No se pudo entregar el mensaje de señalización al cliente. | Asegúrese de que la aplicación cliente es accesible y puede recibir mensajes de señalización. |
| Respuesta fallida | 430 | 10317 | El cliente no reconoció la solicitud de señalización. | Compruebe la capacidad de respuesta de la aplicación cliente. Reinicie la aplicación o el dispositivo si es necesario. |
| Respuesta fallida | 480 | 10077 | Destino registrado pero no en línea en el momento de la llamada. | Asegúrese de que el destinatario tiene una sesión activa y no está en estado de suspensión o en segundo plano. |
| Respuesta fallida | 487 | 10004 | Tiempo de espera: el usuario no aceptó ni rechazó a tiempo. | Considere la posibilidad de agregar la ruta de acceso de reserva o la duración de llamada extendida. |
| Respuesta fallida | 487 | 4501 | Se rechazó o no se pudo generar la oferta de medios (por ejemplo, la falta de coincidencia del punto de conexión). | Compruebe las funcionalidades multimedia y garantice la compatibilidad entre los participantes. |
| Respuesta fallida | 490 | 4502 | Problema de red: el explorador no pudo completar la solicitud. | Valide la conectividad de cliente y los dominios de ACS en la lista de permitidos en la configuración de red. |
| Respuesta fallida | 496 | 7 | Conexión de red perdida; se produjo un error en los reintentos. | Registre y supervise las desconexiones periódicas para su posterior análisis. |
Códigos de error genéricos
Códigos 2xx
Un código 2xx representa una respuesta correcta. El subcódigo para las respuestas correctas será 0.
Códigos 4xx
Un código 4xx representa un error de cliente.
| Código de estado | Description |
|---|---|
| 400 | Solicitud incorrecta |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | No encontrado |
| 405 | Método no permitido |
| 406 | No es aceptable |
| 408 | Tiempo de espera agotado |
| 409 | Conflict |
| 412 | Error de condición previa |
| 413 | Entidad de solicitud demasiado larga |
| 426 | Actualización necesaria |
| 429 | Demasiadas solicitudes |
| 481 | La transacción no existe |
| 487 | Canceled |
Códigos 5xx
Un código 5xx representa un error de servidor.
| Código de estado | Description |
|---|---|
| 500 | Error interno del servidor |
| 501 | No implementado |
| 502 | Puerta de enlace incorrecta |
| 503 | Servicio no disponible |
| 504 | Tiempo de espera de puerta de enlace |
Códigos 6xx
Un código 6xx representa un error global.
| Código de estado | Description |
|---|---|
| 603 | Declined |
Subcódigos genéricos
| Subcode | Description |
|---|---|
| 0 | Success |
| 7000 | Graceful |
| 7500 | Identidad de AAD no admitida |
| 7501 | Token no válido |
| 7502 | Acceso no habilitado |
| 7504 | Permisos de aplicación insuficientes |
| 7505 | Error de coincidencia del inquilino de empresa |
| 7506 | Certificado que no es de confianza |
| 7507 | Identidad de origen de llamada no válida |
| 7508 | Identidad de ACS no admitida |
| 7509 | Error de validación de HMAC |
| 7510 | Error de validación de identidad administrada |
| 7600 | Acceso a recursos no habilitado |
| 7601 | Identidad de origen de ACS no válida |
| 7602 | Identidad de destino de ACS no válida |
| 7603 | Identidad de ACS no válida |
| 7604 | Escenario de interoperabilidad de Teams no autorizado |
| 7605 | Escenario de interoperabilidad de grabación de Teams no autorizado |
| 7606 | Recurso de ACS no autorizado para Cognitive Actions |
| 8500 | Modo multimedia no válido |
| 8501 | Llamada no establecida |
| 8502 | Mi id. de participante no está disponible |
| 8503 | Estado de llamada multimedia: audio inactivo |
| 8504 | Secuencias multimedia no disponibles |
| 8505 | Varios participantes con reemplazo |
| 8506 | Sin cumplimiento normativo para grabación de llamada |
| 8508 | Operación cancelada |
| 8509 | Se alcanzó el tiempo de espera máximo de silencio |
| 8510 | Se alcanzó el tiempo de espera del silencio inicial |
| 8511 | Error en el símbolo del sistema de reproducción |
| 8512 | Error de reproducción de sonido |
| 8513 | Tiempo de espera de recepción multimedia |
| 8514 | Tono de detención detectado |
| 8515 | Se alcanzó la duración máxima del registro |
| 8516 | Llamada limitada |
| 8517 | Error de coincidencia de identificador de inquilino de llamada |
| 8518 | Excepción de llamada |
| 8519 | Conflict |
| 8520 | No implementado |
| 8521 | Demasiados saltos |
| 8522 | No encontrado |
| 8523 | Argumento no válido |
| 8524 | Recuento de participantes no válido para el cumplimiento normativo de grabación |
| 8525 | Parte no registrada |
| 8526 | Token de unión no válido |
| 8527 | Dirección URL de unión no válida |
| 8528 | Llamada finalizada |
| 8529 | Llamada limitada: se alcanzó el límite mensual |
| 8530 | Llamada limitada: se alcanzó el límite de llamadas activas |
| 8531 | Número máximo de dígitos recibidos |
| 8532 | Se alcanzó el tiempo de espera entre dígitos |
| 8533 | Opción Dtmf coincidente |
| 8534 | Tono incorrecto introducido |
| 8535 | Formato de archivo no válido |
| 8536 | Error de descarga de archivos |
| 8537 | Se alcanzó el tiempo de espera de mantener conexión |
| 8538 | Destinatario de la llamada ha rechazado |
| 8539 | Destinatario de la llamada ocupado |
| 8540 | Destinatario de la llamada ocupado en todas partes |
| 8541 | Destinatario de la llamada no disponible |
| 8542 | Llamada cancelada |
| 8543 | La llamada no existe |
| 8544 | Destinatario de la llamada inaccesible |
| 8545 | Opción de voz coincidente |
| 8546 | Solicitud no válida enviada por el destinatario de la llamada |
| 8547 | Opción de voz no coincidente |
| 8548 | La llamada no es una llamada de grupo |
| 8549 | Error al volver a establecer la creación de conversaciones |
| 8550 | Error de negociación al redestinar medios |
| 8551 | No se admite el redestinar |
| 8552 | No se puede quitar el organizador |
| 8553 | Grabación duplicada |
| 8554 | Participante fuera de la mezcla de audio de la reunión |
| 8555 | Redestino ya en curso |
| 8556 | Acción no admitida para la llamada CR |
| 8557 | Tipo de formato incorrecto |
| 8558 | Participante no presente |
| 8559 | Acceso telefónico único duplicado |
| 8560 | Acción de unirse a la conversación bloqueada debido a una reunión bloqueada |
| 8561 | Identificador de unirse a reunión no válido |
| 8562 | Modo de grabación no compatible |
| 8563 | Voz no reconocida |
| 8564 | Error de conexión del servicio de voz |
| 8565 | Error de Cognitive Services |
| 8566 | Operación de reactivar audio no permitida |
| 8567 | Entidad de servicio del recurso de ACS no habilitada |
| 8568 | Error de solicitud de identidad administrada para Cognitive Service |
| 8571 | Conflicto de operación de grabación |
| 8569 | Voz reconocida |
| 8570 | Error de reconocimiento de voz de Cognitive Services |
| 8572 | Apagado del servicio de reproducción |
| 8573 | Método no permitido de pausar y reanudar |
| 8578 | Error de transcripción |
| 8579 | Transcripción cancelada |
| 8580 | Apagado del servicio de transcripción |
| 8581 | Dirección URL de flujo no válida |
| 8582 | Reproducir texto de origen o SSML vacío |
| 8583 | Error en la condición previa |
| 8585 | Acción no válida en el estado actual de llamada |
| 8586 | Llamada entrante no confirmada por bot |
| 8587 | Llamada entrante no respondida dentro del tiempo |
| 8588 | Tiempo de expiración de grabación completada y medios recibidos |
| 8589 | Grabación limitada |
| 8594 | Error al actualizar el estado de la reunión |
| 8603 | Error de streaming multimedia |
| 8604 | Streaming multimedia cancelado |
| 8605 | No se admite el modelo de voz personalizado de transcripción |
| 8606 | Error de creación del identificador de comunicación |
| 8607 | Conflicto de operación de transferencia |
| 8608 | Error de grabación del cliente participante |
| 8609 | Respuesta de combinación no válida del bot |
| 8610 | No hay respuesta del bot al notificar |
| 8613 | Se ha alcanzado el límite de subtítulos en directo de llamadas |
| 9001 | Error desconocido del servicio subyacente |
| 9002 | Error de tiempo de espera del servicio subyacente |
| 9003 | Error de operación cancelada |
| 9998 | Error irrecuperable |
| 9999 | Unknown |
Códigos de diagnóstico SIP y Q.850 en eventos de devolución de llamada
Los eventos de devolución de llamada de Automatización de llamadas ahora admiten datos de diagnóstico de bajo nivel a través de SipDetails y Q850Details campos, agregados al objeto existente ResultInformation.
Estos diagnósticos exponen información de nivel de protocolo de la capa de señalización de telecomunicaciones, lo que ayuda a solucionar problemas como caídas de llamadas, destinos inaccesibles o rechazos inesperados en escenarios RTC y SIP/VoIP.
Disponibilidad
Note
La presencia de SipDetails y Q850Detailsdepende completamente de si el SBC o operador de telecomunicaciones implicado proporciona esta información.
Si el operador de control de borde de sesión (SBC)/carrier devuelve diagnósticos pertinentes después de una solicitud de señalización de automatización de llamadas correspondiente, el evento resultante incluirá SipDiagnosticInfodentro de ResultInformation.
Eventos afectados
Los siguientes eventos pueden incluirse SipDiagnosticInfo en su ResultInformation:
RemoveParticipantsFailedAddParticipantsFailedCreateCallFailedAnswerFailedCallDisconnectedTransferFailedCanAddParticipantFailed
En la práctica, cualquier evento de devolución de llamada que contenga ResultInformation puede llevar estos diagnósticos cuando lo proporcione el SBC/operador.
Estructura
Cada diagnóstico se representa como un objeto:
| Propiedad | Tipo | Description |
|---|---|---|
Code |
Integer | Código SIP o Q.850 (por ejemplo, 486, 16) |
Message |
String | Motivo legible (por ejemplo, "Ocupado aquí") |
Estos campos son opcionales y solo aparecen cuando se suministran mediante el SBC/carrier.
Example
{
"ResultInformation": {
"Code": 500,
"SubCode": 560503,
"Message": "Unexpected server error",
"SipDetails": {
"Code": 486,
"Message": "Busy Here"
},
"Q850Details": {
"Code": 17,
"Message": "User busy"
}
}
}
Códigos de respuesta de llamadas RTC con ParticipantEndReason
En esta sección se proporciona información de solución de problemas para varias combinaciones de códigos de respuesta ParticipantEndReason y ParticipantEndSubCode. Para las tablas de esta sección, ParticipantEndReason = Código y ParticipantEndSubCode = Subcódigo.
Como pauta general, si el ParticipantEndSubCode valor comienza con 560 o 540, indica que el SBC del usuario/operador generó el código de respuesta. Esto es útil para solucionar problemas de llamadas de enrutamiento directo, ya que el subcódigo puede ayudar a determinar si el error proviene de su SBC o del servicio de Microsoft. Un subcódigo que comienza con 560 representa una llamada saliente, mientras que un subcódigo que comienza con 540 representa una llamada entrante. En cualquier caso, compruebe los registros de SBC.
Por ejemplo, si el ParticipantEndSubCode valor es 560403, significa que fue una llamada saliente, el SBC generó el código de respuesta final y el código de respuesta SIP del SBC fue 403. Comience a solucionar los problemas de las llamadas revisando los registros de su SBC.
En el caso ParticipantEndSubCode de las respuestas que no empiezan por 560 o 540, el servicio de Microsoft genera el código de respuesta final.
ParticipantEndReason 0
La respuesta ParticipantEndReason con el valor 0 normalmente significa que las llamadas normales se borran y marcan las llamadas que se completaron sin errores.
| SubCode | Code | Message | Categorías de resultados | Advice |
|---|---|---|---|---|
| 0 | 0 | La llamada la finalizó correctamente el participante local. | Success | |
| 560000 | 0 | Finalización normal de la llamada RTC: - El usuario finalizó la llamada. - Llamada finalizada por el agente multimedia. |
Success | |
| 540000 | 0 | Finalización normal de la llamada RTC: - El usuario finalizó la llamada. - Llamada finalizada por el agente multimedia. |
Success |
ParticipantEndReason 4xx
La respuesta ParticipantEndReason con el valor 4xx significa que la llamada no se ha conectado.
| SubCode | Code | Message | Categorías de resultados | Advice |
|---|---|---|---|---|
| 510403 | 403 | Llamada bloqueada: - No se encontró ninguna ruta de voz coincidente para el número marcado. - Id. alternativo no proporcionado para la llamada. - Número de teléfono no permitido por el controlador de borde de sesión (SBC) del usuario. - Anteriormente marcado como correo no deseado y ahora bloqueado. |
Para obtener más información sobre el identificador alternativo, vea Administrar llamadas. - Confirme que tiene una ruta de voz válida para el número marcado. - Asegúrese de que especificó un identificador alternativo válido. Debe ser un número de teléfono que pertenezca al recurso que está usando. - Compruebe que posee el recurso que usa para realizar una llamada. - Para las llamadas de enrutamiento directo, compruebe por qué el controlador de borde de sesión no permitió la llamada. - Asegúrese de que el token de Communication Services sea válido y no haya expirado. |
|
| 560403 | 403 | - Llamada prohibida. - Llamada cancelada. - Llamada rechazada. |
Asegúrese de llamar a un número de teléfono válido en el formato correcto. Para obtener más información sobre los formatos de número admitidos, consulte https://en.wikipedia.org/wiki/E.164. | |
| 511532 | 403 | No se encontró la configuración del troncal de SIP de recursos. | Compruebe la configuración de enrutamiento directo en Azure Portal. Para obtener más información, consulte Aprovisionamiento de enrutamiento directo. | |
| 560404 | 404 | - Número de teléfono no encontrado. - Número de teléfono no asignado a ningún destino. - Número de teléfono no permitido por el controlador de borde de sesión. |
- Asegúrese de que el número de teléfono pertenece al recurso que usa y que posee el recurso. - Compruebe que el número al que está llamando existe y que está asignado a un destino válido. |
|
| 511404 | 404 | - Número de teléfono no encontrado. - Recurso usado en la llamada no encontrada. |
- Asegúrese de que ha usado un número de teléfono que pertenece al recurso que usa y que posee el recurso. - Compruebe que el número al que está llamando existe y que está asignado a un destino válido. - Asegúrese de que el recurso que usa para la llamada no se elimina ni deshabilita. - Asegúrese de que las suscripciones de Azure no se eliminan ni deshabilitan. |
|
| 560408 | 408 | La parte llamada no respondió a un mensaje de establecimiento de llamadas dentro del período de tiempo prescrito. | - Compruebe por qué la parte llamada no respondió. - Para las llamadas de enrutamiento directo, compruebe los registros y la configuración del Controlador de límites de sesión (CLS) y de los tiempos de expiración. |
|
| 500001 | 408 | Tiempo de expiración para la puerta de enlace del usuario Azure Communication Services no recibió una respuesta del cliente dentro de un límite de tiempo especificado y finalizó la solicitud. |
- Compruebe por qué la parte llamada no respondió. - Para las llamadas de enrutamiento directo, compruebe los registros y la configuración del CLS y la configuración de los tiempos de espera. |
|
| 531004 | 410 | Error en las comprobaciones del establecimiento de conectividad interactiva (ICE). | - No se pudo establecer la ruta de acceso multimedia. Puede deberse a una configuración de red incorrecta. Compruebe la configuración de red para asegurarse de que las direcciones IP y los puertos necesarios no están bloqueados. Lea las instrucciones de https://www.rfc-editor.org/rfc/rfc5245#section-7. - Para las llamadas de enrutamiento directo, compruebe los registros y la configuración del CLS y la configuración de ICE y del perfil. Póngase en contacto con el proveedor de SBC para obtener ayuda de configuración. Para saber más, consulte la Lista de controladores de límites de sesión certificados para enrutamiento directo de Azure Communication Services. |
|
| 560480 | 480 | - No hay respuesta del usuario llamado. - Llamado usuario temporal no disponible. |
- Compruebe por qué la parte llamada no respondió. - Vuelva a intentar la llamada más tarde en caso de que la entidad llamada no estuviera disponible temporalmente. - Para las llamadas de enrutamiento directo, compruebe los registros y la configuración del CLS y la configuración de los tiempos de espera. |
|
| 560484 | 484 | - Dirección de destinatario incompleta o no válida. - Formato de número de destinatario incompleto o no válido. |
- En algunos casos, puede omitir estos errores porque el usuario marca un número no válido. - Asegúrese de que los números de teléfono tienen el formato correcto. Para más información, consulte https://en.wikipedia.org/wiki/E.164. - Para el enrutamiento directo, el SBC podría provocar estos errores debido a una configuración que falta en un escenario de transferencia de llamadas. |
|
| 540486 | 486 | El número llamado estaba ocupado | - El número llamado puede estar conectado a una llamada existente o tener un problema técnico. - Para las llamadas de enrutamiento directo, compruebe los registros y la configuración del CLS y la configuración de los tiempos de espera. |
|
| 560486 | 486 | El número llamado estaba ocupado | - El número llamado puede estar conectado a una llamada existente o tener un problema técnico. - Para las llamadas de enrutamiento directo, compruebe los registros y la configuración del CLS y la configuración de los tiempos de espera. |
|
| 540487 | 487 | El autor de la llamada finalizó la solicitud de llamada. | Vuelva a intentar la llamada. | |
| 560487 | 497 | - El autor de la llamada finalizó la solicitud de llamada. - Solicitud finalizada con la desactivación normal de llamadas. |
Vuelva a intentar la llamada. |
ParticipantEndReason 5xx
La respuesta ParticipantEndReason con el valor 5xx significa que se produjo un error en la llamada debido a un problema con un componente de software o hardware necesario para completar la conexión.
| SubCode | Code | Message | Categorías de resultados | Advice |
|---|---|---|---|---|
| 560500 | 500 | Error interno del servidor en uno de los servicios implicados en la llamada. | - Vuelva a intentar la llamada. Si el problema persiste, póngase en contacto con el proveedor de telecomunicaciones o el soporte técnico de Microsoft. - Para las llamadas de enrutamiento directo, compruebe los registros y la configuración del CLS y la configuración de tiempos de espera para ver si el CLS provocó el error. |
|
| 560503 | 503 | - Error de llamada debido a un error interno del servidor en uno de los servicios implicados en la llamada. - La red utilizada para establecer la llamada está fuera de orden. - Error temporal en uno de los servicios implicados en la llamada. |
- Compruebe la configuración de red y enrutamiento para detectar posibles problemas. Compruebe que las reglas de firewall de red son correctas. - Vuelva a intentar la llamada. Si el problema persiste, póngase en contacto con el proveedor de telecomunicaciones o el soporte técnico de Microsoft. - Para las llamadas de enrutamiento directo, compruebe los registros y la configuración del CLS y la configuración de tiempos de espera para ver si el CLS provocó el error. |
ParticipantEndReason 603
La respuesta ParticipantEndReason con el valor 603 significa que la llamada se rechazó sin conectarse.
| SubCode | Code | Message | Categorías de resultados | Advice |
|---|---|---|---|---|
| 560603 | 603 | - Llamada rechazada por el destinatario. - Se rechazó la llamada debido a la detección de fraudes. |
- Si el destinatario lo rechaza, vuelva a intentar la llamada. - Asegúrese de que no supera el número máximo de llamadas simultáneas permitidas para el número de teléfono de Azure Communication Services. Para obtener más información, consulte Limitaciones de llamadas RTC. |
Códigos de error del SDK de chat
El SDK de chat usa los siguientes códigos de error para ayudarle a solucionar problemas de chat. Los códigos de error se exponen a través de la propiedad error.code en la respuesta del error.
| Code | Message | Advice |
|---|---|---|
| 401 | Unauthorized | Asegúrese de que el token de Communication Services es válido y no ha expirado. |
| 403 | Forbidden | Asegúrese de que el iniciador de la solicitud tiene acceso al recurso. |
| 429 | Demasiadas solicitudes | Asegúrese de que la aplicación del lado cliente controla este escenario de forma sencilla. Si el problema continúa, cree una solicitud de soporte técnico. |
| 503 | Servicio no disponible | Envíe una solicitud de soporte técnico mediante Azure Portal. |
Códigos de error de SMS
El SDK de SMS usa los siguientes códigos de error para ayudarle a solucionar problemas de SMS. Los códigos de error se exponen a través del DeliveryStatusDetails campo del informe de entrega de SMS.
| Code | Message | Advice |
|---|---|---|
| 2000 | Mensaje entregado correctamente. | |
| 4000 | El mensaje se rechaza debido a la detección de fraudes. | Asegúrese de que no supera el número máximo de mensajes permitido para el número. |
| 4001 | El mensaje se rechaza debido a un formato de número de origen no válido | Asegúrese de que el número de destino está en formato E.164 y que el formato del número de origen es también E.164 o un formato de código corto. |
| 4002 | El mensaje se rechaza debido a un formato de número de destino no válido. | Asegúrese de que el número de destino está en formato E.164 |
| 4003 | No se pudo entregar el mensaje debido a un destino no admitido. | Comprobar si se admite el destino al que intenta realizar el envío. |
| 4004 | No se pudo entregar el mensaje porque el número de destino no existe. | Asegurarse de que el número de destino al que envía el mensaje es válido. |
| 4005 | El operador de destino bloquea el mensaje. | |
| 4006 | No se puede acceder al número de destino. | Intentar volver a enviar el mensaje más adelante. |
| 4007 | El número de destino ha optado por no recibir mensajes de usted. | Marque el número de destino como no seleccionado para que no se intenten más mensajes hacia ese número. |
| 4008 | Supera el número máximo de mensajes permitidos para el perfil. | Asegúrese de que no supera el número máximo de mensajes permitidos para el número o use colas para procesar por lotes los mensajes. |
| 4009 | El sistema de derechos de Microsoft rechaza el mensaje. | La mayoría de las veces ocurre si se detecta actividad fraudulenta. Para más información, póngase en contacto con el soporte técnico. |
| 4010 | El mensaje se bloqueó porque no se ha comprobado el número gratuito. | Revise los límites de envío sin comprobar y envíe la comprobación del número gratuito lo antes posible. |
| 4020 | Mensaje rechazado por el operador debido a una infracción volumétrica. | Asegúrese de que no supera el número máximo de mensajes permitidos para el número o use colas para procesar por lotes los mensajes. |
| 5000 | No se pudo entregar el mensaje. Póngase en contacto con el equipo de soporte técnico de Microsoft para obtener más detalles. | Envíe una solicitud de soporte técnico mediante Azure Portal. |
| 5001 | No se pudo entregar el mensaje debido a la falta de disponibilidad temporal de la aplicación o del sistema. | |
| 5002 | El operador no admite el informe de entrega | Esto sucede con más frecuencia si un operador no admite informes de entrega. No se requiere ninguna acción, ya que es posible que el mensaje ya se haya entregado. |
| 9999 | No se pudo entregar el mensaje debido a un error desconocido. | Intentar volver a enviar el mensaje. |