# Relatório VoIP Ligações

## Introdução
O **Relatório VoIP Ligações** é uma ferramenta projetada para a gestão e análise de dados relacionados às ligações realizadas por meio dos ramais SIP integrados ao sistema de telefonia IP. Sua função principal é apresentar informações detalhadas sobre o uso do serviço VoIP, favorecendo análises, monitoramento e tomada de decisões operacionais. Por meio desta ferramenta, é possível obter uma visão abrangente das chamadas realizadas, incluindo métricas como duração, horários, origem, destino, custos, entre outras informações relevantes. O relatório também contribui para identificar padrões de uso, possíveis gargalos e oportunidades de otimização do serviço de telefonia.

>[!Nota] **Acesso ao Formulário:**
>**Caminho:** Relatórios > Relatórios provedor > Relatórios Telefonia > Relatório Voip ligações

> [!WARNING] Atenção:
> Para utilizar este relatório, é necessário que as ligações VoIP tenham sido importadas para seu sistema.
>

### Requisitos de Uso
Requisitos para utilização do Relatório VoIP Ligações:
1. **Integração de Telefonia Fixa:**
    - O sistema deve possuir uma integração ativa com um serviço de telefonia VoIP.
    - A integração deve estar corretamente configurada e funcional.
      
2. **Importação de Ligações:**
       - As ligações devem ser importadas regularmente para o sistema.
    - O processo de importação deve estar configurado e funcionando adequadamente.
      
3. **Registro no CDR:**
        - As ligações importadas devem estar devidamente registradas no [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]]
        - O CDR deve estar atualizado com as informações mais recentes das ligações.

## Entrega de valor
- Permite uma visão ampla das ligações importadas;
- Promove maior controle e validação do consumo por parte do cliente;
- Fornece registros detalhados para fins de auditoria e conformidade regulatória;
- Ajuda a criar pacotes de serviços mais adequados às necessidades dos clientes;
- Permite avaliar o uso dos ramais SIP e planejar ajustes necessários na infraestrutura.

## Estrutura do Relatório
O formulário de **Relatório VoIP Ligações** centraliza a integração de dados de telefonia VoIP, ramais cadastrados no sistema e registros de ligações importadas. Sua interface principal é composta por uma tela de filtro e botões de ação posicionados na parte superior do relatório.

Esses elementos permitem que os usuários personalizem os relatórios com base em critérios específicos, como datas, ramais, ou tipos de chamadas. Além disso, possibilitam a análise detalhada dos dados de ligações, a geração de relatórios em diferentes formatos (como PDF ou XLS) para atender às necessidades variadas e o envio de extratos ou resumos diretamente para clientes finais. Essa funcionalidade torna o processo mais eficiente e adaptável a diversas demandas operacionais e estratégicas.

### Campos de Filtro

| Campo        | Descrição                                                     | Obrigatório |
| ------------ | ------------------------------------------------------------- | ----------- |
| Integração   | Seleciona a integração de VoIP para as ligações               | Sim         |
| Ramal        | Indica a linha SIP que será realizada a consulta no relatório | Não         |
| Data inicial | Indica a data inicial do período a ser consultado             | Não         |
| Data final   | Indica a data final do período a ser consultado               | Não         |

## Funcionalidades Principais

### Botão - Imprimir Relatório
A funcionalidade 'Imprimir relatório' é acessada através de um botão dedicado na interface. Esta função é projetada para gerar e imprimir um relatório abrangente das ligações VoIP, baseando-se nos filtros aplicados pelo usuário. Ao acionar este botão, o sistema processa os dados filtrados, compila as informações relevantes e cria um documento formatado para impressão. Este relatório tipicamente inclui detalhes como o ID do ramal, data e hora das chamadas, números de origem e destino, duração das ligações. A função oferece uma visão ampla das atividades de telefonia VoIP de um determinado ramal, facilitando análises e fornecendo um registro físico ou digital das comunicações para fins de auditoria, faturamento ou gestão operacional.

Como imprimir por **Imprimir relatório**:
1. Acesse o relatório Relatório VoIP Ligações através do caminho: Relatórios > Relatórios provedor > Relatórios Telefonia e selecione a opção **Relatório VoIP Ligações**;
2. Preencha os campos conforme necessário:
	- **Integração:** campo de preenchimento obrigatório. É necessário vincular a integração para o sistema identificar os ramais atrelados à plataforma. Clique na lupa e selecione a integração de telefonia fixa da qual deseja extrair as informações pelo relatório;
	- **Ramal:** clique na lupa e selecione o Ramal relacionado à integração de telefonia fixa;
	- **Data inicial:** insira a data inicial de ligações que deseja filtrar;
	- **Data final:** insira a data final de ligações que deseja filtrar, indicado o período no filtro.
	  
3. Clique no botão **Imprimir relatório**. O sistema apresentará dados do ramal, data, ligações de origem e destino e o tempo de duração da ligação.

### Imprimir Resumo
A funcionalidade 'Imprimir Resumo' é acessada através de um botão dedicado na interface, localizado como o segundo botão na sequência. Sua finalidade é gerar e imprimir um relatório resumido das ligações VoIP associadas a um ramal específico, com base nos filtros aplicados pelo usuário. Ao acionar o botão, o sistema processa os dados filtrados, compila as informações relevantes e formata um documento pronto para impressão. O relatório apresenta detalhes importantes, como o ID do ramal, o nome do cliente associado, o tempo total de ligações, o valor da franquia, os custos das chamadas realizadas e o valor total calculado com base no consumo registrado.

Como imprimir por **Imprimir resumo**:
1. Acesse o relatório Relatório VoIP Ligações através do caminho: Relatórios > Relatórios provedor > Relatórios Telefonia e selecione a opção **Relatório VoIP Ligações**;
2. Preencha os campos conforme necessário:
	- **Integração:** campo de preenchimento obrigatório. É necessário vincular a integração para o sistema identificar os ramais atrelados à plataforma. Clique na lupa e selecione a integração de telefonia fixa da qual deseja extrair as informações pelo relatório;
	- **Ramal:** clique na lupa e selecione o Ramal relacionado à integração de telefonia fixa;
	- **Data inicial:** insira a data inicial de ligações que deseja filtrar;
	- **Data final:** insira a data final de ligações que deseja filtrar, indicado o período no filtro.
	  
3. Clique no botão **Imprimir resumo**. O sistema apresentará dados como o nome do cliente portador da linha, a franquia contratada, o valor das ligações e valor total consumido.

### Imprimir Relatório Detalhado
A funcionalidade 'Imprimir Relatório Detalhado' é acessada por meio de um botão dedicado na interface. Essa opção é projetada para gerar um relatório completo das ligações VoIP realizadas, fornecendo informações detalhadas sobre cada chamada, com base nos filtros aplicados pelo usuário. Ao ativar a funcionalidade, o sistema processa os dados selecionados, organiza as informações e cria um documento formatado para visualização ou impressão. O relatório inclui detalhes específicos como a data e hora de cada chamada, o número de origem e destino, a duração exata das ligações, os custos individuais por chamada, além de outros dados relevantes para uma análise minuciosa do uso do serviço.

Como imprimir por **Imprimir Relatório Detalhado**:
1. Acesse o relatório Relatório VoIP Ligações através do caminho: Relatórios > Relatórios provedor > Relatórios Telefonia e selecione a opção **Relatório VoIP Ligações**;
2. Preencha os campos conforme necessário:
	- **Integração:** campo de preenchimento obrigatório. É necessário vincular a integração para o sistema identificar os ramais atrelados à plataforma. Clique na lupa e selecione a integração de telefonia fixa da qual deseja extrair as informações pelo relatório;
	- **Ramal:** clique na lupa e selecione o Ramal relacionado à integração de telefonia fixa;
	- **Data inicial:** insira a data inicial de ligações que deseja filtrar;
	- **Data final:** insira a data final de ligações que deseja filtrar, indicado o período no filtro.
	  
3. Clique no botão **Imprimir relatório detalhado**. O sistema apresentará dados do cliente, como o endereço, telefone, e-mail e celular. Apresenta dados relacionados à quantidade de minutos consumida por tipo de ligação. Exibe quatro seções principais: Ligações locais, Ligações interestaduais, Ligações internacionais, Ligações sem identificação. Cada seção apresenta a data e hora das ligações, o número de origem e destino, a duração e o valor de cada ligação.

### [[enviar extrato de ligacoes por e-mail|Enviar Extrato de Ligações por E-mail]]
A funcionalidade 'Enviar Extrato de Ligações por E-mail' permite compartilhar, de forma prática, um resumo das ligações VoIP diretamente com o endereço de e-mail dos destinatários. Essa opção está disponível na interface por meio de um botão dedicado e utiliza os filtros aplicados pelo usuário para selecionar os dados que serão enviados.
Ao acionar a funcionalidade, o sistema compila as informações relevantes em um formato adequado, como PDF, e envia o extrato para o endereço de e-mail configurado. O conteúdo do extrato inclui detalhes como o endereço do cliente, e-mail, celular, ID do ramal, a quantidade de ligações realizadas por tipo de ligação, a duração total, os custos associados e o valor total calculado. Essa ferramenta é ideal para compartilhar dados de maneira ágil com clientes.

> [!DICA]
> Utilize esta função para compartilhar rapidamente informações com clientes.

Como imprimir [[enviar extrato de ligacoes por e-mail|Enviar Extrato de Ligações por E-mail]]:
1. Acesse o relatório Relatório VoIP Ligações através do caminho: Relatórios > Relatórios provedor > Relatórios Telefonia e selecione a opção **Relatório VoIP Ligações**;
2. Preencha os campos conforme necessário:
	- **Integração:** campo de preenchimento obrigatório. É necessário vincular a integração para o sistema identificar os ramais atrelados à plataforma. Clique na lupa e selecione a integração de telefonia fixa da qual deseja extrair as informações pelo relatório;
	- **Ramal:** clique na lupa e selecione o Ramal relacionado à integração de telefonia fixa. O sistema irá considerar o ramal filtrado para efetuar o envio;
	- **Data inicial:** insira a data inicial de ligações que deseja filtrar;
	- **Data final:** insira a data final de ligações que deseja filtrar, indicado o período no filtro.
	
3. Clique em **Enviar extrato de ligações por e-mail** para realizar o envio. O sistema exibirá um relatório como retorno do envio. Se obtiver sucesso, retornará: "E-mail enviado com sucesso para (e-mail destinatário)!"

>[!CAUTION] Atenção:
>Para realizar o envio do extrato de ligações ao cliente, é necessário que exista um servidor de e-mail configurado em Configurações > Parâmetros > Parâmetros financeiro > Servidor de e-mail ligações telefonia.
><br>
>Para maiores informações, acesse o manual de configuração: [[enviar extrato de ligacoes por e-mail|Enviar Extrato de Ligações por E-mail]].

### Resumido com Clientes sem Consumo
A funcionalidade 'Resumido com Clientes Sem Consumo' é projetada para criar um documento que inclui tanto os clientes com consumo registrado quanto aqueles que não realizaram ligações no período especificado. Essa opção está disponível por meio de um botão dedicado na interface e utiliza os filtros aplicados pelo usuário para gerar o relatório. Ao ativar a funcionalidade, o sistema processa os dados identificando os clientes que tiveram atividade e aqueles sem consumo. O relatório, formatado para visualização ou impressão, apresenta informações resumidas, como o nome do cliente, o ID do ramal, a quantidade de ligações realizadas, o tempo total de chamadas e os custos associados. Para os clientes sem consumo, o relatório destaca essa ausência, permitindo uma análise completa e estratégica do uso do serviço.


## Fluxo de Trabalho

```mermaid
graph TD
    A[Acessar Formulário] --> B[Aplicar Filtros]
    B --> C{Escolher Ação}
    C --> D[Imprimir Relatório]
    C --> E[Imprimir Resumo]
    C --> F[Imprimir Detalhado]
    C --> G[Enviar por E-mail]
    C --> H[Resumo com Clientes sem Consumo]
```

## Considerações Finais
O **Relatório VoIP Ligações** é uma ferramenta essencial para o monitoramento, análise e gestão de chamadas realizadas por meio de ramais VoIP. Com funcionalidades que abrangem desde o envio de extratos por e-mail até a geração de relatórios detalhados ou resumidos, incluindo clientes sem consumo, essa solução oferece uma visão ampla e personalizada do uso do sistema de telefonia.
Sua utilização eficaz permite identificar padrões de consumo, controlar custos, monitorar desempenho e até mesmo atender a demandas específicas de clientes ou gestores. Dessa forma, o relatório não apenas auxilia na tomada de decisões estratégicas, mas também contribui para a otimização de processos operacionais e financeiros relacionados aos serviços de telefonia da empresa.

## Etiquetas
#Integracoes #IntegracoesVoIP #VoIP #Relatórios #Telefonia 

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]
- [[integracao voip - fale sempre - master abril 2025|Integração VOIP - Fale Sempre - MASTER ABRIL 2025]] 
- [[integracao voip - interede|Integração VoIP - Interede]]
- [[integracao voip - magnus billing|Integração VoIP - Magnus Billing]]
- [[integracao voip - saperx v2|Integração VoIP - SaperX v2]]
- [[integracao voip - sippulse|Integração VoIP - SipPulse]]
- [[integracao voip - summit networks|Integração VoIP - Summit Networks]]
- [[integracao voip - tysa|Integração VoIP - Tysa]]
- [[integracao voip - vsc|Integração VoIP - VSC]]
- [[integracao voip - zeus|Integração VoIP - Zeus]]
- [[ramal sip|Ramal SIP]]
- [[ramal sip x clientes|Ramal SIP X Clientes]]
- [[aba linha sip - contrato do cliente|Aba Linha SIP - Contrato do Cliente]]
- [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]]
- [[tarefa - importar cdr tysa|Tarefa - Importar CDR Tysa]]
- [[tarefa - importar ligacoes vsc|Tarefa - Importar Ligações VSC]]
- [[tarefa - importar ligacoes voip|Tarefa - Importar ligações VoIP]]
- [[tarefa - importar ligacoes zeus voip|Tarefa - Importar Ligações Zeus VoIP]]
- [[tarefa - importar cdr voip summit networks|Tarefa - Importar CDR Voip Summit Networks]]
- [[parametros financeiro|Parâmetros Financeiro]]
- [[e-mail smtp|E-mail SMTP]]