Relatorio de Notas de Atendimento - URA

Endereço de Chamada da API

/api/cdrIvr/API_TOKEN/API_KEY/id_cliente


Este Ponto de Acesso irá fornecer uma listagem das Notas de Avaliação de Atendimento fornecidas pelos clientes nas ligações Entrantes - DID
Para consumir esses dados, informar o ID do Cliente é obrigatório. Você poderá informar na query http o parâmetro id_record para filtrar por uma URA em especifico.

Para nosso exemplo, iremos deduzir que o endereço do servidor será sip.nextbilling.com.br. Nesse caso, o endereço da API seria:

Endereço da API exemplo


https://sip.nextbilling.com.br/api/cdrIvr/API_TOKEN/API_KEY/id_cliente
 ou
https://sip.nextbilling.com.br/api/cdrIvr/API_TOKEN/API_KEY/id_cliente?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=1

Parâmetros HTTP:

  • date_ini: Data Inicial
  • time_ini: Hora Inicial
  • date_end: Data Final
  • time_end: Hora Final
  • start: Exibir registros a partir dessa contagem
  • limit: Limite de registros a ser retornados pela chamada
  • id_record: Opcional: id da URA a ser filtrado

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:

Exemplo de chamada a API utilizando cURL
$ curl -X GET 'https://sip.nextbilling.com.br/api/cdrIvr/7cb40d54-4ebf-55a6-875a-5f57234e97cc-9990/b12c87a7-6dd6-5f99-9b47-c7c3be66fe73-8629/3?id_record=366'

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

Retorno JSON
{
   "error":0,
   "reason":"OK",
   "limit":1,
   "offset":0,
   "records":1,
   "data":[
      {
		"ivr_id": 3,
		"ivr_name": "URA DE TESTE - SUPORTE"
         "calldate":"2018-03-14 11:41:12",
         "callerid":"2199000000",
         "type":"TIPO",
         "data1":"INFO1",
         "data2":"INFO2",
         "data3":"INFO3",
         "dtmf":"4"
      }
   ]
}
CampoDescrição
error1 em caso de erro
reasonDescrição caso tenha ocorrido algum erro
recordsTotal de registrados retornados nessa chamada
data.ivr_idID da Ura
data.ivr_nameNome da Ura
data.typeTipo da Informação
data.data1Informações Adicionais
data.data2Informações Adicionais
data.data3Informações Adicionais
data.dtmf

Dígito pressionado pelo Cliente na avaliação