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 fixo, móvel ou IP, com opção de gravação e 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 está solicitando a ligação, formato exemplo: 554130600300 (DDI DDD NUMERO)
Ou ip4130600300 (ip DDD NUMERO), sendo que este segundo formato permite encaminhar a chamada apenas para um número virtual reconhecido dentro da rede SIP da Directcall, do PBX IP de um cliente, do seu Media Gateway ou ATA.

destino obrigatório Número de destino da chamada, formato exemplo: 554130600300 (DDI DDD NUMERO)
Ou ip4130600300 (ip DDD NUMERO), sendo que este segundo formato permite encaminhar a chamada apenas para um número virtual reconhecido dentro da rede SIP da Directcall, do PBX IP de um cliente, do seu Media Gateway ou ATA.

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.

inverter_discagem opcional Chama primeiramente a origem e depois o destino, Valores: "s" para inverter "n" para não inverter padrão é "n"

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


Exemplo de resposta em JSON

{
   "api":"voz",
   "modulo":"chamar",
   "status":"ok",
   "codigo":"000",
   "msg":"Completando a sua liga\u00e7\u00e3o, por favor aguarde!"
   "callerid":"6f7c10f9-06de-4bee-8eba-7fe141e5b635" 

}



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

...