# Explicação da Qualidade da assinatura do serviço

### Qualidade da assinatura do serviço é um add-on que transmite telemetria de QoS quase em tempo real para Zoom Meetings, Webinars e Zoom Phone por meio de 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. O QSS estende a funcionalidade do produto do Zoom ao enviar eventos de QoS no nível do participante em intervalos de nível de minuto (taxa e agregação podem variar conforme a configuração). Clientes/clientes podem usar este fluxo de dados rico para identificar se ambientes de rede estão afetando os serviços do Zoom.

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

O existente [Painel 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, o que pode ajudar Clientes/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 de amostragem mais rápida, as métricas agregadas de QoS Mostrarão valores diferentes do Painel principal do Zoom. No entanto, estas métricas ainda Permitirão que Clientes/clientes as Configurar 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 endpoints 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 quadros, Uso da CPU</td></tr><tr><td>Métricas de uso</td><td>Dispositivo, Rede, Região de sinalização, Versão do cliente, Áudio (I/O), vídeo (I/O)</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 logs de entrega de Evento são retidos por 7 dias por meio da API de Logs do webhook; os dados históricos de QoS por meio de pontos de extremidade da API podem permanecer por mais tempo (dependendo da licença).</td></tr></tbody></table>

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

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

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

QSS fornece dados de evento QoS para todos os utilizadores de uma conta em Zoom Meetings e webinars, bem como para chamadas do Zoom Phone. Como o Zoom não gerencia o último trecho das chamadas, o QSS fornece apenas dados de evento QoS ao nível da conta para chamadas do Zoom Phone e, portanto, não pode fornecer visibilidade total sobre os dados avançados de participante de ponta a ponta.

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

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

### O QSS permite que os clientes tragam dados brutos de QoS do Painel do Zoom para os 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 obter dados de QoS do Zoom, o QSS permite transmitir a telemetria de QoS do Zoom para as suas plataformas de gestão e monitorização de rede por meio de subscrições de evento (webhook ou WebSocket).

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

Os clientes do QSS podem subscrever eventos e dados de QoS em tempo real que serão enviados para os seus pontos de extremidade de 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](https://developers.zoom.us/docs/api/webhooks/) porque pode enviar dados brutos de QoS para um ponto de extremidade a uma taxa quase em tempo real de 4 a 6 vezes por minuto.

#### <mark style="color:azul;">O QSS permite que os clientes acessem dados de QoS quase em 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 consomem mais recursos do que os webhooks porque exigem chamadas repetidas para extrair dados de um ponto de extremidade de API.

Clientes que usam [APIs do Zoom](https://developers.zoom.us/docs/api/) para extrair dados de QoS do Painel do Zoom podem 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 dos clientes com limite de taxa ao enviar dados brutos de QoS para seus pontos de extremidade, em vez de exigir que os clientes extraiam os dados por conta própria.

#### <mark style="color:azul;">O QSS permite que os clientes consumam dados brutos de QoS do Zoom e solucionem problemas usando seu sistema preferido de gerenciamento de rede</mark>

Alguns clientes podem precisar avaliar o desempenho de sua rede em vários aplicativos ao mesmo tempo. O QSS permite que eles monitorem os dados de QoS do Zoom em um painel junto com outros dados em sua suíte de aplicativos, proporcionando uma maneira flexível e escalável de consumir dados de QoS do Zoom e integrá-los perfeitamente em painéis personalizados.

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

Os dados do QSS são criptografados em trânsito usando TLS 1.2 ou superior. Os pontos de extremidade devem usar um certificado válido de Autoridade de Certificação (CA). As solicitações 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 seus pontos de extremidade de webhook](https://developers.zoom.us/docs/api/webhooks/) usando uma Conector de sala na nuvem (CRC). O CRC confirmará a propriedade e a segurança das URLs dos pontos de extremidade de notificação do Evento.

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

Depois de um cliente comprar o plano 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 seguir 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 %}
**Criar um aplicativo de Assinatura de Evento (OAuth Geral ou Server-to-Server). Habilitar Assinaturas de Evento e Selecionar eventos de QoS**

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

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

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

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

Para subscrever aos 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 pela interface do Marketplace ou usando chamadas de API:

* `POST /Marketplace/aplicativo/Evento_subscription – criar`
* `PATCH /{id} – inscrever utilizadores/contas`
* `DELETE /{id} – cancelar a subscrição/excluir`
* `GET /Marketplace/aplicativo/assinatura_de_Evento – 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 do webhook quanto a autenticidade do Evento sejam devidamente validadas.

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

Para obter detalhes completos da implementação, consulte o [Guia de Implementação do 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 de Client Credentials Grant no Zoom Developer Docs.


---

# Agent Instructions: 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.