pt
4 min de leitura Empresas

Auditoria de Chamadas para Empresas: Como Funciona o Módulo

O módulo empresarial de auditoria de chamadas: envie gravações da sua operação, organize por agentes, equipas e guiões, e acompanhe métricas — via painel e API.

O módulo de auditoria de chamadas é um recurso empresarial para operações que gravam chamadas — call centers, equipas comerciais, atendimento. Em vez de transcrever chamada por chamada manualmente, a sua operação envia as gravações em escala e recebe as auditorias processadas, organizadas por agente, equipa e guião.

O que o módulo oferece

  • Auditorias em escala: cada gravação enviada dá origem a uma auditoria processada de forma assíncrona — você envia, e o resultado chega ao seu sistema por webhook.
  • Registo da operação: agentes (com identificador externo do seu sistema), equipas e guiões com versões — para avaliar a chamada face ao guião vigente na altura.
  • Métricas: resumo analítico da operação e visão por agente.
  • Utilização e consumo: acompanhamento do que a operação processou no período.

Onde faço a gestão

A gestão fica no painel da organização, em /dashboard/organization/auditorias. É lá que OWNER e ADMIN criam as chaves de API da organização que a integração usa:

  • Até 10 chaves ativas por organização;
  • Cada chave tem âmbitos de permissão (ex.: gravar auditorias, ler auditorias, ler utilização e análises) — por omissão, nega o que não foi concedido;
  • Uma chave comprometida pode ser revogada na hora, sem afetar as demais.

As chaves são da organização, não do utilizador. Trate-as como segredo de infraestrutura: variável de ambiente no seu servidor, nunca no front-end ou em folhas de cálculo.

Como entram as gravações

Dois caminhos, pensados para telefonia:

  1. Por URL — se o seu PABX/plataforma expõe a gravação num URL https público, envie o URL diretamente.
  2. Por upload — se as gravações não têm URL público, a API fornece um URL de envio temporário (válido por 1 hora) para carregar o ficheiro, e você referencia esse carregamento na auditoria.

Cada auditoria enviada exige um webhook para receber o resultado — a operação não precisa (e não deve) ficar a consultar o estado. As entregas são assinadas e repetidas automaticamente se o seu servidor estiver fora do ar (até 6 tentativas). Detalhes técnicos, endpoints e exemplos de código em API Enterprise de auditoria.

Use o campo de identificador externo do agente com o mesmo ID do seu sistema de telefonia. Assim, as métricas por agente batem 1:1 com os seus relatórios internos.

O que preciso para começar

  1. Plano empresarial ativo com organização configurada;
  2. Um responsável técnico para gerar a chave e configurar o webhook;
  3. Acesso às gravações (URL público ou ficheiros para carregar).

Se a sua operação tem um volume alto ou requisitos específicos, fale com vendas — o plano à medida cobre cenários fora do comum.

FAQ

O módulo está disponível em planos individuais?

Não — é um recurso do contexto empresarial, gerido pela organização e pelas chaves de API dela.

Quem pode criar as chaves de integração?

OWNER e ADMIN da organização, no painel de auditorias. São até 10 chaves ativas, cada uma com âmbitos próprios.

As minhas gravações não têm URL público. E agora?

Use o fluxo de upload: a API devolve um URL de envio válido por 1 hora, carregue o ficheiro e crie a auditoria com referência a esse carregamento.

Como recebo os resultados?

Por webhook, obrigatório em cada auditoria. Entregas assinadas (HMAC) e com reenvio automático.

Artigos relacionados

Não resolveu? Abra um ticket — a nossa equipa responde rapidamente.