Ir para o final dos metadados
Ir para o início dos metadados

Você está vendo a versão antiga do conteúdo. Ver a versão atual.

Comparar com o atual Exibir histórico da versão

« Anterior Versão 16 Atual »

/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 está em andamento

ESTRUTURA DA URL

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

VERSÃO

1

MÉTODO

GET

PARÂMETROS

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

Exemplo de resposta em JSON
{
    "api": "voz",
    "modulo": "status",
    "status": "ok",
    "codigo": "000",
    "msg": {
        "callId": "af8514e1-d6d3-4c46-97fe-d48a4118aad2",
        "number": "554130160300",
        "status": "ACTIVE",
        "startTime": "2025-04-03T16:30:27",
        "duration": 302,
        "answerState": "answered"
    }
}

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

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.

  • Sem rótulos