/did/save
Método que faz a inserção ou atualização de uma rota de um DID.
| DESCRIÇÃO | Com este método é possível inserir uma rota em um DID (Numero 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 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 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 ações possí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 da mensagem gravada.
}
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 uso de rota: 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": "554191428310",
"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.