Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

...

...

...

...

...

...

/voz/status

Método que retorna status da chamadas realizadas pela API de voz da Directcall.

 

 

DESCRIÇÃO

Com este método podemos consultar uma chamada que

esta destino obrigatório Número de destino da chamada, formato exemplo: 554130600300 (DDI DDD NUMERO)

está em andamento

ESTRUTURA DA URL

https://api.directcallsoft.com/voz/status

VERSÃO

1

MÉTODO

GET

PARÂMETROS

origem obrigatório Número de que esta solicitando a ligação, formato exemplo: 554130600300 (DDI DDD NUMERO)

callerid obrigatório Identificação única da chamada, é obtida ao iniciar uma chamada

access_token obrigatório Chave de acesso ao método

, para

. Para saber como

obter 

obter, clique aqui

format opcional Opção de retorno da API podendo ser JSON ou XML

,

(se não informado, JSON será o padrão)

RETORNO

api Origem API que

esta

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

 

Bloco de códigolanguage

phptitle

Exemplo de resposta em JSON
linenumbers
Bloco de código
language
true
php
{
    "api": "voz",
    "modulo": "status",
    "status": "ok",
    "codigo": "000",
    "msg":
[
 {
        
{
"callId": "af8514e1-d6d3-4c46-97fe-d48a4118aad2",
        "
telefone
number":
" 55 41 3017 5726
 "554130160300",
        
"status": "
atendida
ACTIVE",
        
"
inicio
startTime": "
2013
2025-
02
04-
21 18
03T16:
28
30:
14
27",

        "
duracao
duration":
"00:00:00"
 302,
        
}
"answerState": "answered"
    
}
}

 

Observações

Os dados permanecem por 30 dias disponiveis após a data e hora da chamada, após este período deve-se usar a api de extrato.

Exemplos:

Linguagem

Descrição

Arquivo

PHP

Arquivo em PHP com exemplo de como requisitar o access_token por meio da API

RequisitarToken.php

PHP

Arquivo em PHP com exemplo de como consultar status de uma chamada em andamento via API

ConsultaStatusChamada.php

 

...

Informações

...

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.

...