Versões comparadas

Chave

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

...

 
 
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 de que esta 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"
}

 

Exemplos:

LinguagemDescriçãoArquivo
PHPArquivo em PHP com exemplo de como requisitar o access_token por meio da APIRequisitarToken.php
PHPArquivo em PHP com exemplo de como realizar uma chamada por meio da APIEnviarPedidoChamada.php

...

,
"agendamentoId":"977dace9c8d8f7901e2becbf821f9994" 

}

 
Informações
titleValidade 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.

 

...