Versões comparadas

Versão Versão antiga 12 Nova versão Atual
Alterações feitas por

Leanderson Correia

Leanderson Correia

Gravado em

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.

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

 

 

DESCRIÇÃO

Com este método podemos consultar uma chamada que 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 que está 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 saber como 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 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
Bloco de código
linenumbers
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.