Límites de servicio para Azure Communication Services
En este documento se explican las limitaciones de las API de Azure Communication Services y las posibles soluciones.
Arquitectura y patrones de limitación
Al alcanzar las limitaciones del servicio, recibirá un código de estado HTTP 429 (demasiadas solicitudes). En general, los procedimientos recomendados para controlar la limitación son los siguientes:
- Reduzca el número de operaciones por solicitud.
- Reduzca la frecuencia de las llamadas.
- Evite reintentos inmediatos, ya que todas las solicitudes se acumulan en los límites de uso.
Puede encontrar instrucciones más generales sobre cómo configurar la arquitectura de servicio para controlar las limitaciones en la documentación Arquitectura de Azure para los patrones de limitación. Los límites de ancho de banda se pueden aumentar a través de una solicitud al Soporte técnico de Azure.
- Abra Azure Portal e inicie sesión.
- Seleccione Ayuda y soporte técnico.
- Haga clic Creación de una solicitud de soporte técnico.
- En el cuadro de texto Describir el problema, escriba
Technicaly luego haga clic en Ir. - En el menú desplegable Seleccionar un servicio, seleccione Límites de servicio y suscripción (cuotas) y luego haga clic en Siguiente.
- En la descripción del problema, elija el tipo de problema, suscripción y Tipo de cuota haga clic en Siguiente.
- Revise cualquier solución recomendada si está disponible y haga clic en Siguiente.
- Agregue detalles adicionales según sea necesario y luego haga clic en Siguiente.
- En Revisar y crear compruebe la información, realice cambios según sea necesario y, a continuación, haga clic en Crear.
Puede seguir la documentación para crear una solicitud para soporte técnico de Azure.
Adquisición de números de teléfono
Antes de adquirir un número de teléfono, asegúrese de que la suscripción cumple los requisitos geográficos y de suscripción. De lo contrario, no puede comprar un número de teléfono. Las siguientes limitaciones se aplican a la adquisición de números mediante el SDK de números de teléfono y Azure Portal.
| Operación | Ámbito | Plazo de tiempo | Límite (número de solicitudes) |
|---|---|---|---|
| Compra de un número de teléfono | Inquilino de Azure | - | 1 |
| Búsqueda de números de teléfono | Inquilino de Azure | una semana | 5 |
Acción que realizar
Para más información, consulte la página de concepto de tipos de números de teléfono y la página de información general del concepto de telefonía.
Los límites de compra de números pueden aumentarse mediante una solicitud al servicio de atención al cliente de Azure.
- Abra Azure Portal e inicie sesión.
- Seleccione Ayuda y soporte técnico.
- Haga clic Creación de una solicitud de soporte técnico.
- En el cuadro de texto Describir el problema, escriba
Technicaly luego haga clic en Ir. - En el menú desplegable Seleccionar un servicio, seleccione Límites de servicio y suscripción (cuotas) y luego haga clic en Siguiente.
- En la descripción del problema, elija el tipo de problema, suscripción y Tipo de cuota haga clic en Siguiente.
- Revise cualquier solución recomendada si está disponible y haga clic en Siguiente.
- Agregue detalles adicionales según sea necesario y luego haga clic en Siguiente.
- En Revisar y crear compruebe la información, realice cambios según sea necesario y, a continuación, haga clic en Crear.
Identidad
| Operación | Períodos de tiempo (segundos) | Límite (número de solicitudes) |
|---|---|---|
| Creación de la identidad | 30 | 1000 |
| Eliminar identidad | 30 | 500 |
| Emitir tokens de acceso | 30 | 1000 |
| Revocar token de acceso | 30 | 500 |
| createUserAndToken | 30 | 1000 |
| exchangeTokens | 30 | 500 |
Acción que realizar
Se recomienda adquirir identidades y tokens antes de crear subprocesos de chat o iniciar llamadas. Por ejemplo, cuando se carga la página web o se inicia la aplicación.
Para más información, consulte la página de información general del concepto de identidad.
SMS
Al enviar o recibir un gran volumen de mensajes, es posible que reciba un error 429. Este error indica que está alcanzando las limitaciones del servicio y los mensajes se pondrán en cola para enviarse una vez que el número de solicitudes esté por debajo del umbral.
Límites de frecuencia para SMS:
| Operación | Tipo de número de teléfono | Ámbito | Períodos de tiempo | Límite (número de solicitudes) | Unidades de mensaje por minuto |
|---|---|---|---|---|---|
| Enviar mensaje | Gratuito | Por número | 60 | 200 | 200 |
| Enviar mensaje | Código corto | Por número | 60 | 6000 | 6000 |
| Enviar mensaje | Id. de remitente alfanumérico | Por recurso | 60 | 600 | 600 |
Acción que realizar
Si tiene requisitos que superan los límites de velocidad, envíe una solicitud al soporte técnico de Azure para habilitar un mayor rendimiento.
Para más información sobre el SDK y el servicio SMS, consulte la página de información general del SDK de SMS o la página de preguntas frecuentes sobre SMS.
Correo electrónico
Puede enviar un número limitado de mensajes de correo electrónico. Si supera los siguientes límites para la suscripción, se rechazan las solicitudes. Puede volver a intentar estas solicitudes, una vez transcurra el tiempo de reintento. Realice una acción antes de alcanzar el límite solicitando aumentar los límites de volumen de envío si es necesario.
El servicio de correo electrónico de Azure Communication Services está diseñado para admitir un alto rendimiento. Sin embargo, el servicio impone límites de velocidad iniciales para ayudar a los clientes a incorporarse sin problemas y evitar algunos de los problemas que pueden producirse al cambiar a un nuevo servicio de correo electrónico. Se recomienda aumentar gradualmente el volumen de correo electrónico mediante correo electrónico de Azure Communication Services durante un período de dos a cuatro semanas, a la vez que se supervisa estrechamente el estado de entrega de los correos electrónicos. Este aumento gradual permite a los proveedores de servicios de correo electrónico de terceros adaptarse al cambio en la dirección IP del tráfico de correo electrónico de su dominio. El cambio gradual le da tiempo para proteger la reputación del remitente y mantener la confiabilidad de la entrega de correo electrónico.
Aprobamos límites más altos para los clientes en función de los requisitos de casos de uso, la reputación del dominio, los patrones de tráfico y las tasas de error. Para solicitar límites más altos, siga las instrucciones de Aumento de cuota para dominios de correo electrónico. Las cuotas más altas solo están disponibles para dominios personalizados comprobados, no para dominios administrados por Azure.
Límites de velocidad
| Operación | Ámbito | Período de tiempo (minutos) | Límite (número de correos electrónicos) |
|---|---|---|---|
| Enviar correo | Por suscripción | 1 | 30 |
| Enviar correo | Por suscripción | 60 | 100 |
| Obtén el estado del correo electrónico | Por suscripción | 1 | 60 |
| Obtén el estado del correo electrónico | Por suscripción | 60 | 200 |
Dominios administrados de Azure
| Operación | Ámbito | Período de tiempo (minutos) | Límite (número de correos electrónicos) |
|---|---|---|---|
| Enviar correo | Por suscripción | 1 | 5 |
| Enviar correo | Por suscripción | 60 | 10 |
| Obtén el estado del correo electrónico | Por suscripción | 1 | 10 |
| Obtén el estado del correo electrónico | Por suscripción | 60 | 20 |
Límites de tamaño
| Nombre | Límite |
|---|---|
| Número de destinatarios en correo electrónico | 50 |
| Tamaño total de la solicitud de correo electrónico (datos adjuntos incluidos) | 10 MB |
| Número máximo de conexiones autenticadas por suscripción | 250 |
Para todos los límites de tamaño de mensaje, debe tener en cuenta que la codificación base64 aumenta el tamaño del mensaje. Debe aumentar el valor de tamaño para tener en cuenta el aumento del tamaño del mensaje que se produce después de que los datos adjuntos del mensaje y cualquier otro dato binario estén codificados en Base64. La codificación base64 aumenta el tamaño del mensaje en aproximadamente el 33 %, por lo que el tamaño del mensaje es aproximadamente un 33 % mayor que los tamaños de mensaje antes de la codificación. Por ejemplo, si especifica un valor de tamaño máximo de mensaje de ~10 MB, puede esperar un valor de tamaño de mensaje máximo realista de aproximadamente ~7,5 MB.
Envío de datos adjuntos de más de 10 MB
Para enviar archivos adjuntos por correo electrónico hasta 30 MB, complete una solicitud de soporte técnico.
Si necesita enviar datos adjuntos de archivos de correo electrónico de más de 30 MB, puede usar esta solución alternativa. Almacene los archivos en una cuenta de Azure Blob Storage e incluya un vínculo a los archivos del correo electrónico. Puede proteger los archivos con una firma de acceso compartido (SAS). La SAS proporciona acceso delegado a los recursos de la cuenta de almacenamiento. Con la SAS, tiene control granular sobre la forma en que un cliente puede tener acceso a los datos.
Ventajas de usar una cuenta de Azure Blob Storage:
- Puede controlar archivos a gran escala.
- Puede usar claves de SAS para administrar con precisión el acceso a archivos.
Para más información, vea:
- Introducción a Azure Blob Storage
- Grant limited access to Azure Storage resources using shared access signatures (SAS) (Otorgar acceso limitado a recursos de Azure Storage con firmas de acceso compartido [SAS])
Acción que realizar
Para aumentar la cuota de correo electrónico, siga las instrucciones de Aumento de cuota para dominios de correo electrónico.
Nota:
Las solicitudes de aumento de cuota de correo electrónico pueden tardar hasta 72 horas en ser evaluadas y aprobadas, especialmente en el caso de las solicitudes que llegan el viernes por la tarde.
Chat
Límites de tamaño
| Nombre | Límite |
|---|---|
| Número de participantes en el subproceso | 250 |
| Lote de participantes: CreateThread | 200 |
| Lote de participantes: AddParticipant | 200 |
| Tamaño de página: ListMessages | 200 |
| Tamaño de los mensajes | 28 KB |
| Número de recursos de Azure Communication Services por Azure Bot | 1000 |
Límites de velocidad
| Operación | Ámbito | Límite por cada 10 segundos | Límite por cada minuto |
|---|---|---|---|
| Creación de subprocesos de chat | por usuario | 10 | - |
| Eliminación de subprocesos de chat | por usuario | 10 | - |
| Actualización de subprocesos de chat | por subproceso de chat | 5 | - |
| Agregación o eliminación de participantes | por subproceso de chat | 10 | 30 |
| Obtención o enumeración de subprocesos de chat | por usuario | 50 | - |
| Obtener mensaje de chat | por usuario por subproceso de chat | 50 | - |
| Obtener mensaje de chat | por subproceso de chat | 250 | - |
| Mostrar mensajes de chat | por usuario por subproceso de chat | 50 | 200 |
| Mostrar mensajes de chat | por subproceso de chat | 250 | 400 |
| Obtener recibos de lectura (límite de 20 participantes*) | por usuario por subproceso de chat | 5 | - |
| Obtener recibos de lectura (límite de 20 participantes*) | por subproceso de chat | 100 | - |
| Enumeración de los participantes de los subprocesos de chat | por usuario por subproceso de chat | 10 | - |
| Enumeración de los participantes de los subprocesos de chat | por subproceso de chat | 250 | - |
| Enviar, actualizar o eliminar mensajes | por subproceso de chat | 10 | 30 |
| Envío de confirmación de lectura | por usuario por subproceso de chat | 10 | 30 |
| Envío de indicadores de escritura | por usuario por subproceso de chat | 5 | 15 |
| Envío de indicadores de escritura | por subproceso de chat | 10 | 30 |
Nota:
* Los recibos de lectura y los indicadores de escritura no se admiten en los subprocesos de chat con más de 20 participantes.
Almacenamiento de chats
Azure Communication Services almacena mensajes de chat según la directiva de retención que establezca al crear un subproceso de chat.
Importante
La funcionalidad descrita en este artículo se encuentra actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin un Acuerdo de Nivel de Servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.
Puede elegir entre retención de mensajes indefinida o eliminación automática entre 30 y 90 días a través de la directiva de retención en Crear API de subproceso de chat. Como alternativa, puede optar por no establecer una directiva de retención en un subproceso de chat.
Si tiene necesidades estrictas de cumplimiento, se recomienda eliminar subprocesos de chat mediante la API Eliminar subproceso de chat. Los subprocesos creados antes de la nueva directiva de retención no se ven afectados a menos que cambie específicamente la directiva de ese subproceso.
Nota:
Si eliminó accidentalmente los mensajes, el sistema no podrá recuperarlos. Además, si envía una solicitud de soporte técnico para un subproceso de chat eliminado después de que la directiva de retención haya eliminado ese subproceso, ya no se puede recuperar y no hay información sobre ese subproceso disponible. Si es necesario, abra una incidencia de soporte técnico lo antes posible en el período de 30 días después de crear un subproceso para que podamos ayudarle.
Llamadas de voz y vídeo
Limitaciones de llamadas RTC
| Nombre | Ámbito | Límite |
|---|---|---|
| Número predeterminado de llamadas simultáneas salientes* | por número | 2 |
Nota:
* No hay límites en las llamadas simultáneas entrantes. También puede enviar una solicitud al Soporte técnico de Azure para aumentar el límite de llamadas simultáneas salientes, que nuestro equipo de investigación revisará.
Limitaciones máximas de la llamada
| Nombre | Límite |
|---|---|
| Número de participantes | 350 |
Compatibilidad con streaming de Calling SDK
Calling SDK de Communication Services admite las siguientes configuraciones de streaming:
| Límite | Web | Windows/Android/iOS |
|---|---|---|
| Número máximo de secuencias salientes que se pueden enviar simultáneamente | un vídeo o un uso compartido de pantalla | un vídeo + un uso compartido de pantalla |
| Número máximo de secuencias remotas entrantes que se pueden enviar simultáneamente | nueve vídeos + un uso compartido de pantalla | nueve vídeos + un uso compartido de pantalla |
El SDK de llamada no aplica estos límites, pero los usuarios podrían experimentar una degradación del rendimiento si supera estos límites.
Tiempos de espera de Calling SDK
Los siguientes tiempos de espera se aplican a las instancias de Calling SDK de Communication Services:
| Action | Tiempo de espera en segundos |
|---|---|
| Participante de reconexión/eliminación | 120 |
| Agregar o quitar una nueva modalidad de una llamada (iniciar/detener el uso compartido de la pantalla o un vídeo) | 40 |
| Tiempo de espera de la operación de transferencia de llamadas | 60 |
| Tiempo de espera del establecimiento de llamadas entre dos personas | 85 |
| Tiempo de espera del establecimiento de llamadas de grupo | 85 |
| Tiempo de espera del establecimiento de llamadas RTC | 115 |
| Tiempo de espera de promoción de una llamada entre dos personas para que sea una llamada de grupo | 115 |
Acción que realizar
Para más información sobre el SDK y el servicio de llamadas de voz y vídeo, consulte la página de información general del SDK de llamada o los problemas conocidos. También puede enviar una solicitud de soporte técnico de Azure para aumentar algunos de los límites, pendientes de revisión por parte de nuestro equipo de investigación.
Enrutador de trabajos
Al enviar o recibir un gran volumen de solicitudes, es posible que reciba un error ThrottleLimitExceededException. Este error indica que está alcanzando las limitaciones del servicio y las solicitudes producen un error hasta que se reabastece el token de bucket para controlar las solicitudes después de un tiempo determinado.
Límites de velocidad para el enrutador de trabajos:
| Operación | Ámbito | Período de tiempo (segundos) | Límite (número de solicitudes) | Tiempo de espera en segundos |
|---|---|---|---|---|
| Solicitudes generales | Por recurso | 10 | 1000 | 10 |
Acción que realizar
Si necesita enviar un volumen de mensajes que supere los límites de velocidad, envíenos un correo electrónico a acs-ccap@microsoft.com.
Interoperabilidad de Teams y Microsoft Graph
Si usa un escenario de interoperabilidad de Teams, es probable que use algunas API de Microsoft Graph para crear reuniones.
Cada servicio ofrecido a través de Microsoft Graph tiene limitaciones diferentes; los límites específicos del servicio se describen aquí con más detalle.
Acción que realizar
Cuando implemente el control de errores, utilice el código de error HTTP 429 para detectar la limitación. La respuesta con error incluye el encabezado de respuesta Retry-After. Realizar una copia de seguridad de las solicitudes que usan el retraso Retry-After es la manera más rápida de recuperarse de la limitación porque Microsoft Graph sigue registrando el uso de recursos mientras se imponen límites a cliente.
Puede encontrar más información sobre los límites de Microsoft Graph en la documentación de Microsoft Graph.
Pasos siguientes
Consulte las opciones de ayuda y soporte técnico.