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.
- Ir a Azure Portal
- Seleccione Ayuda y soporte técnico
- Haga clic en Crear nueva solicitud de soporte técnico
- En la descripción del problema, elija Tipo de problema como Técnico y agregue los detalles.
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 limitaciones siguientes 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.
Si quiere adquirir más números de teléfono o realizar un pedido especial, siga las instrucciones que se indican aquí. Si quiere realizar la portabilidad de números de teléfono gratuitos de cuentas externas a su cuenta de Azure Communication Services, siga las instrucciones que se indican aquí.
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.
Hay un límite en el número de mensajes de correo electrónico que puede enviar. Si supera los límites siguientes en la suscripción, se rechazarán las solicitudes. Puede volver a intentar estas solicitudes, una vez transcurrido el tiempo de reintento. Adopte las medidas necesarias y solicite que se aumenten los límites de volumen de envío si es necesario.
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 |
Acción que realizar
Esta configuración de espacio aislado sirve para ayudar a los desarrolladores a empezar a compilar la aplicación. Una vez que haya establecido una reputación de remitente mediante el envío de correos, podrá solicitar el aumento de los límites de volumen de envío. Envíe una solicitud de soporte técnico para aumentar el límite de envío de correo electrónico deseado si necesita enviar un volumen de mensajes que superen los límites de frecuencia. Las solicitudes de aumento de cuota de correo electrónico no se aprueban automáticamente. El equipo de revisión tendrá en cuenta su reputación general de remitente, que incluye factores como sus tasas de error en la entrega de correo electrónico, la reputación de su dominio y los informes de spam y abuso a la hora de determinar el estado de aprobación.
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 los mensajes de chat indefinidamente hasta que el cliente los elimine.
A partir de CY24 Q1, los clientes deben elegir entre la retención de mensajes indefinida o la eliminación automática después de 90 días. Los mensajes existentes no se ven afectados, pero los clientes pueden optar por un período de retención de 90 días si lo desean.
Nota:
El sistema no puede recuperar los mensajes eliminados accidentalmente.
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 |
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 | 9 vídeos + un uso compartido de pantalla | 9 vídeos + un uso compartido de pantalla |
Aunque el SDK de llamadas no aplicará estos límites, los usuarios pueden experimentar una degradación del rendimiento si se superan.
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.
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 se quitarán hasta que el token de bucket para controlar las solicitudes se reabastece 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.