Compartilhar via


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 (Excesso de solicitações). Em geral, as seguintes são as práticas recomendadas para lidar com a 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. Esses limites podem ser aumentados por meio de uma solicitação para o Suporte do Azure.

  1. Abra o portal do Azure e entre em sua conta.
  2. Selecione Ajuda + Suporte.
  3. Clique em Criar solicitação de suporte.
  4. Na caixa de texto Descreva seu problema, insira Technical e clique em Ir.
  5. No menu suspenso Selecionar um serviço, escolha Limites de Serviço e Assinatura (Cotas) e clique em Avançar.
  6. Na descrição do problema, escolha o Tipo de problema, a Assinatura e Tipo de cota e clique em Avançar.
  7. Revise qualquer Solução recomendada se disponível e clique em Avançar.
  8. Inclua Detalhes adicionais conforme necessário e clique em Avançar.
  9. Em Revisar + criar, verifique as informações, faça alterações conforme necessário e clique em Criar.

Você pode seguir a documentação para criar uma solicitação para o Suporte do Azure.

Como 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 do Phone Numbers SDK e do portal do Azure.

Operação Escopo Período de tempo 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, confira a página de conceito de tipos de números de telefone e a página de visão geral do conceito de telefonia.

Os limites de compra de números podem ser aumentados por meio de uma solicitação ao Suporte do Azure.

  1. Abra o portal do Azure e entre em sua conta.
  2. Selecione Ajuda + Suporte.
  3. Clique em Criar solicitação de suporte.
  4. Na caixa de texto Descreva seu problema, insira Technical e clique em Ir.
  5. No menu suspenso Selecionar um serviço, escolha Limites de Serviço e Assinatura (Cotas) e clique em Avançar.
  6. Na descrição do problema, escolha o Tipo de problema, a Assinatura e Tipo de cota e clique em Avançar.
  7. Revise qualquer Solução recomendada se disponível e clique em Avançar.
  8. Inclua Detalhes adicionais conforme necessário e clique em Avançar.
  9. Em Revisar + criar, verifique as informações, faça alterações conforme necessário e clique em Criar.

Identidade

Operação Períodos (segundos) Limite (número total de solicitações)
Criar a identidade 30 1000
Excluir identidade 30 500
Emitir token de acesso 30 1000
Revogar token de acesso 30 500
createUserAndToken 30 1000
exchangeTokens 30 500

Ação a ser tomada

É recomendável adquirir 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 saber mais, confira a página visão geral do conceito de identidade.

SMS

Ao enviar ou receber um alto volume de mensagens, você poderá receber um erro 429. Esse erro indica que você está atingindo as limitações de serviço e suas mensagens serão colocadas na fila para serem enviadas quando o número de solicitações ficar abaixo do limite.

Limites de Taxa para SMS:

Operação Tipo de número Escopo Período (s) Limite (nº de solicitações) 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 para o 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, confira a página visão geral do SDK de SMS ou a página de Perguntas frequentes sobre SMS.

Email

Você pode enviar um número limitado de mensagens de email. Se você exceder os seguintes limites 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.

Limites de taxa

Domínios personalizados

Operação Escopo Período de tempo (minutos) Limite (número de emails)
Enviar Email Por assinatura 1 30
Enviar Email Por assinatura 60 100
Obter o status de email Por assinatura 1 60
Obter o status de email Por assinatura 60 200

Domínios Gerenciados do Azure

Operação Escopo Período de tempo (minutos) Limite (número de emails)
Enviar Email Por assinatura 1 5
Enviar Email Por assinatura 60 10
Obter o status de email Por assinatura 1 10
Obter o status de email Por assinatura 60 20

Limites de tamanho

Nome Limite
Número de destinatários no email 50
Tamanho total da solicitação de email (incluindo anexos) 10 MB

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). O SAS fornece acesso delegado seguro aos recursos em sua 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 do Armazenamento de Blobs do Azure:

  • 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:

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

Limites de tamanho

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 Bot do Azure 1000

Limites de taxa

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

* Recibos de leitura e indicadores de digitação não são suportados 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 Conversa 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ê excluiu mensagens acidentalmente, elas não poderão ser recuperadas pelo sistema. Além disso, se você enviar uma solicitação de suporte para uma conversa de chat excluída depois que a política de retenção tiver excluído a conversa, ela não poderá mais ser recuperada e nenhuma informação sobre a conversa estará disponível. 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

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 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, que é revisado por nossa equipe de verificação.

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
Reconectar/remover participante 120
Adicionar ou remover nova modalidade de uma chamada (iniciar/parar o vídeo ou compartilhamento de 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 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, confira a página visão geral do SDK de chamada ou problemas conhecidos. Você também pode enviar uma solicitação ao Suporte do Azure para aumentar alguns dos limites, aguardando análise da nossa equipe de verificação.

Roteador de Trabalhos

Ao enviar ou receber um alto volume de solicitações, você poderá receber um erro ThrottleLimitExceededException. Esse erro indica que você está atingindo as limitações do serviço e suas solicitações falharão até que o token do bucket para manipular solicitações seja reabastecido após um determinado tempo.

Limites de taxa para o Roteador de Trabalhos:

Operação Escopo Período (segundos) Limite (número total de solicitações) Tempo limite em segundos
Solicitações gerais Por Recurso 10 1000 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 do Teams e do 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 aqui em 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. O recuo de solicitações usando o atraso Retry-After é a maneira mais rápida de se recuperar da limitação, pois o Microsoft Graph continua registrando o uso de recursos enquanto um cliente está sendo limitado.

Você pode encontrar mais informações sobre limites de limitação do Microsoft Graph na documentação do Microsoft Graph.

Próximas etapas

Confira as opções ajuda e suporte.