/voz/call
Este método permite iniciar uma chamada telefônica via REST API, a partir da linha de telefone fixo, móvel ou IP de qualquer operadora, com opção de gravação na Directcall, sem a necessidade de equipamentos.
NOTAS:
- No lado do usuário, este recurso pode ser divulgado como: ligação a partir de um clique no telefone de contatos nos cadastros e relatórios web da sua aplicação, com opção de gravação, histórico, etc.
- Chamadas gravadas podem ser ouvidas a partir de um clique no Extrato web ou a partir das REST APIs de Extrato sem a necessidade de equipamentos - Eco friendly
- Quando as linhas telefônicas não são fornecidas pela Directcall as chamadas iniciadas por estas REST APIs são tarifadas na sua conta de cliente ou de teste na Directcall, não aparecem no extrato da sua operadora atual fixa, móvel ou IP pelo fato de serem sempre chamadas recebidas, nas linhas de outras operadoras.
| DESCRIÇÃO | Com 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 URL | https://api.directcallsoft.com/voz/call | |||
| VERSÃO | 1 | |||
| MÉTODO | POST | |||
| PARÂMETROS | origem obrigatório Número de 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) 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.