# Registro de Chamadas (CDR)

## Introdução

>[!tip] **Definição:**
>O **Registro de Chamadas**, também conhecido como CDR (*Call Detail Record*), é um conjunto detalhado de informações sobre cada chamada telefônica processada por um sistema de telefonia. Estes registros incluem tipicamente dados como número de origem e destino, data e hora de início, duração, tipo e custo da chamada, identificação do ramal e status da chamada. Os CDRs são essenciais para diversas finalidades, incluindo faturamento preciso, análise de uso, resolução de problemas, planejamento de capacidade e segurança.

No sistema, o processo de gerenciamento de chamadas telefônicas envolve dois componentes principais: a **importação de chamadas** e o **Registro de Chamadas (CDR)**. As chamadas são importadas através de tarefas de importação de ligações, utilizando [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]. Este processo permite que os dados das chamadas sejam transferidos de forma sistemática para o sistema. Após a importação, as chamadas são armazenadas no [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]]. O CDR (Call Detail Record) é uma ferramenta essencial projetada para o gerenciamento e análise de informações relacionadas às chamadas no sistema. 

Este formulário armazena o histórico de ligações dos ramais cadastrados, fornecendo uma visão abrangente das atividades de chamada. O Registro de Chamadas (CDR) serve como um repositório central de informações, permitindo aos usuários acessar, analisar e gerenciar detalhes importantes sobre as chamadas realizadas no sistema. Essa funcionalidade é crucial para o monitoramento eficaz do uso do sistema telefônico, faturamento preciso e análise de padrões de chamada.

>[!NOTA] **Acesso ao Formulário**
**Caminho:** Sistema > Plataforma Voip > Registro de chamadas > Registro de chamadas

## Estrutura do Formulário
O formulário de **Registro de Chamadas** está estruturado em uma grid, que reúne as informações de todos os registros de chamadas realizados pelas linhas de telefonia fixa cadastradas ([[ramal sip|Ramal SIP]]). Esta grid está organizada em linhas e colunas e cada registro individual corresponde ao mesmo formulário que armazena os detalhes das chamadas.

>[!INFO] Atenção:
>Este recurso está disponível para cadastros manuais de ligações para registro ou então quando utiliza-se [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]] no sistema, a partir do credenciamento de uma plataforma compatível com o sistema.

O formulário de **Registro de Chamadas** está relacionado à importação automática de ligações de telefonia fixa.

### Aba Registro de Chamadas
Esta aba é o núcleo do formulário, permitindo o registro detalhado das chamadas. Ela inclui informações cruciais como:

- ID SIP (linha de telefonia fixa);
- Ramal;
- Data;
- Origem da chamada;
- Destino da chamada;
- Duração da chamada;
- Dados de tarifação.

### Relação com outros módulos
A aba Registro de Chamadas se relaciona também com o [[formulario contrato do cliente|Contrato do Cliente]], quando ocorre a importação das ligações das linhas, armazenando as informações diretamente no registro individual de cada linha. Também é utilizada ao realizar a geração do adicional de telefonia nos contratos dos clientes.
- [[aba linha sip - contrato do cliente|Aba Linha SIP - Contrato do Cliente]];
- [[geracao do adicional de telefonia - filtros voip|Geração do Adicional de Telefonia - Filtros VoIP]]

### Campos do formulário

| Campo                                   | Descrição                                                                                    |
| --------------------------------------- | -------------------------------------------------------------------------------------------- |
| ID SIP                                  | Identificador do dispositivo SIP que originou ou recebeu a chamada.                          |
| Ramal                                   | Número do ramal associado à chamada.                                                         |
| Data                                    | Data e hora em que a chamada foi registrada.                                                 |
| Origem                                  | Número de telefone ou ramal de onde a chamada se originou.                                   |
| Destino discado                         | Número de telefone ou ramal para o qual a chamada foi direcionada.                           |
| Destino convertido                      | Número de telefone de destino após possíveis transformações ou redirecionamentos.            |
| Tempo total da chamada                  | Duração total da chamada em segundos.                                                        |
| Tempo tarifado da chamada               | Duração da chamada que foi efetivamente tarifada, em segundos.                               |
| ID tarifa                               | Identificador da tarifa aplicada à chamada.                                                  |
| Tipo da chamada                         | Categoria ou classificação da chamada (ex: local, internacional).                            |
| Valor compra                            | Custo da chamada para a empresa.                                                             |
| Valor venda                             | Valor cobrado ao cliente pela chamada.                                                       |
| Tarifado                                | Indica se a chamada foi tarifada (Sim ou Não).                                               |
| Aplicação executada pelo usuário        | Ação realizada pelo usuário durante a chamada (ex: Discou, Desligou, Setou).                 |
| Aplicação executada no canal de destino | Ação realizada no canal de destino da chamada (ex: Atendido, Desligou, Não Atendeu, Falhou). |
| Importado                               | Indica se a chamada foi importada (Sim ou Não).                                              |
## Funcionalidades Principais

### Filtro de Pesquisa
O filtro de pesquisa na grid deste formulário é uma ferramenta que permite aos usuários localizar chamadas específicas com base em diversos critérios, como:
- Data e hora;
- Número de origem;
- Número de destino;
- Duração da chamada;
- Status da chamada;

### [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]
O formulário oferece a capacidade de importar dados de chamadas de outros sistemas, facilitando a migração de dados e a consolidação de informações de diferentes fontes.

### Geração de Relatórios
Uma das funcionalidades mais úteis é a geração de relatórios detalhados sobre as chamadas realizadas, através do [[relatorio voip ligacoes|Relatório VoIP Ligações]];
- Volume de chamadas por período;
- Duração média das chamadas;
- Custos associados.

## Fluxo de Trabalho 

### Fluxo de Registro Manual de Ligação

```mermaid
graph TD
    A[Início] --> B[Acesso ao Formulário]
    B --> C[Registro de Nova Chamada]
    C --> D[Preenchimento de Campos Obrigatórios]
    D --> E[Salvamento do Registro]
    E --> F[Geração de Relatórios]
    F --> G[Análise de Dados]
    G --> H[Fim]
```

### Fluxo de Registro Mediante Importação de Ligações

```mermaid
graph TD
    A[Início] --> B[Importação Automática de Ligações VOIP]
    B --> C[Acesso ao Formulário]
    C --> D[Análise de Dados]
    D --> E[Fim]
```

## Considerações Finais
O formulário de **Registro de Chamadas** é uma ferramenta essencial para empresas que necessitam de um controle detalhado sobre suas comunicações. Ele oferece não apenas a capacidade de registrar informações cruciais, mas também fornece informações importantes através de suas funcionalidades de relatórios e análise.

## Etiquetas
#CDR #RegistroDeChamadas #PlataformaVoip
## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]
- [[ramal sip x clientes|Ramal SIP X Clientes]]
- [[aba linha sip - contrato do cliente|Aba Linha SIP - Contrato do Cliente]]
- [[relatorio voip ligacoes|Relatório VoIP Ligações]]
-  [[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]];
 - [[range de numeros cadastrados|Range de Números Cadastrados]]