Relatório de Chamadas DID - CDR

Status: Atualizado via Análise de Código (v2.0)

Este Ponto de Acesso fornece a listagem detalhada do CDR DID (Relatório de Ligações DID - Entrantes).

Endereço de Chamada da API

GET /api/cdrDid/API_TOKEN/API_KEY(/id_cliente)

Comportamento por Nível de Acesso

• Nível Master ou Revenda: Pode especificar o id_cliente como último parâmetro da URL ou via parâmetro id_record.
• Nível Assinante: Não é necessário informar o ID; a API retornará automaticamente os dados do assinante autenticado.

---

Parâmetros de Consulta (Query Strings)

Além dos parâmetros de data e paginação, novos filtros de busca foram implementados:

Parâmetro	Tipo	Descrição
date_ini	Date	Data inicial (padrão: data atual) AAAA-MM-DD
date_end	Date	Data final (padrão: data atual) AAAA-MM-DD
time_ini	Time	Hora inicial (padrão: 00:00:00)
time_end	Time	Hora final (padrão: 23:59:59)
start	Int	Offset (pular X registros)
limit	Int	Limite de registros por página
source	String	(Novo) Filtra pelo número de origem (Busca parcial)
destination	String	(Novo) Filtra pelo destino limpo (Busca parcial)
extension	Int	(Novo) Filtra pelo ID do Ramal (device_id)
id_record	Int	ID do Cliente (alternativa ao parâmetro de URL)

---

Exemplo de Chamada Atualizada

curl -X GET 'https://call.voipper.com.br/api/cdrDid/TOKEN/KEY?source=119&limit=10'

---

Estrutura de Resposta (JSON)

O objeto de retorno foi expandido com informações técnicas adicionais.

Exemplo de Retorno

{
   "error": 0,
   "reason": "OK",
   "total_records": 150,
   "total_time": 40898,
   "total_time_text": "681 min 38 seg",
   "total_value": "0,00000",
   "total_value_connection": "0,00000",
   "limit": 10,
   "offset": 0,
   "records": 1,
   "data": [
      {
         "id": 12345,
         "customer_id": 999,
         "calldate": "2026-03-02 11:41:12",
         "clid": "DID: 1140000000 => 3090 <1140000000>",
         "source": "1140000000",
         "destination": "1140000000",
         "region": "Sao Paulo",
         "type": "c",
         "duration": "479",
         "duration2": "7 min 59 seg",
         "total_price": "0,00000",
         "connection_price": "0,00000",
         "price_per_minute": "0,00000",
         "prefix": "00000",
         "source_ip": "189.X.X.X",
         "useragent": "Plataforma IP",
         "disposition": "1",
         "did_id": 45,
         "device_id": 1020
      }
   ]
}

Descrição dos Novos Campos no data[]

• id: Identificador único do registro de chamada.
• customer_id: ID do cliente associado à chamada.
• did_id: ID interno do número DID (disponível para Master e Revenda).
• device_id: ID do ramal que recebeu a chamada.

---

Tabela de Status de Chamada (disposition)

Valor	Descrição
0	Cancelado
1	Atendido
2	Ocupado
3	Não Atendido
4	Indisponível
5	Congestionado
X	Desconhecido

---