Versões comparadas

Chave

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

...

...

...

...

...

...

...

...

...

/voz/end

Método que finaliza chamadas realizadas pela API.

...

 

 

DESCRIÇÃO

Com este método podemos finalizar uma chamada que está em andamento

ESTRUTURA DA URL

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

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 Texto de resposta da API

...

Exemplo de resposta em JSON
Bloco de código
{

...


    "api": "voz",

...


    "modulo": "finalizar-chamada",

...


    "status": "ok",

...


    "codigo": "000",

...


    "msg":

...

 {
        "callId": "af8514e1-d6d3-4c46-97fe-d48a4118aad2",
        "status": "END_CALL",
        "lastUpdate": "2025-04-03 19:36:01"
    }
}

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 finalizar uma chamada em andamento por meio da API

FinalizarChamadaEmAndamento.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.

...

 

 

...