/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ÇÃ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) 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.
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
|
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 |
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.