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.