# Importar Ligações VoIP

## Introdução
A tarefa **Importar ligações VoIP** é uma funcionalidade para empresas que utilizam integrações de telefonia fixa no Sistema importarem as ligações de clientes e as registrarem no sistema, garantindo que todas as informações relevantes estejam disponíveis para análise e gerenciamento dentro do sistema.

> [!NOTA] Acesso à Configuração
> Caminho: Ferramentas > Ferramentas > Agenda de Tarefas > Importar ligações VoIP

### Requisitos de uso
- É necessário utilizar uma integração de telefonia fixa no sistema para utilizar a tarefa de **Importar ligações VoIP**, sendo ela compatível com as seguintes plataformas:

>[!EXAMPLE] Plataformas compatíveis:
>- [[integracao voip - saperx v2|Integração VoIP - SaperX v2]]
>- [[integracao voip - magnus billing|Integração VoIP - Magnus Billing]]
>- [[integracao voip - interede|Integração VoIP - Interede]]

## Entrega de Valor
- Automatização da coleta de dados de ligações;
- Centralização das informações de telefonia no sistema;
- Facilitação da análise de uso e faturamento dos serviços de VoIP.

## Estrutura do formulário
O formulário de Agenda de tarefas está organizado em uma única aba, que permite o cadastramento da tarefa de **Importar Ligações VoIP** e configuração da sua execução periódica.

## Funcionalidades principais
- Importar registros telefônicos de ligações realizadas através de [[ramal sip|Ramal SIP]], armazenando-os no formulário [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]].

## Configuração da tarefa

### Funcionamento da tarefa
A tarefa de **Importar ligações VoIP** tem seu funcionamento em conjunto com a configuração de [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]] e cadastro de ramais SIP no sistema ativos e em funcionando. Uma vez que existe a parametrização adequada, é possível configurar a tarefa para que os registros de ligações constem no sistema, para controle do histórico e dados de consumo, bem como realizar o faturamento com base nas ligações e excedentes.

### Configuração
Para realizar a configuração da tarefa, siga os passos abaixo:

>[!TIP] **Atenção:** 
>A rotina deve ser configurada **de acordo com a forma de importação definida dentro da integração**.  <br>
>- Caso a importação seja **mensal**, a rotina precisa ser executada apenas 1 vez no mês;  
>- Caso a rotina seja **diária**, a rotina precisa ser executada todos os dias.

1. Acesse o formulário de **Agenda de tarefas** através do caminho: Ferramentas > Ferramentas > Agenda de tarefas;
2. Clique no botão **Novo** para cadastrar a tarefa;
3. No campo **Tarefa**, selecione a opção **Importar ligações VoIP**;
4. Preencha o horário em que a tarefa executará a partir dos campos de Minuto e Hora. No campo **Minuto**, indique o minuto em que a tarefa executará, correlacionando ao campo de hora. No campo **Hora**, indique o horário em que a tarefa executará;
   
> **Exemplo:** para que uma tarefa execute as 7h30, insira o número 7 no campo **Hora** e o número 30 no campo **Minuto**.

5. Na seção **Dia do mês**, insira no campo **Valor** o intervalo que desejar para que o sistema execute a tarefa em dias específicos. Marque a opção **Todos** para a tarefa executar todos os dias do mês (irá respeitar o intervalo de semana caso não deva executar todos os dias);
6. Na seção **Mês**, marque a opção **Todos** para a tarefa executar todos os meses;
7. Na seção **Dia da semana**, insira no campo **Valor** o intervalo que desejar, indicando que a tarefa irá executar em dias específicos. Exemplo: 1-5 (segunda à sexta-feira). Para que o sistema execute a tarefa todos os dias da semana, marque a opção **Todos**;
5. Após preencher os campos, clique em **Salvar** para validar a criação da tarefa.

>[!INFO] **Dia da semana:** 
>Para a importação mensal, o sistema considerará o dia da semana em que o dia do mês selecionado ocorrer. Exemplo: caso selecione o dia 1 do mês e marcar "Todos" para o dia da semana, a tarefa ocorrerá no dia 1 de cada mês, independentemente de ser uma segunda-feira, terça-feira, etc.

Após a configuração da tarefa, ela seguirá executando automaticamente e irá identificar os clientes que possuem ligações a serem importadas e as registra no [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]], no módulo de **Plataforma VoIP**.

## Fluxo de Trabalho

```mermaid
flowchart TD
    A[Configurar Tarefa] --> B[Tarefa executa automaticamente]
    B --> C[Importar Ligações]
    C --> D[Processar Dados]
    D --> E{Atualizar Registro de Chamadas}
    E --> F{Trabalha com tarifação?}
    E --> H{Trabalha com pagamento por consumo?}
    F -- Sim --> G[Faturamento]
    F -- Não --> J[Dados Atualizados]
    H -- Não --> J[Dados Atualizados]
    H -- Sim --> I[Geração do Adicional de Telefonia]
    I --> J
    G --> J

```

## Considerações Finais
A tarefa de Importar ligações VoIP é uma ferramenta poderosa para manter o Sistema atualizado com informações precisas sobre o uso dos serviços de telefonia. Ao configurar corretamente esta rotina, as empresas podem garantir uma gestão eficiente de seus recursos de VoIP, melhorar a qualidade do atendimento ao cliente e otimizar seus processos de faturamento.

## Etiquetas
#ImportacaoVoIP #TelefoniaFixa #IntegracaoSistemas

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]
- [[integracao voip - saperx v2|Integração VoIP - SaperX v2]]
- [[integracao voip - magnus billing|Integração VoIP - Magnus Billing]]
- [[integracao voip - interede|Integração VoIP - Interede]]
- [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]]
- [[geracao do adicional de telefonia - filtros voip|Geração do Adicional de Telefonia - Filtros VoIP]]