Suporte e tutoriais

Central de Ajuda

Encontre manuais, guias e perguntas frequentes sobre os produtos Vono. Tudo o que você precisa para usar nossas soluções, em um só lugar.

API PABX - Relatório de Chamadas - CDR

✅Endereço de Chamada da API

/api/cdr/API_TOKEN/API_KEY(/id_assinante)

Este Ponto de Acesso irá fornecer uma listagem do CDR (Relatório de Ligações). Se estiver utilizando Tokens de Acesso do Nível Master ou Nível Revenda, poderá especificar o ID DO CLIENTE como último parâmetro da URL para obter o CDR de um Cliente de ID especifico.
Caso essa API seja chamada utilizando os Tokens de Acesso do Nível Assinante, não é necessário informar o ID e será retornado o CDR do Assinante em questão.

Para nosso exemplo, iremos deduzir que o endereço do servidor será vono.me. Nesse caso, o endereço da API seria:

Endereço da API exemplo:

https://vono.me/api/cdr/API_TOKEN/API_KEY

OU

https://vono.me/api/cdr/API_TOKEN/API_KEY?date_ini=2015-03-01&date_end=2015-03-30&start=0&limit=100&time_ini=08:00:00&time_end=23:50:00&id_record=3

Parâmetros:

  • date_ini: Data Inicial
  • time_ini: Hora Inicial
  • date_end: Data Final
  • time_end: Hora Final
  • start: Exibir registros a partir dessa contagem
  • limit: Limitar de registros a ser retornados pela chamada
  • id_record: Opcional: Id do Assinante quando aplicável

❕ Caso tenha duvidas de como pegar o domínio, APITOKEN e APIKEY para preencher clique abaixo.
✦ Como pegar o dominio »
✦ Como pegar APITOKEN e APIKEY »

A chamada para obter os dados da consulta, é realizado utilizando um HTTP GET para o endereço de consumo da API. Um exemplo de chamada a essa API seria:

$ curl -X GET 'https://vono.me/api/cdr/7cb40d54-4ebf-55a6-875a-5f57234e97cc-9990/b12c87a7

Utilizando essa chamada, você obteria o retorno em JSON semelhante a saída a seguir:

{
	"error": 0,
	"reason": "OK",
	"total_records": 1,
	"total_time": 540,
	"total_time_text": "9 min 00 seg",
	"total_value": "2,10000",
	"total_reseller_time": 540,
	"total_reseller_time_text": "9 min 00 seg",
	"total_reseller_value": "4,40000",
	"total_cost_time": 540,
	"total_cost_time_text": "9 min 00 seg",
	"total_cost_value": "0,00000",
	"total_profit_on_rev": "4,40000",
	"total_profit_on_ass": "2,10000",
	"limit": 100,
	"offset": 0,
	"records": 1,
	"data": [
		{
			"customer_id": 4,
			"calldate": "2023-01-31 18:03:52",
			"clid": "teste10next <teste10next>",
			"source": "teste10next",
			"destination": "55xxxxxxxxxxx",
			"region": "Brasil M\u00f3vel - RJ 02",
			"type": "c",
			"type2": "movel_ldn",
			"real_duration": "10",
			"duration": "30",
			"duration2": "0 min 30 seg",
			"total_price": "0,30000",
			"price_per_minute": "0,60000",
			"reseller_duration": "30",
			"reseller_duration2": "0 min 30 seg",
			"reseller_total_price": "0,25000",
			"reseller_price_per_minute": "0,50000",
			"cost_duration": "30",
			"cost_duration2": "0 min 30 seg",
			"cost_total_price": "0,00000",
			"cost_price_per_minute": "0,00000",
			"profit_on_customer": "0,30000",
			"profit_on_reseller": "0,25000",
			"codec": "g729->g729",
			"prefix": "55219",
			"source_ip": "179.236.34.165",
			"useragent": "PolycomSoundPointIP-SPIP_550-UA\/4.0.13.1445"
		}
	]
}
Campo Descrição
error 1 em caso de erro
reason Descrição caso tenha ocorrido algum erro
total_records Total de Registros encontrados na pesquisa sem a paginação solicitada
total_time Tempo total das Ligações
total_value Valor total das Ligações
total_reseller_time Tempo tempo das Ligações para a Revenda
total_reseller_value Valor total das Ligações para a Revenda
total_cost_time Tempo total de custo para o Master
total_cost_value Valor total de Custo para o Master
total_profit_on_rev Valor total de Lucro sobre a Revenda
total_profit_on_ass Valor total de Lucro sobre o Assinante
records Total de registrados retornados nessa chamada
data.customer_id ID do Assinante
data.type Tipo da Ligação: f – fixo, c – móvel, i – ddi
data.type2 Tipo de Região da Ligação
data.real_duration Tempo real da Ligação sem a Tarifação aplicada
data.duration Tempo da Ligação com a Tarifação aplicada
data.total_price Valor total da Ligação para o Assinante
data.price_per_minute Valor por Minuto da Ligação
data.reseller_duration Tempo da Ligação para a Revenda
data.reseller_total_price Valor total da Ligação para a Revenda
data.reseller_price_per_minute Valor por Minuto para a Revenda
data.cost_duration Tempo Total de Custo para o Master
data.cost_total_price Valor Total de Custo para o Master
data.cost_price_per_minute Valor por Minuto para o Master
data.profit_on_customer Valor de Lucro sobre o Assinante
data.profit_on_reseller Valor de Lucro sobre a Revenda

Conheça o produto relacionado:

Ver solução Vono

Não encontrou o que procurava?

Nossa equipe de atendimento está pronta para ajudar você com dúvidas sobre produtos, configurações e suporte técnico.