Limites de serviço para o Azure Communication Services
Este artigo explica as limitações das APIs dos Serviços de Comunicação do Azure e possíveis resoluções.
Padrões e arquitetura de limitação
Quando você atinge as limitações de serviço, você recebe um código de status HTTP 429 (muitas solicitações). Em geral, as seguintes práticas recomendadas são usadas para limitação:
- Reduza o número de operações por solicitação.
- Reduza a frequência de chamadas.
- Evite novas tentativas imediatas porque todos os pedidos vão-se acumulando em relação aos limites de utilização.
Encontre orientações mais gerais sobre como configurar sua arquitetura de serviço para lidar com a limitação e as limitações na documentação da arquitetura do Azure para padrões de limitação. Para aumentar os limites de limitação, faça uma solicitação ao Suporte do Azure.
- Abra o portal do Azure e inicie sessão.
- Selecione Ajuda+Suporte.
- Selecione Criar nova solicitação de suporte.
- Na caixa de texto Descrever o problema , introduza Técnico e, em seguida, selecione Ir.
- No menu suspenso Selecione um serviço, selecione Limites de Serviço e Assinatura (Cotas) e selecione Avançar.
- Na descrição do problema, escolha os valores Tipo de problema, Assinatura e Tipo de cota e selecione Avançar.
- Reveja qualquer solução recomendada, se disponível, e, em seguida, selecione Seguinte.
- Adicione outros detalhes conforme necessário e selecione Avançar.
- Em Rever + criar, verifique as informações, faça alterações conforme necessário e, em seguida, selecione Criar.
Siga as etapas para fazer uma solicitação ao Suporte do Azure.
Adquira números de telefone
Antes de adquirir um número de telefone, verifique se sua assinatura atende aos requisitos geográficos e de assinatura . Caso contrário, você não poderá comprar um número de telefone. As limitações a seguir se aplicam a números de compra por meio do SDK de números de telefone e do portal do Azure.
| Operação | Âmbito | Período de tempo | Limite (número de pedidos) |
|---|---|---|---|
| Número de telefone da compra | Inquilino do Azure | - | 1 |
| Pesquisar números de telefone | Inquilino do Azure | Uma semana | 5 |
Ação a executar
Para obter mais informações, consulte Tipos de número de telefone e Conceitos de telefonia.
Para aumentar os limites de compra do número, faça uma solicitação ao Suporte do Azure.
- Abra o portal do Azure e inicie sessão.
- Selecione Ajuda+Suporte.
- Selecione Criar nova solicitação de suporte.
- Na caixa de texto Descrever o problema , introduza Técnico e, em seguida, selecione Ir.
- No menu suspenso Selecione um serviço, selecione Limites de Serviço e Assinatura (Cotas) e selecione Avançar.
- Na descrição do problema, escolha os valores Tipo de problema, Assinatura e Tipo de cota e selecione Avançar.
- Reveja as soluções recomendadas, se disponíveis, e, em seguida, selecione Seguinte.
- Adicione mais detalhes conforme necessário e selecione Avançar.
- Em Rever + criar , verifique as informações, faça as alterações necessárias e, em seguida, selecione Criar.
Identidade
| Operação | Períodos de tempo (segundos) | Limite (número de pedidos) |
|---|---|---|
| Criar identidade | 30 | 1,000 |
| Excluir identidade | 30 | 500 |
| Emitir token de acesso | 30 | 1,000 |
| Revogar token de acesso | 30 | 500 |
createUserAndToken |
30 | 1,000 |
exchangeTokens |
30 | 500 |
Ação a executar
Recomendamos que você adquira identidades e tokens antes de criar threads de bate-papo ou iniciar chamadas. Por exemplo, execute essa tarefa quando a página da Web for carregada ou o aplicativo for iniciado.
Para obter mais informações, consulte Autenticar nos Serviços de Comunicação do Azure.
SMS
Quando você envia ou recebe um grande volume de mensagens, você pode receber um 429 erro. Esse erro indica que você está prestes a atingir as limitações de serviço. Suas mensagens são enfileiradas e enviadas depois que o número de solicitações estiver abaixo do limite.
Limites de taxa para SMS:
| Operação | Tipo de número | Âmbito | Prazos | Limite (número do pedido) | Unidades de mensagem por minuto |
|---|---|---|---|---|---|
| Enviar mensagem | Número Gratuito | Por número | 60 | 200 | 200 |
| Enviar mensagem | Código curto | Por número | 60 | 6.000 | 6.000 |
| Enviar mensagem | ID do remetente alfanumérico | Por recurso | 60 | 600 | 600 |
Ação a executar
Se você tiver requisitos que excedam os limites de taxa, envie uma solicitação ao Suporte do Azure para habilitar uma taxa de transferência mais alta.
Para obter mais informações sobre o SDK e o serviço do SMS, consulte Visão geral do SMS SDK ou as Perguntas frequentes do SMS.
Você pode enviar um número limitado de mensagens de e-mail. Se exceder os limites da taxa de e-mail da sua subscrição, os seus pedidos serão rejeitados. Você pode tentar essas solicitações novamente, depois que o tempo Repetir-Depois passar. Tome medidas antes de atingir o limite, solicitando o aumento dos limites de volume de envio, se necessário.
O serviço de email dos Serviços de Comunicação do Azure foi projetado para oferecer suporte a alta taxa de transferência. No entanto, o serviço impõe limites de taxa inicial para ajudar os clientes a integrar sem problemas e evitar alguns dos problemas que podem ocorrer ao mudar para um novo serviço de e-mail.
Recomendamos aumentar gradualmente o volume de emails usando o Email dos Serviços de Comunicação do Azure durante um período de duas a quatro semanas, enquanto monitoramos de perto o status de entrega de seus emails. Esse aumento gradual permite que provedores de serviços de e-mail terceirizados se adaptem à mudança de IP para o tráfego de e-mail do seu domínio. A mudança gradual dá-lhe tempo para proteger a reputação do remetente e manter a fiabilidade da entrega do seu e-mail.
O serviço de email dos Serviços de Comunicação do Azure oferece suporte a um grande volume de até 1-2 milhões de mensagens por hora. A alta taxa de transferência pode ser habilitada com base em vários fatores, incluindo:
- Pico de tráfego de clientes
- Necessidades do negócio
- Capacidade de gerenciar taxas de falha
- Reputação do domínio
Requisitos de taxa de falha
Para habilitar uma alta cota de e-mail, sua taxa de falha de e-mail deve ser inferior a um por cento (1%). Se a sua taxa de falhas for alta, você deve resolver os problemas antes de solicitar um aumento de cota. Espera-se que os clientes monitorem ativamente suas taxas de falha.
Se a taxa de falhas aumentar após um aumento de cota, os Serviços de Comunicação do Azure entrarão em contato com o cliente para uma ação imediata e um cronograma de resolução. Em casos extremos, se a taxa de falha não for gerenciada dentro do cronograma especificado, os Serviços de Comunicação do Azure poderão reduzir ou suspender o serviço até que o problema seja resolvido.
Artigos relacionados
Os Serviços de Comunicação do Azure fornecem logs e análises avançados para ajudar a monitorar e gerenciar taxas de falha. Para obter mais informações, consulte os seguintes artigos:
- Melhorar a reputação do remetente no email dos Serviços de Comunicação do Azure
- Informações por e-mail
- Habilitar logs por meio de Configurações de Diagnóstico no Azure Monitor
- Guia de início rápido: manipular eventos de e-mail
- Guia de início rápido: gerenciar listas de supressão de domínio nos Serviços de Comunicação do Azure usando as bibliotecas de cliente de gerenciamento
Nota
Para solicitar limites mais altos, siga as instruções em Aumento de cota para domínios de e-mail. Cotas mais altas só estão disponíveis para domínios personalizados verificados, não para domínios gerenciados pelo Azure.
Limites de taxa para e-mail
| Operação | Âmbito | Prazo (minutos) | Limite (número de e-mails) | Limites mais elevados disponíveis |
|---|---|---|---|---|
| Enviar E-mail | Por Subscrição | 1 | 30 | Sim |
| Enviar E-mail | Por Subscrição | 60 | 100 | Sim |
| Obter status de e-mail | Por Subscrição | 1 | 60 | Sim |
| Obter status de e-mail | Por Subscrição | 60 | 200 | Sim |
A tabela a seguir lista os limites para domínios gerenciados do Azure.
| Operação | Âmbito | Prazo (minutos) | Limite (número de e-mails) | Limites mais elevados disponíveis |
|---|---|---|---|---|
| Enviar E-mail | Por Subscrição | 1 | 5 | Não |
| Enviar E-mail | Por Subscrição | 60 | 10 | Não |
| Obter status de e-mail | Por Subscrição | 1 | 10 | Não |
| Obter status de e-mail | Por Subscrição | 60 | 20 | Não |
Limites de tamanho para e-mail
| Nome | Limite |
|---|---|
| Número de destinatários no e-mail | 50 |
| Tamanho total do pedido de e-mail (incluindo anexos) | 10 MB |
| Máximo de conexões autenticadas por assinatura | 250 |
Para todos os limites de tamanho de mensagem, considere que a codificação Base64 aumenta o tamanho da mensagem. Você precisa aumentar o valor de tamanho para levar em conta o aumento de tamanho da mensagem que ocorre depois que os anexos da mensagem e quaisquer outros dados binários são codificados em Base64. A codificação Base64 aumenta o tamanho da mensagem em cerca de 33%, portanto, o tamanho da mensagem é cerca de 33% maior do que o tamanho da mensagem antes da codificação. Por exemplo, se você especificar um valor de tamanho máximo de mensagem de aproximadamente 10 MB, poderá esperar um valor de tamanho máximo de mensagem realista de aproximadamente 7,5 MB.
Enviar anexos com mais de 10 MB
Para enviar anexos de ficheiros até 30 MB por e-mail, faça um pedido de suporte.
Se precisar de enviar anexos de ficheiros de e-mail com mais de 30 MB, utilize esta solução alternativa. Armazene os arquivos em uma conta de Armazenamento de Blob do Azure e inclua um link para os arquivos em seu email. Você pode proteger os arquivos com uma assinatura de acesso compartilhado (SAS). Uma SAS fornece acesso delegado seguro aos recursos em sua conta de armazenamento. Usando uma SAS, você tem controle granular sobre como os clientes podem acessar seus dados.
Benefícios de usar uma conta de armazenamento de Blob:
- Você pode lidar com arquivos de grande escala.
- Você pode usar uma SAS ou chaves para gerenciar com precisão o acesso a arquivos.
Para obter mais informações, consulte:
- Introduction to Azure Blob Storage (Introdução ao Armazenamento de Blobs do Azure)
- Conceder acesso limitado aos recursos do Armazenamento do Azure usando assinaturas de acesso compartilhado
Ação a executar
Para aumentar sua cota de e-mail, siga as instruções em Aumento de cota para domínios de e-mail.
Nota
Os pedidos de aumento de cota de e-mail podem levar até 72 horas para avaliação e aprovação, especialmente para solicitações que chegam na tarde de sexta-feira.
Chat
Os Serviços de Comunicação do Azure dão suporte ao bate-papo.
Limites de tamanho para bate-papo
| Nome | Limite |
|---|---|
| Número de participantes no tópico | 250 |
Lote de participantes: CreateThread |
200 |
Lote de participantes: AddParticipant |
200 |
Tamanho da página: ListMessages |
200 |
| Tamanho da mensagem | 28 KB |
| Número de recursos dos Serviços de Comunicação do Azure por Serviço de Bot do Azure | 1,000 |
Limites de taxa para bate-papo
| Operação | Âmbito | Limite por 10 segundos | Limite por minuto |
|---|---|---|---|
| Criar thread de bate-papo | Por utilizador | 10 | - |
| Excluir thread de bate-papo | Por utilizador | 10 | - |
| Atualizar tópico de bate-papo | Por tópico de bate-papo | 5 | - |
| Adicionar ou remover participantes | Por tópico de bate-papo | 10 | 30 |
| Obter thread de bate-papo ou listar tópicos de bate-papo | Por utilizador | 50 | - |
| Receber mensagem de chat | Por usuário, por thread de bate-papo | 50 | - |
| Receber mensagem de chat | Por tópico de bate-papo | 250 | - |
| Listar mensagens de bate-papo | Por usuário, por thread de bate-papo | 50 | 200 |
| Listar mensagens de bate-papo | Por tópico de bate-papo | 250 | 400 |
| Obter confirmações de leitura (limite de 20 participantes) | Por usuário, por thread de bate-papo | 5 | - |
| Obter confirmações de leitura (limite de 20 participantes) | Por tópico de bate-papo | 100 | - |
| Listar participantes do tópico de bate-papo | Por usuário, por thread de bate-papo | 10 | - |
| Listar participantes do tópico de bate-papo | Por tópico de bate-papo | 250 | - |
| Enviar mensagem, atualizar mensagem ou excluir mensagem | Por tópico de bate-papo | 10 | 30 |
| Enviar recibo de leitura | Por usuário, por thread de bate-papo | 10 | 30 |
| Enviar indicador de digitação | Por usuário, por thread de bate-papo | 5 | 15 |
| Enviar indicador de digitação | Por tópico de bate-papo | 10 | 30 |
Nota
Recibos de leitura e indicadores de digitação não são suportados em tópicos de bate-papo com mais de 20 participantes.
Armazenamento de bate-papo
Os Serviços de Comunicação do Azure armazenam mensagens de chat de acordo com a política de retenção definida quando cria um thread de chat.
Importante
A funcionalidade descrita neste artigo está atualmente em visualização pública. Esta versão de pré-visualização é fornecida sem um contrato de nível de serviço e não a recomendamos para cargas de trabalho de produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.
Você pode escolher entre retenção indefinida de mensagens ou exclusão automática entre 30 e 90 dias por meio da política de retenção na API Criar thread de chat. Como alternativa, você pode optar por não definir uma política de retenção em um thread de bate-papo.
Se você tiver necessidades estritas de conformidade, recomendamos que use a API Excluir thread de bate-papo para excluir threads de bate-papo. Todos os threads criados antes da nova política de retenção não são afetados, a menos que você altere especificamente a política para esse thread.
Nota
Se você excluir mensagens acidentalmente, o sistema não poderá recuperá-las. Se você enviar uma solicitação de suporte para um thread de bate-papo excluído depois que a política de retenção excluir esse thread, ele não poderá ser recuperado. As informações sobre esse segmento não estão mais disponíveis. Se necessário, abra um tíquete de suporte o mais rápido possível dentro da janela de 30 dias após a criação de um thread para que possamos ajudá-lo.
Chamadas de voz e vídeo
Os Serviços de Comunicação do Azure dão suporte a chamadas de voz e vídeo.
Limitações de chamadas PSTN
| Nome | Âmbito | Limite |
|---|---|---|
| Número padrão de chamadas simultâneas de saída | Por número | 2 |
Nota
Não há limites para chamadas simultâneas de entrada. Você também pode enviar uma solicitação ao Suporte do Azure para aumentar o limite de chamadas simultâneas de saída. A nossa equipa de verificação analisa todos os pedidos.
Limitações máximas de chamadas
| Nome | Limite |
|---|---|
| Número de participantes | 350 |
Chamando o suporte de streaming do SDK
O SDK de Chamada dos Serviços de Comunicação do Azure dá suporte às seguintes configurações de streaming:
| Limite | Web | Windows/Android/iOS |
|---|---|---|
| Número máximo de fluxos locais de saída que você pode enviar simultaneamente. | Um vídeo ou uma partilha de ecrã | Um vídeo + uma partilha de ecrã |
| Número máximo de fluxos remotos de entrada que você pode renderizar simultaneamente. | Nove vídeos + uma partilha de ecrã | Nove vídeos + uma partilha de ecrã |
O SDK de chamada não impõe esses limites, mas seus usuários podem sofrer degradação de desempenho se você exceder esses limites.
Chamando tempos limite do SDK
Os seguintes tempos limite aplicam-se aos SDKs de Chamada dos Serviços de Comunicação do Azure:
| Ação | Tempo limite em segundos |
|---|---|
| Reconecte ou remova um participante. | 120 |
| Adicionar ou remover nova modalidade de uma chamada. (Iniciar ou parar o compartilhamento de vídeo ou tela.) | 40 |
| Tempo limite da operação de transferência de chamadas. | 60 |
| Um tempo limite de estabelecimento de chamada 1:1. | 85 |
| Tempo limite de estabelecimento de chamadas em grupo. | 85 |
| Tempo limite de estabelecimento da chamada PSTN. | 115 |
| Promova uma chamada 1:1 para um tempo limite de chamada em grupo. | 115 |
Ação a executar
Para obter mais informações sobre o SDK e o serviço de chamadas de voz e vídeo, consulte Visão geral do SDK de chamada ou Problemas conhecidos nos SDKs e APIs. Você também pode enviar uma solicitação ao Suporte do Azure para aumentar alguns dos limites. A nossa equipa de verificação analisa todos os pedidos.
Roteador de trabalho
Quando você envia ou recebe um grande volume de solicitações, você pode receber um ThrottleLimitExceededException erro. Esse erro indica que você está atingindo as limitações de serviço. Suas solicitações falham até que o bucket de token usado para lidar com solicitações seja reabastecido após um certo tempo.
Limites de taxa para o Job Router
| Operação | Âmbito | Período de tempo (segundos) | Limite (número de pedidos) | Tempo limite em segundos |
|---|---|---|---|---|
| Pedidos gerais | Por recurso | 10 | 1,000 | 10 |
Ação a executar
Se você precisar enviar um volume de mensagens que exceda os limites de taxa, envie-nos um e-mail para acs-ccap@microsoft.com.
Interoperabilidade do Teams e Microsoft Graph
Usando um cenário de interoperabilidade do Teams, você provavelmente usará algumas APIs do Microsoft Graph para criar reuniões.
Cada serviço oferecido através do Microsoft Graph tem limitações diferentes. Os limites específicos do serviço são descritos nesta página Web em mais pormenor.
Ação a executar
Ao implementar o processamento de erros, utilize o código de erro HTTP 429 para detetar limitação de largura de banda. A resposta com falha inclui o cabeçalho da Retry-After resposta. Use o Retry-After atraso para recuar solicitações. É a maneira mais rápida de se recuperar da limitação porque o Microsoft Graph continua a registrar o uso de recursos enquanto um cliente é limitado.
Você pode encontrar mais informações sobre os limites de limitação do Microsoft Graph na documentação do Microsoft Graph.