/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 parrir 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ÇÃO

Com 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 URL

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

VERSÃO

1

MÉTODO

POST

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

Exemplo de resposta em JSON
{ "api":"voz", "modulo":"chamar", "status":"ok", "codigo":"000", "msg":"Chamada agendada com sucesso" }

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 realizar uma chamada por meio da API	EnviarPedidoChamada.php