> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/pt/canto-do-administrador/network-management/quality-of-service-subscription-explainer.md).

# Explicador da Qualidade da assinatura do serviço

### Qualidade da assinatura do serviço é um add-on que disponibiliza streaming de telemetria QoS quase em tempo real para Zoom Meetings, Webinars e Zoom Phone via assinaturas de Evento

A Qualidade da assinatura do serviço (QSS) do Zoom é um produto add-on que oferece dados de Qualidade do serviço (QoS) quase em tempo real para Zoom Meetings, Webinars e chamadas telefónicas. A QSS estende a funcionalidade do produto do Zoom ao enviar eventos de QoS a nível de participante em intervalos ao nível de minuto (a taxa e a agregação podem variar consoante a configuração). Os Clientes/clientes podem usar este fluxo de dados rico para identificar se os ambientes de rede estão a afetar os serviços do Zoom.

#### <mark style="color:azul;">QSS fornece as mesmas métricas subjacentes de QoS usadas nos Dashboards e APIs do Zoom, mas a amostragem e o tempo diferem</mark>

O existente [Painel do Zoom](https://support.zoom.us/hc/en-us/articles/204654719-Getting-started-using-the-Zoom-Dashboard-) fornece métricas de desempenho e utilização da rede, que podem ajudar os clientes a entender como o Zoom está a operar num ambiente de rede. O QSS oferece os mesmos dados de QoS do Zoom, mas a uma taxa mais rápida. Devido a esta taxa mais rápida de amostragem, as métricas agregadas de QoS irão mostrar valores diferentes do Painel principal do Zoom. No entanto, estas métricas ainda Permitir aos clientes Configurar-las nas suas próprias vistas do painel para correlacionar os dados do Zoom com sistemas adicionais.

A tabela abaixo descreve os dados de QoS entregues aos pontos finais de um cliente via QSS.

<table><thead><tr><th width="230"></th><th>Dados de QoS entregues via QSS</th></tr></thead><tbody><tr><td>Métricas de Qualidade</td><td>Taxa de bits, Latência, Jitter, Perda de pacotes, Resolução, Taxa de fotogramas, Utilização da CPU</td></tr><tr><td>Métricas de uso</td><td>Dispositivo, Rede, Região de sinalização, Versão do cliente, Áudio (E/S), Vídeo (E/S)</td></tr><tr><td>Frequência</td><td>Aprox. 1 Evento por minuto, por participante (por métrica de QoS ou conjunto agregado, dependendo das Configurações da conta).</td></tr><tr><td>Retenção de Dados</td><td>Os registos de entrega de Evento são retidos por 7 dias através da API de registos de webhook; os dados históricos de QoS através de pontos de extremidade de API podem persistir por mais tempo (dependendo da licença).</td></tr></tbody></table>

#### <mark style="color:azul;">Os dados do Painel do Zoom não devem ser comparados com dados entregues via QSS para pontos de extremidade de terceiros de um cliente</mark>

O QSS e o Painel do Zoom fornecem dois mecanismos separados para aceder aos dados de QoS do Zoom que não devem ser comparados. Embora o Painel do Zoom e o QSS obtenham dados do mesmo conjunto de dados de QoS, os dados em cada mecanismo não corresponderão devido a diferenças no momento da obtenção e na frequência de entrega dos dados.

#### <mark style="color:azul;">O QSS suporta dados de Evento em tempo real para Reuniões, Webinars e chamadas telefônicas</mark>

O QSS fornece dados de Evento de QoS para todos os utilizadores numa conta para Zoom Meetings e Webinars, bem como para chamadas do Zoom Phone. Como o Zoom não gere o último trecho das chamadas, o QSS fornece apenas dados de Evento de QoS ao nível da conta para chamadas do Zoom Phone e, portanto, não pode fornecer visibilidade total nos dados avançados de ponta a ponta do participante.

#### <mark style="color:azul;">Os dados do QSS não incluem dados para participantes externos</mark>

QSS não fornece dados para participantes externos da reunião. No entanto, o QSS pode ajudar a identificar com precisão qual participante interno da reunião teve um problema e qual foi esse problema, bem como as métricas de qualidade e uso de que os clientes precisarão para solucionar problemas.

### O QSS permite que os clientes levem dados brutos de QoS do Painel do Zoom para seus fluxos de trabalho existentes

Embora os clientes do Zoom historicamente tenham conseguido usar ferramentas como o Painel do Zoom ou APIs para visualizar ou recuperar dados de QoS do Zoom, o QSS permite que você transmita a telemetria de QoS do Zoom para suas plataformas de gerenciamento e monitoramento de rede por meio de assinaturas de Evento (webhook ou WebSocket).

#### <mark style="color:azul;">O QSS entrega Eventos de QoS em quase tempo real para os seus pontos de extremidade assinados, reduzindo a sondagem da API e o impacto do limite de taxa</mark>

Os clientes do QSS podem assinar Eventos e dados de QoS em tempo real que serão enviados para os pontos de extremidade do aplicativo, o que ajuda a liberar capacidade da API e otimizar a utilização da rede. O QSS é uma ampliação do serviço de webhook padrão do Zoom [serviço de webhook padrão](https://developers.zoom.us/docs/api/webhooks/) porque ele pode enviar dados brutos de QoS para um ponto de extremidade a uma taxa de quase tempo real de 4 a 6 vezes por minuto.

#### <mark style="color:azul;">O QSS permite que os clientes Acessar dados de QoS em quase tempo real do Painel do Zoom sem atingir os limites de taxa da API</mark>

Os serviços de API são baseados em solicitações e usam um mecanismo de “pull” para coletar dados solicitados por um aplicativo ou usuário. As APIs exigem mais recursos do que os webhooks porque exigem chamadas repetidas para extrair dados de um ponto de extremidade da API.

Clientes que usam [APIs do Zoom](https://developers.zoom.us/docs/api/) extrair dados de QoS do Painel do Zoom pode encontrar limites de taxa, o que significa que atingiram o número máximo de chamadas de API que podem fazer dentro de um determinado período de tempo. O QSS não aumenta os limites de taxa da API, mas reduz as preocupações de limite de taxa dos Clientes/clientes ao enviar dados brutos de QoS para os respetivos endpoints, em vez de exigir que os Clientes/clientes extraiam os dados por si mesmos.

#### <mark style="color:azul;">QSS permite que Clientes/clientes consumam dados brutos de Zoom QoS e solucionem problemas usando o seu sistema de gestão de rede preferido</mark>

Alguns Clientes/clientes podem precisar avaliar o desempenho da sua rede em várias aplicações ao mesmo tempo. O QSS permite-lhes monitorizar os dados de Zoom QoS num Painel juntamente com outros dados no seu conjunto de aplicações, proporcionando uma forma flexível e escalável de consumir dados de Zoom QoS e integrá-los perfeitamente em painéis personalizados.

#### <mark style="color:azul;">Os dados do Zoom QoS são transmitidos através de TLS 1.2</mark>

Os dados QSS são encriptados em trânsito utilizando TLS 1.2 ou superior. Os endpoints devem usar um certificado válido de Autoridade de Certificação (CA). Os pedidos de webhook incluem um cabeçalho de assinatura e uma verificação de desafio-resposta para Verificação.

Para segurança adicional, os clientes serão solicitados a [validar os seus endpoints webhook](https://developers.zoom.us/docs/api/webhooks/) usando uma verificação de resposta a desafios (Conector de sala na nuvem (CRC)). O Conector de sala na nuvem (CRC) confirmará a titularidade e a segurança das URLs de pontos de extremidade de notificação de Evento.

### Clientes podem começar a consumir dados de QoS criando um aplicativo que possa receber eventos QSS

Depois que um Cliente/clientes compra o add-on do QSS, pelo menos um usuário na conta deve ter permissões de desenvolvedor habilitadas. Clientes/clientes podem então usar as três etapas a seguir para criar um aplicativo de webhook que pode se inscrever em eventos do QSS.

Clientes/clientes também podem buscar o [Pacote de Desenvolvimento do Zoom](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) com uma flag QSS ativada, que agrupa o QSS com outras ferramentas de desenvolvimento.

{% stepper %}
{% step %}
**Crie um aplicativo de assinatura de Evento (OAuth Geral ou Servidor para Servidor). Habilitar Assinaturas de Evento e Selecionar eventos QoS**

Clientes/clientes devem primeiro criar um aplicativo OAuth Geral ou Server-to-Server no [Zoom App Marketplace](https://marketplace.zoom.us/). Então, eles iriam Habilitar as Assinaturas de Evento e Selecionar os eventos de QoS que desejam receber.

Próximo(a), clientes devem especificar o destino das notificações de Evento do QSS inserindo a URL dos pontos de extremidade de notificação do seu aplicativo

{% hint style="info" %}
Não é necessário um aplicativo somente webhook para esta configuração. A Zoom recomenda criar um aplicativo Geral.
{% endhint %}
{% endstep %}

{% step %}
**Subscreva-se aos eventos do webhook QSS**

Para subscrever eventos QSS, Clientes/clientes devem Adicionar eventos e Escolher da lista de QSS Disponível **Tipos de Evento**. Clientes/clientes podem Selecionar um ou mais eventos QSS antes de concluir o processo e ativar seu aplicativo.

<figure><img src="/files/996e219144bce08e91d05e570793f5945a1c7b97" alt="Image of the Event types screen, focused on QSS options."><figcaption></figcaption></figure>

Você também pode gerenciar assinaturas via a interface do Marketplace ou usando chamadas de API:

* `POST /Marketplace/aplicativo/Evento_subscription – criar`
* `PATCH /{id} – subscrever utilizadores/contas`
* `DELETE /{id} – cancelar subscrição/eliminar`
* `GET /Marketplace/aplicativo/Evento_subscription – lista`

Para autenticar via API, use um token da Concessão de Credenciais do Cliente.
{% endstep %}

{% step %}
**Verificar eventos webhook**

Após configurar as assinaturas de Evento, certifique-se de que tanto a propriedade da URL de webhook quanto a autenticidade do Evento sejam devidamente validadas.

* **Validação de URL**
  * Quando você habilita pela primeira vez as subscrições de Evento, o Zoom executa uma verificação de Challenge–Response Check (Conector de sala na nuvem (CRC)) para verificar a propriedade do seu pontos de extremidade de webhook. Esse processo garante que o Zoom está enviando dados para um destino legítimo controlado pelo seu aplicativo. (Você pode incluir o processamento de Conector de sala na nuvem (CRC) em uma etapa de configuração anterior, se preferir.)
* **Validação de Evento**
  * Cada notificação de Evento recebida deve ser verificada pelo seu aplicativo para confirmar que foi originada do Zoom. O aplicativo pode validar as solicitações recebidas usando o cabeçalho de assinatura fornecido em cada Evento de webhook. Desenvolvedores que preferem uma alternativa ao método de assinatura padrão podem usar uma das outras opções de Verificação compatíveis descritas na Documentação do Desenvolvedor do Zoom.
  * Use a API Get Webhook Logs para revisar até sete dias de dados de entrega de webhook, incluindo status, contagem de tentativas e trace ID.
    {% endstep %}
    {% endstepper %}

Para obter detalhes completos da implementação, consulte o [Guia de Implementação QSS](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) para desenvolvedores. Para detalhes técnicos, consulte os guias da API de Assinatura de Evento, API de Logs de webhook e autenticação do Client Credentials Grant na Zoom Developer Docs.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://library.zoom.com/technical-library/pt/canto-do-administrador/network-management/quality-of-service-subscription-explainer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.