Límites de servicio para Azure Communication Services
En este artículo se explican las limitaciones de las API de Azure Communication Services y las posibles soluciones.
Arquitectura y patrones de limitación
Cuando alcance las limitaciones del servicio, recibirá un código de estado HTTP 429 (demasiadas solicitudes). En general, se usan los siguientes procedimientos recomendados para la limitación:
- 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.
Encuentre 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. Para aumentar los límites, realice una solicitud para Soporte técnico de Azure.
- Abra Azure Portal e inicie sesión.
- Seleccione Ayuda y soporte técnico.
- Seleccione Crear una solicitud de soporte técnico.
- En el cuadro de texto Descripción del problema, escriba Técnico y, a continuación, seleccione Ir a.
- En el menú desplegable Seleccionar un servicio, seleccione Límites de servicio y suscripción (cuotas) y luego seleccione Siguiente.
- En la descripción Problema, elija los valores Tipo de problema, Suscripción y Tipo de cuota y, a continuación, seleccione Siguiente.
- Revise cualquier solución recomendada, si está disponible y seleccione Siguiente.
- Actualice otros campos según sea necesario y, a continuación, seleccione Agregar.
- En Revisar y crear, compruebe la información, realice los cambios según sea necesario y, a continuación, seleccione Crear.
Siga los pasos para realizar una solicitud al servicio de 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 | Período 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 obtener más información, consulte Tipos de número de teléfono y Conceptos de telefonía.
Para aumentar los límites de compra de números, realice una solicitud al soporte técnico de Azure.
- Abra Azure Portal e inicie sesión.
- Seleccione Ayuda y soporte técnico.
- Seleccione Crear una solicitud de soporte técnico.
- En el cuadro de texto Descripción del problema, escriba Técnico y, a continuación, seleccione Ir a.
- En el menú desplegable Seleccionar un servicio, seleccione Límites de servicio y suscripción (cuotas) y luego seleccione Siguiente.
- En la descripción Problema, elija los valores Tipo de problema, Suscripción y Tipo de cuota y, a continuación, seleccione Siguiente.
- Revise cualquier solución recomendada, si está disponible y seleccione Siguiente.
- Actualice más campos según sea necesario y, a continuación, seleccione Agregar.
- 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 | 1,000 |
| Eliminar identidad | 30 | 500 |
| Emitir tokens de acceso | 30 | 1,000 |
| Revocar token de acceso | 30 | 500 |
createUserAndToken |
30 | 1,000 |
exchangeTokens |
30 | 500 |
Acción que realizar
Se recomienda adquirir identidades y tokens antes de crear subprocesos de chat o iniciar llamadas. Por ejemplo, realice esta tarea cuando se carga la página web o se inicia la aplicación.
Para obtener más información, consulte Autenticación en Azure Communication Services.
SMS
Al enviar o recibir un gran volumen de mensajes, es posible que reciba un error 429. Este error indica que está a punto de alcanzar las limitaciones del servicio. Los mensajes se ponen en cola y se envían después de que el número de solicitudes esté por debajo del umbral.
Límites de velocidad para SMS:
| Operación | Tipo de número | Ámbito | Períodos de tiempo | Límite (número de solicitud) | Unidades de mensaje por minuto |
|---|---|---|---|---|---|
| Enviar mensaje | Número gratuito | Por número | 60 | 200 | 200 |
| Enviar mensaje | Código corto | Por número | 60 | 6000 | 6000 |
| Enviar mensaje | Id. alfanumérico de remitente | 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 Información general del SDK de SMS o Preguntas frecuentes sobre SMS.
Correo electrónico
Puede enviar un número limitado de mensajes de correo electrónico. Si supera los límites de tasas de correo electrónico 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.
El servicio de correo electrónico de Azure Communication Services admite un gran volumen de hasta 1 a 2 millones de mensajes por hora. La capacidad de proceso elevada se puede habilitar en función de varios factores, entre los que se incluyen:
- Tráfico máximo del cliente
- Necesidades empresariales
- Capacidad de administrar las tasas de errores
- Reputación del dominio
Requisitos de tasas de errores
Para habilitar una cuota de correo electrónico alta, la tasa de errores de correo electrónico debe ser inferior a un porcentaje (1 %). Si la tasa de errores es alta, debe resolver los problemas antes de solicitar un aumento de cuota. Se espera que los clientes supervisen activamente sus tasas de errores.
Si la tasa de errores aumenta después de un aumento de cuota, Azure Communication Services se comunicará con el cliente para obtener una acción inmediata y una escala de tiempo de resolución. En casos extremos, si la tasa de errores no se administra dentro de la escala de tiempo especificada, Azure Communication Services puede reducir o suspender el servicio hasta que se resuelva el problema.
Artículos relacionados
Azure Communication Services proporciona registros y análisis completos para ayudar a supervisar y administrar las tasas de errores. Vea los siguientes artículos para más información:
- Mejora de la reputación del remitente en el correo electrónico de Azure Communication Services
- Email Insights
- Habilitación de registros mediante Configuración de diagnóstico en Azure Monitor
- Inicio rápido: Control de eventos de correo electrónico
- Inicio rápido: Administración de listas de supresión de dominios en Azure Communication Services mediante las bibliotecas de cliente de administración
Nota:
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 frecuencia para correo electrónico
| Operación | Ámbito | Período de tiempo (minutos) | Límite (número de correos electrónicos) | Límites superiores disponibles |
|---|---|---|---|---|
| Enviar correo | Por suscripción | 1 | 30 | Sí |
| Enviar correo | Por suscripción | 60 | 100 | Sí |
| Obtén el estado del correo electrónico | Por suscripción | 1 | 60 | Sí |
| Obtén el estado del correo electrónico | Por suscripción | 60 | 200 | Sí |
En la siguiente tabla se enumeran los límites de Dominios administrados por Azure.
| Operación | Ámbito | Período de tiempo (minutos) | Límite (número de correos electrónicos) | Límites superiores disponibles |
|---|---|---|---|---|
| Enviar correo | Por suscripción | 1 | 5 | No |
| Enviar correo | Por suscripción | 60 | 10 | No |
| Obtén el estado del correo electrónico | Por suscripción | 1 | 10 | No |
| Obtén el estado del correo electrónico | Por suscripción | 60 | 20 | No |
Límites de tamaño para el correo electrónico
| Nombre | Límite |
|---|---|
| Número de destinatarios en el 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, tenga 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 aproximadamente 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, realice una solicitud de soporte técnico.
Si necesita enviar datos adjuntos de archivos de correo electrónico de más de 30 MB, use 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). Una SAS proporciona acceso delegado a los recursos de la cuenta de almacenamiento. Con una SAS, tiene control granular sobre la forma en que un cliente puede tener acceso a los datos.
Ventajas de usar una cuenta de Blob Storage:
- Puede controlar archivos a gran escala.
- Puede usar una SAS o claves para administrar con precisión el acceso a archivos.
Para más información, vea:
- Introducción a Azure Blob Storage
- Conceder acceso limitado a los recursos de Azure Storage mediante firmas de acceso compartido
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 por correo electrónico pueden tardar hasta 72 horas en evaluarse y aprobarse, sobre todo las que llegan el viernes por la tarde.
Chat
Azure Communication Services admite chat.
Límites de tamaño para chat
| 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 del mensaje | 28 KB |
| Número de recursos de Azure Communication Services por Azure Bot Service | 1,000 |
Límites de frecuencia para chat
| 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 | Subproceso por chat | 5 | - |
| Agregar participantes o quitar participantes | Subproceso por chat | 10 | 30 |
| Obtener subprocesos de chat o lista de subprocesos de chat | Por usuario | 50 | - |
| Obtener mensaje de chat | Por usuario, por subproceso de chat | 50 | - |
| Obtener mensaje de chat | Subproceso por chat | 250 | - |
| Mostrar mensajes de chat | Por usuario, por subproceso de chat | 50 | 200 |
| Mostrar mensajes de chat | Subproceso por 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) | Subproceso por 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 | Subproceso por chat | 250 | - |
| Enviar mensaje, actualizar mensaje o eliminar mensaje | Subproceso por 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 | Subproceso por 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 de cumplimiento estrictas, se recomienda usar la API de Eliminar subproceso de chat para eliminar subprocesos 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 elimina accidentalmente mensajes, el sistema no puede recuperarlos. Si envía una solicitud de soporte técnico para un subproceso de chat eliminado después de que la directiva de retención elimine ese subproceso, no se podrá recuperar. La información sobre ese subproceso ya no está 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
Azure Communication Services admite 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. Nuestro equipo de investigación revisa todas las solicitudes.
Limitaciones máximas de la llamada
| Nombre | Límite |
|---|---|
| Número de participantes | 350 |
Compatibilidad con streaming de Calling SDK
El SDK de llamadas de Azure Communication Services admite las siguientes configuraciones de streaming:
| Límite | Web | Windows/Android/iOS |
|---|---|---|
| Número máximo de secuencias locales salientes que puede enviar simultáneamente. | Un vídeo o un uso compartido de pantalla | Un vídeo y un uso compartido de pantalla |
| Número máximo de flujos remotos entrantes que puede representar simultáneamente. | Nueve vídeos y un uso compartido de pantalla | Nueve vídeos y 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 los SDK de llamada de Azure Communication Services:
| Action | Tiempo de espera en segundos |
|---|---|
| Vuelva a conectar o quite un participante. | 120 |
| Agregue o quite una nueva modalidad de una llamada. (Iniciar o detener el uso compartido de vídeo o pantalla). | 40 |
| Tiempo de espera de la operación de transferencia de llamadas. | 60 |
| Un tiempo de espera de establecimiento de llamadas entre dos personas. | 85 |
| Tiempo de espera de 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 obtener más información sobre el SDK de voz y videollamada y el servicio, consulte Introducción al SDK de llamadas o Problemas conocidos en los SDK y las API. También puede enviar una solicitud de soporte técnico de Azure para aumentar algunos de los límites. Nuestro equipo de investigación revisa todas las solicitudes.
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. Sus solicitudes fallan hasta que el depósito de tokens que se utiliza para administrar las solicitudes se repone después de un cierto tiempo.
Límites de frecuencia para 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 | 1,000 | 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
Con 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 en esta página web 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. Use el retraso de Retry-After para revertir las solicitudes. Es la forma más rápida de recuperarse de la limitación porque Microsoft Graph sigue registrando el uso de recursos mientras un cliente está limitado.
Puede encontrar más información sobre los límites de Microsoft Graph en la documentación de Microsoft Graph.