Limites de serviço para Serviços de Comunicação do Azure
Este documento explica as limitações das APIs dos Serviços de Comunicação do Azure e possíveis resoluções.
Arquitetura e padrões de limitação
Quando você atinge limitações de serviço, 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.
- Reduzir a frequência de chamadas.
- Evitar novas repetições imediatas, pois todas as solicitações se acumulam em relação aos seus limites de uso.
Você pode encontrar diretrizes mais gerais sobre como configurar sua arquitetura de serviço para lidar com limitações na documentação da Arquitetura do Azure para padrões de limitação. Para aumentar os limites de limitação, você precisa fazer uma solicitação ao Suporte do Azure.
- Abra o portal do Azure e entre em sua conta.
- Selecione Ajuda + Suporte.
- Selecione Criar uma nova solicitação de suporte.
- Na caixa de texto Descreva o problema, insira Técnico e selecione Avançar.
- No menu suspenso Selecione um serviço, escolha Limites de Serviço e Assinatura (Cotas) e clique em Avançar.
- Na descrição do problema, escolha o Tipo de problema, a Assinatura e Tipo de cota e clique em Avançar.
- Examine qualquer solução recomendada, se disponível, e selecione Avançar.
- Adicione outros detalhes conforme necessário e selecione Avançar.
- Em Revisar + criar, verifique as informações, faça alterações conforme necessário e clique em Criar.
Siga as etapas para fazer uma solicitação ao Suporte do Azure.
Adquirir 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 seguintes limitações se aplicam à compra de números por meio de SDK de Números de Telefone e do portal do Azure.
| Operação | Escopo | Período | Limite (número total de solicitações) |
|---|---|---|---|
| Comprar número de telefone | Locatário do Azure | - | 1 |
| Pesquisar números de telefone | Locatário do Azure | Uma semana | 5 |
Ação a ser tomada
Para obter mais informações, consulte Tipos de número de telefone e Conceitos de telefonia.
Para aumentar os limites de compra de número, faça uma solicitação ao Suporte do Azure.
- Abra o portal do Azure e entre em sua conta.
- Selecione Ajuda + Suporte.
- Selecione Criar uma nova solicitação de suporte.
- Na caixa de texto Descreva o problema, insira Técnico e selecione Avançar.
- No menu suspenso Selecione um serviço, escolha Limites de Serviço e Assinatura (Cotas) e clique em Avançar.
- Na descrição do problema, escolha o Tipo de problema, a Assinatura e Tipo de cota e clique em Avançar.
- Examine as soluções recomendadas, se disponíveis, e selecione Avançar.
- Adicione mais detalhes conforme necessário e selecione Avançar.
- Em Revisar + criar, verifique as informações, faça alterações conforme necessário e clique em Criar.
Identidade
| Operação | Períodos de tempo (segundos) | Limite (número total de solicitações) |
|---|---|---|
| Criar a 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 ser tomada
Recomendamos que você adquira identidades e tokens antes de criar threads de chat ou iniciar chamadas. Por exemplo, quando a página da Web é carregada ou o aplicativo é iniciado.
Para obter mais informações, consulte Autenticar nos Serviços de Comunicação do Azure.
SMS
Ao enviar ou receber um grande volume de mensagens, você poderá receber um erro 429. 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 está abaixo do limite.
Limites de Taxa para SMS:
| Operação | Tipo de número | Escopo | Períodos de tempo | Limite (número da solicitação) | Unidades de mensagem por minuto |
|---|---|---|---|---|---|
| Enviar mensagem | Chamada gratuita | Por número | 60 | 200 | 200 |
| Enviar mensagem | Código curto | Por número | 60 | 6000 | 6000 |
| Enviar mensagem | ID alfanumérico do remetente | Por recurso | 60 | 600 | 600 |
Ação a ser tomada
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 de SMS e o serviço, consulte Visão geral do SDK de SMS ou Perguntas frequentes sobre SMS.
Você pode enviar um número limitado de mensagens de email. Se você exceder os limites de taxa de email para sua assinatura, suas solicitações serão rejeitadas. Você pode tentar essas solicitações novamente depois que o tempo de Repetir Após passar. Tome medidas antes de atingir o limite, solicitando o aumento dos limites de volume de envio, se necessário.
O serviço de hospedagem de email dos Serviços de Comunicação do Azure foi projetado para dar suporte à alta taxa de transferência. No entanto, o serviço impõe limites iniciais de taxa para ajudar os clientes a integrar sem problemas e evitar alguns dos problemas que podem ocorrer ao alternar para um novo serviço de email.
Recomendamos aumentar gradualmente o volume de email 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ço de email de terceiros se adaptem à alteração no IP para o tráfego de email do seu domínio. A alteração gradual dá a você tempo para proteger a reputação do remetente e manter a confiabilidade da entrega do seu email.
O serviço de email dos Serviços de Comunicação do Azure dá suporte a um alto volume de até 1 a 2 milhões de mensagens por hora. A alta taxa de transferência pode ser habilitada com base em vários fatores, incluindo:
- Tráfego de pico do cliente
- Necessidades comerciais
- Capacidade de gerenciar taxas de falha
- Reputação de domínio
Requisitos de taxa de falha
Para habilitar uma cota de email alta, sua taxa de falha de email precisa ser inferior a um por cento (1%). Se a taxa de falha for alta, você precisará resolver os problemas antes de solicitar um aumento de cota. Espera-se que os clientes monitorem ativamente as taxas de falha deles.
Se a taxa de falha 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 uma linha do tempo de resolução. Em casos extremos, se a taxa de falha não for gerenciada dentro da linha do tempo especificada, 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 avançados e análises para ajudar a monitorar e gerenciar as taxas de falha. Para obter mais informações, consulte os seguintes artigos:
- Aprimorar a reputação do remetente no email dos Serviços de Comunicação do Azure
- Email Insights
- Habilitar logs por meio Configurações de diagnóstico no Azure Monitor
- Início rápido: manipular eventos de email
- 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
Observação
Para solicitar limites mais altos, siga as instruções em Aumento de cota para domínios de email. Cotas mais altas estão disponíveis apenas para domínios personalizados verificados, não para domínios gerenciados pelo Azure.
Limites de taxa para email
| Operação | Escopo | Período de tempo (minutos) | Limite (número de emails) | Limites mais altos disponíveis |
|---|---|---|---|---|
| Enviar Email | Por assinatura | 1 | 30 | Sim |
| Enviar Email | Por assinatura | 60 | 100 | Sim |
| Obter o status de email | Por assinatura | 1 | 60 | Sim |
| Obter o status de email | Por assinatura | 60 | 200 | Sim |
A tabela a seguir lista os limites para domínios gerenciados do Azur.
| Operação | Escopo | Período de tempo (minutos) | Limite (número de emails) | Limites mais altos disponíveis |
|---|---|---|---|---|
| Enviar Email | Por assinatura | 1 | 5 | Não |
| Enviar Email | Por assinatura | 60 | 10 | Não |
| Obter o status de email | Por assinatura | 1 | 10 | Não |
| Obter o status de email | Por assinatura | 60 | 20 | Não |
Limites de tamanho para email
| Nome | Limite |
|---|---|
| Número de destinatários no email | 50 |
| Tamanho total da solicitação de email (incluindo anexos) | 10 MB |
| Máximo de conexões autenticadas por assinatura | 250 |
Para todos os limites de tamanho de mensagem, você precisa considerar que a codificação Base64 aumenta o tamanho da mensagem. Você precisa aumentar o valor do tamanho para levar em conta o aumento do 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%, então o tamanho da mensagem é cerca de 33% maior que o tamanho da mensagem antes da codificação. Por exemplo, se você especificar um valor máximo de tamanho de mensagem de ~10 MB, poderá esperar um valor máximo realista de tamanho de mensagem de aproximadamente ~7,5 MB.
Enviar anexos maiores que 10 MB
Para enviar anexos de arquivo de até 30 MB por email, preencha uma solicitação de suporte.
Se você precisar enviar anexos de email maiores que 30 MB, você pode usar essa solução alternativa. Armazene os arquivos em uma conta do Armazenamento de Blobs do Azure e inclua um link para os arquivos no seu email. Você pode proteger os arquivos com uma Assinatura de Acesso Compartilhado (SAS). Uma SAS oferece acesso delegado seguro aos recursos na conta de armazenamento. Ao usar o SAS, você tem controle granular sobre como os clientes podem acessar seus dados.
Benefícios de usar uma conta de Armazenamento de Blobs:
- Você pode manipular arquivos de grande porte.
- Você pode usar chaves SAS para gerenciar com precisão o acesso aos arquivos.
Para saber mais, veja:
- Introdução ao Armazenamento de Blobs do Azure
- Conceder acesso limitado aos recursos do Armazenamento do Azure usando assinaturas de acesso compartilhado (SAS)
Ação a ser tomada
Para aumentar sua cota de email, siga as instruções em Aumento de cota para domínios de email.
Observação
As solicitações de aumento de cota de email podem levar até 72 horas para serem avaliadas e aprovadas, especialmente para solicitações que chegam na sexta-feira à tarde.
Chat
Os Serviços de Comunicação do Azure dão suporte ao chat.
Limites de tamanho para chat
| Nome | Limite |
|---|---|
| Número de participantes no thread | 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 chatbots
| Operação | Escopo | Limite por 10 segundos | Limite por minuto |
|---|---|---|---|
| Criar a conversa de chat | Por usuário | 10 | - |
| Gerenciar a conversa de chat | Por usuário | 10 | - |
| Atualizar a conversa de chat | Por thread de chat | 5 | - |
| Adicionar participantes/remover participantes | Por thread de chat | 10 | 30 |
| Obter threads de chat/Listar threads de chat | Por usuário | 50 | - |
| Receber mensagem de chat | Por usuário por thread de chat | 50 | - |
| Receber mensagem de chat | Por thread de chat | 250 | - |
| Listar mensagens de chat | Por usuário por thread de chat | 50 | 200 |
| Listar mensagens de chat | Por thread de chat | 250 | 400 |
| Receba confirmações de leitura (limite de 20 participantes) | Por usuário por thread de chat | 5 | - |
| Receba confirmações de leitura (limite de 20 participantes) | Por thread de chat | 100 | - |
| Obter participantes da conversa de chat | Por usuário por thread de chat | 10 | - |
| Obter participantes da conversa de chat | Por thread de chat | 250 | - |
| Enviar mensagem/atualizar mensagem/excluir mensagem | Por thread de chat | 10 | 30 |
| Enviar confirmação de leitura | Por usuário por thread de chat | 10 | 30 |
| Enviar indicador de digitação | Por usuário por thread de chat | 5 | 15 |
| Enviar indicador de digitação | Por thread de chat | 10 | 30 |
Observação
* Confirmações de leitura e indicadores de digitação não têm suporte em tópicos de chat com mais de 20 participantes.
Armazenamento de chat
Os Serviços de Comunicação do Azure armazenam mensagens de chat de acordo com a política de retenção que você definiu quando criou uma conversa de chat.
Importante
A funcionalidade descrita neste artigo está atualmente em versão prévia pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias do Microsoft Azure.
Você pode escolher entre a retenção de mensagens indefinidas ou a exclusão automática entre 30 e 90 dias por meio da política de retenção na API Criar Conversa de Chat. Como alternativa, você pode optar por não definir uma política de retenção em uma conversa de chat.
Se você tiver necessidades estritas de conformidade, recomendamos que você exclua as conversas de chat usando a API Excluir Thread de Chat. Todas as conversas criadas antes da nova política de retenção não são afetadas, a menos que você altere especificamente a política dessa conversa.
Observação
Se você excluir mensagens acidentalmente, o sistema não poderá recuperá-las. Se você enviar uma solicitação de suporte para um thread de chat excluído depois que a política de retenção excluir esse thread, ele não poderá ser recuperado. As informações sobre esse thread não estão mais disponíveis. Se necessário, abra um tíquete de suporte o mais rápido possível no período de 30 dias depois de criar uma conversa para que possamos ajudar você.
Chamadas de voz e vídeo
Os Serviços de Comunicação do Azure dão suporte a chamadas de voz e de vídeo.
Limitações de chamada PSTN
| Nome | Escopo | Limite |
|---|---|---|
| Número padrão de chamadas simultâneas de saída | Por número | 2 |
Observação
Não há limites para chamadas de entrada simultâneas. Você também pode enviar uma solicitação ao Suporte do Azure para aumentar o limite de chamadas simultâneas de saída. Nossa equipe de avaliação analisa todas as solicitações.
Limitações máximas de chamada
| Nome | Limite |
|---|---|
| Número de participantes | 350 |
Suporte para streaming do SDK de Chamada
O SDK de Chamada dos Serviços de Comunicação 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 um compartilhamento de tela | Um vídeo + um compartilhamento de tela |
| Número máximo de fluxos remotos de entrada que você pode renderizar simultaneamente. | Nove vídeos + um compartilhamento de tela | Nove vídeos + um compartilhamento de tela |
O Calling SDK não impõe esses limites, mas seus usuários podem sofrer degradação de desempenho se você exceder esses limites.
Tempos limite do SDK de Chamada
Os seguintes tempos limite se aplicam aos SDKs de Chamada dos Serviços de Comunicação:
| Ação | Tempo limite em segundos |
|---|---|
| Reconecte ou remova um participante. | 120 |
| Adicione ou remova uma nova modalidade de uma chamada. (Inicie ou interrompa o compartilhamento de vídeo ou tela.) | 40 |
| Tempo limite da operação de Transferência de Chamada. | 60 |
| Tempo limite de estabelecimento de chamada 1:1. | 85 |
| Tempo limite de estabelecimento de chamada de grupo. | 85 |
| Tempo limite de estabelecimento de chamada PSTN. | 115 |
| Tempo limite para promover uma chamada 1:1 a chamada de grupo. | 115 |
Ação a ser tomada
Para obter mais informações sobre o SDK e o serviço de chamada 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. Nossa equipe de avaliação analisa todas as solicitações.
Roteador de Trabalhos
Ao enviar ou receber um grande volume de solicitações, você poderá receber um erroThrottleLimitExceededException. 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 determinado momento.
Limites de taxa para o Roteador de Trabalhos
| Operação | Escopo | Período de tempo (segundos) | Limite (número total de solicitações) | Tempo limite em segundos |
|---|---|---|---|---|
| Solicitações gerais | Por recurso | 10 | 1.000 | 10 |
Ação a ser tomada
Se você precisar enviar um volume de mensagens que excedam os limites de taxa, envie um email para nós em acs-ccap@microsoft.com.
interoperabilidade entre o Teams e o Microsoft Graph
Ao adotar um cenário de interoperabilidade do Teams, você provavelmente usará algumas APIs do Microsoft Graph para criar reuniões.
Cada serviço oferecido por meio do Microsoft Graph tem limitações diferentes. Os limites específicos do serviço são descritos nesta página da Web com mais detalhes.
Ação a ser tomada
Quando você implementa o tratamento de erro, use o código de erro HTTP 429 para detectar a limitação. A resposta com falha inclui o cabeçalho de resposta de Retry-After. Use o atraso de Retry-After para remover as solicitações. É a maneira mais rápida de se recuperar da limitação porque o Microsoft Graph continua registrando o uso de recursos enquanto um cliente é limitado.
Você pode encontrar mais informações sobre as limitações do Microsoft Graph na documentação do Microsoft Graph.