/voz/call

Método que permite iniciar uma chamada telefônica via API a partir de qualquer linha de telefone fixo, móvel ou IP, com opção de gravar chamada na nuvem. 

NOTAS:

  • Chamada gravada pode ser ouvida a partir de um clique no navegador web, a partir do extrato (maiores informações no Módulo - Extrato de consumo). 
  • Cada chamada será tarifada na sua conta de cliente ou de teste na Directcall, não aparecerá no extrato da sua operadora fixa, móvel ou IP (caso a Directcall não seja a sua operadora oficial), uma vez que as chamadas realizadas pelas APIs da Directcall utilizam as linhas de outras operadoras "apenas para o recebimento das chamadas completadas". 
 
 
DESCRIÇÃOCom este método, podemos realizar uma chamada de e para qualquer linha de telefone fixa, móvel ou IP, com tarifas super competitivas.
ESTRUTURA DA URLhttps://api.directcallsoft.com/voz/call
VERSÃO1
MÉTODOPOST
PARÂMETROS

origem obrigatório Número que está solicitando a ligação, formato exemplo: 554130600300 (DDI DDD NUMERO)

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

cron opcional Em caso de envio agendado, esta variável deve ser enviada no formato <dia-mes-ano-hora-minuto-segundo> "d-m-Y-H-i-s"

gravar opcional Opção de gravar a chamada, podendo conter os valores ("s" para gravar | "n" para não gravar)

NOTAS: Antes de utilizar, verifique os custos desta funcionalidade.

  • Por padrão cada ligação gravada ficará disponível por 90 dias, sendo que este prazo pode ser ampliado, mediante uma taxa adicional. 

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)

cli opcional Informa ou não o número de origem para o destinatário. Valores: "s" para informar ou "n" para não informar.

 Com CLI (?)

Esta modalidade valoriza o atendimento e o retorno das suas chamadas, com tarifas competitivas.

- Nela a Directcall GARANTE a identificação para o destinatário.

Sem CLI (?)

Esta modalidade valoriza principalmente os custos da sua operação, com tarifas super reduzidas

- Nela a Directcall NÃO GARANTE a identificação para o destinatário.

RETORNO

api Origem API que esta 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

agendamentoId ID do agendamento que é retornado quando é realizado o agendamento da chamada

Exemplo de resposta em JSON

{
   "api":"voz",
   "modulo":"chamar",
   "status":"ok",
   "codigo":"000",
   "msg":"Chamada agendada com sucesso",
"agendamentoId":"977dace9c8d8f7901e2becbf821f9994" 

}

 

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