API ShowPeer da VTCall permite consultar chamadas em andamento no PABX. Com ela, é possível integrar sistemas externos, dashboards ou ferramentas de monitoramento para acompanhar ligações ativas em tempo real.
Graças às APIs desenvolvidas pela VTCall, é possível integrar os mais diversos tipos de aplicativos e sistemas utilizando diferentes linguagens de programação disponíveis no mercado.
Por motivo de segurança, todas as requisições devem conter o cabeçalho access_token para que sejam aceitas.
Header obrigatório:
access_token: Chave de identificação de permissão de acesso à plataforma.📍 Onde obter o Token:
No Gestor VTCall acesse:
Ajustes > Avançadas > Segurança (Token)
URL
https://SERVIDOR.vtcall.com.br/API/showpeer
Método
GET
Content-Type
application/json
Ramal que será consultado na API.
Exemplo:
ramal=1234
💡 Observação:
Caso o parâmetro não seja definido, a API retornará todas as chamadas em andamento.
A consulta aos relatórios foi executada com sucesso.
Parâmetros incorretos ou não encontrados. Consulte a mensagem de erro retornada pela API para mais detalhes.
O token da API está incorreto ou ausente.
Erro interno inesperado na API.
Tente novamente em alguns minutos e, se o problema persistir, contate o suporte.
Ao efetuar a consulta, a API retorna as seguintes informações:
| Campo | Descrição |
|---|---|
linkdid |
Identificador da ligação |
src |
Número de origem |
dst |
Número de destino |
from_did |
Linha pela qual entrou a chamada |
start |
Data e horário em que iniciou a ligação |
answer |
Data e hora no momento em que a chamada foi atendida |
GET http://www4.vtcall.com.br/API/showpeer?ramal=1234
Header
access_token: 7sd6g8f7sdg78fsdg7fsdggfdgfg4564
Status
200 Success
Body
[
{
"linkdid": "45654585.65",
"src": "1234",
"dst": "85698745",
"from_did": "6317",
"start": "2017-07-25 15:30:00",
"answer": "2017-07-25 15:30:50"
}
]