Histórico da Página

...

Este método lista as chamadas realizadas ou as recebidas em um número de telefone Directcall, permite aplicar filtros no extrato de uso das APIs Directcall. Lista o link para o áudio de cada chamada gravada, quando se aplica.

DESCRIÇÃO

Com este método, é possível fazer a listagem do extrato de consumo e gravações.
Nota: Na contratação padrão, o arquivo de áudio de cada ligação gravada ficará disponível por 90 dias, assim como os detalhes de cada ligação.

ESTRUTURA DA URL

https://api.directcallsoft.com/extrato/list

VERSÃO

1

MÉTODO

POST

PARÂMETROS

dataInicial obrigatório Data de início de pesquisa no formato "YmdHis"

dataFinal obrigatório Data final de pesquisa no formato "YmdHis"

mostrarPlayer opcional Mostra código do player em flash (s = Sim | n = Não)

numeroOrigem opcional Opção de filtro com o número de origem

numeroDestino opcional Opção de filtro com o número de destino

access_token obrigatório Chave de acesso ao método. Para saber como obter, clique aqui

formato opcional Opção de retorno da API, podendo ser JSON ou XML (se não informado, JSON será o padrão)

callerid opcional Código fornecido ao realizar uma chamada, código único por chamada

pagina opcional Número da página (se omitido será mostrada a primeira página)

getAllPins opcional Opção para listar todos os Produtos do cliente, essa funcionalidade somente funcionará caso o usuário seja um administrador conta (true, false) por default o valor será false

tipoFiltro opcional Tipo de filtro. Se omitido, listará todas as chamadas realizadas com 4 opções:
1 - chamadas realizadas
2 - chamadas recebidas e atendidas
3 - chamadas recebidas e não atendidas
4 - chamadas recebidas e atendidas e recebidas e não atendidas.

campos['search'] opcional retorna uma lista com os campos personalizados salvos na chamada

NOTA: A listagem de chamadas recebidas e não atendidas é uma funcionalidade opcional que, caso não tenha sido contratada na DirectCall, aparecerá a seguinte mensagem para o usuário de API: Para habilitar este recurso entre em contato com [email protected].

RETORNO

api Origem API que está sendo usada

modulo Módulo que está sendo chamado

status Mensagem de status

codigo Código de retorno - Clique aqui para listar os códigos e suas descrições

msg Array de resposta da API

paginas Quantidade de páginas

Bloco de código

title	Exemplo de resposta em JSON
linenumbers	true

{
   "api":"extrato",
   "modulo":"extrato",
   "status":"ok",
   "codigo":"000",
   "msg":[
      {
         "callerid": XXXXXXXXXX,
         "cliente":"SIGNALLINK INFORMATICA LTDA",
         "servico":"Directcall Software Web",
         "login":"XXXXX", // Número do DID, do Número telefônico contratado.   
         "password":"XXXXX",
         "tipo":"SMS",
         "origem_numero":"554130175726",
         "origem_localidade":"CURITIBA",
         "origem_descricao":"CURITIBA",
         "destino_numero":"554199504077",
         "destino_localidade":"CELULAR - VC1 - REGIAO 41",
         "destino_descricao":"MÓVEL BR COM CLI",
         "data_inicio":"2013-02-20 17:53:54",
         "data_fim":"2013-02-20 17:53:54",
         "duracao":"60",
         "custo":"0.1700",
         "gravacao_link": Mostrará "null" ou o "link para o áudio da chamada gravada",
		 "tipo_rota": "CEL" 
      }
   ],
  "chamadas": 3,
  "paginas": 1,
  "custo": 0
 }

Informações

title	Validade dos tokens: Os tokens de acesso têm uma validade limitada, por isso convém que o sistema criado tenha em conta estes timings para que possa desenvolver rotinas de requisação de novos tokens.

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 37

Nova versão Atual

Chave