/did/save
Este método permite a inserção ou a atualização de recursos em um DID Directcall (Numero de Telefone Virtual que pode ser habilitado nos principais centros de negócios do Brasil ou do exterior no interesse de, por exemplo, facilitar que falem com o seu negócio a partir de "ligação local" em cidades ou países distantes.
| DESCRIÇÃO | Com este método é possível inserir uma rota em um DID Directcall (Numero de Telefone Virtual). |
| ESTRUTURA DA URL | https://api.directcallsoft.com/did/save |
| VERSÃO | 1 |
| MÉTODO | POST |
| PARÂMETROS | DIS_ID obrigatório ID do DID que terá sua rota registrada ou atualizada data obrigatório Dialplan em formato JSON clique aqui para ver como formatar seu dialplan access_token obrigatório Chave de acesso ao método, para saber como obter clique aqui formato opcional Opção de retorno da API podendo ser JSON ou XML, se não informado JSON será o padrão |
| RETORNO | api Nome da 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 Array de resposta da API paginas Quantidade de páginas Exemplo de resposta em JSON {
"api": "did",
"modulo": "did-save",
"status": "ok",
"codigo": "000",
"msg": "Seu Dial-plain foi salvo com sucesso."
}
|
| Como formatar a rota do seu DID |
|---|
Lista de recursos disponíveis:
Ação sound {
"sound": "3" // ID do arquivo de som no servidor.
}
Ação voicemail {
"email": "[email protected]" // Endereço de e-mail para envio das mensagens registradas no voicemail da Directcall.
}
Ação fwd {
"phone": "554199998888", // Numero de telefone ou login para encaminhamento
"rec": true, // Gravar? booleano
"wait": 10 // Tempo máximo de ring, em segundos
}
Ação hup {
"cause": "NORMAL_CLEARING" // causa do desligamento
}
Exemplo de uso dos recursos: Exemplo de rota [
{
"DP_PRI": "1", // PRIORIDADE da ação
"DP_ACTION": "sound",
"DP_DATA": {
"sound": "3"
}
}, {
"DP_PRI": "2",
"DP_ACTION": "fwd",
"DP_DATA": {
"phone": "554130160300",
"wait": 10
}
}, {
"DP_PRI": "3",
"DP_ACTION": "fwd",
"DP_DATA": {
"phone": "TEDC2",
"rec": true,
"wait": 10
}
}, {
"DP_PRI": "4",
"DP_ACTION": "sound",
"DP_DATA": {
"sound": "4"
}
}, {
"DP_PRI": "5",
"DP_ACTION": "voicemail",
"DP_DATA": {
"email": "[email protected]"
}
}
]
|
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.