Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Este método permite a inserção ou a atualização de recursos em um DID Directcall (Número de Telefone Virtual).

 
 


DESCRIÇÃOCom este método, é possível inserir uma rota em um Número de telefone da Directcall (DID), indicar se a chamada recebida deve ser gravada, tocar um arquivo de áudio padrão para quem liga para um número de telefone da Directcall e/ou para quem atende uma ligação, encaminhar a chamada para correio de voz, etc.
ESTRUTURA DA URLhttps://api.directcallsoft.com/did/save
VERSÃO1
MÉTODOPOST
PARÂMETROS

did 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

Bloco de código
titleExemplo de resposta em JSON
linenumberstrue
{
    "api": "did",
    "modulo": "did-save",
    "status": "ok",
    "codigo": "000",
    "msg": "Seu Dial-plain foi salvo com sucesso."
}

 

 




Como formatar a rota do seu DID
Âncora
route
route

Lista de recursos disponíveis:

  • Sound - Toca um áudio para quem liga para um número de telefone da Directcall
  • Playback - Toca um áudio para quem atende uma ligação em um número de telefone da Directcall

  • Fwd - Encaminha a chamada para um número de telefone real de qualquer operadora Fixa, Móvel ou IP, ou para um login SIP da Directcall
  • Voicemail - Encaminha a chamada para o voicemail da Directcall.
    (Mensagens registradas pelo voicemail são encaminhadas para o email configurado neste recurso).
  • Hup - Força o desligamento da chamada

 


Bloco de código
titleAção sound
linenumberstrue
{
    "sound": "3" // (Opcional) // ID do arquivo de som que se deseja tocar para quem liga para um número de telefone da Directcall.
}

NOTA: Para cadastrar um áudio e obter um ID de arquivo de som, acesse Cadastrar áudio
 

Bloco de código
titleAção voicemail
linenumberstrue
{
    "email": "[email protected]" // Endereço de e-mail para envio das mensagens registradas no voicemail da Directcall.
}


Bloco de código
titleAção fwd
linenumberstrue
{
    "phone": "551199998888", // Numero de telefone real ou login SIP fornecido pela Directcall onde o seu número de telefone virtual será atendido. O número deve conter cód. de país e cód. de área. O cód. de país do Brasil é 55. Aceita numero de telefone real de qualquer operadora Fixa, Móvel ou IP.
    "rec": true, // booleano // Indique true neste parâmetro se deseja gravar a ligação recebida.
    "wait": 10, // Tempo máximo de ring, em segundos
	"bPlayback": 000 // (Opcional) // ID do arquivo de som que se deseja tocar para quem atende uma ligação em um número de telefone da Directcall.
}


Bloco de código
titleAção hup
linenumberstrue
{
    "cause": "NORMAL_CLEARING" // causa do desligamento
}

Opções

Todas as ações podem ser opcionalmente limitadas a um período de tempo (Dia da semana e Horário), conforme exemplo:

Bloco de código
titleOpções
linenumberstrue
// Ação hup com limitação de Horário
{
    "cause": "NORMAL_CLEARING", // causa do desligamento
    "weekTime":"1111111,00:00-23:59" // Dias da semana DSTQQSS e horarios
}

 


Exemplo de uso dos recursos, considerando a opção de tocar um áudio padrão para quem liga para um número de telefone da Directcall (prioridade 1) e em seguida, um áudio padrão para quem atende:
NOTA: Para cadastrar um áudio e obter um ID de arquivo de som, acesse Cadastrar áudio 

Bloco de código
titleExemplo de rota
linenumberstrue
[
    {
        "priority": "1", // PRIORIDADE da ação
        "action": "sound",
        "data": {
            "sound": "3" // ID do arquivo de som que se deseja tocar para quem liga para um número de telefone da Directcall.
        }
    }, {
        "priority": "2",
        "action": "fwd",
        "data": {
            "phone": "554130160300",
            "wait": 10,
			"weekTime":"1111111,00:00-23:59", // Dias da semana DSTQQSS e horarios
			"bPlayback": 100 // ID do arquivo de som que se deseja tocar para quem atende uma ligação em um número de telefone da Directcall.
        }
    }, {
        "priority": "3",
        "action": "fwd",
        "data": {
            "phone": "TEDC2",
            "rec": true,
            "wait": 10
        }
    }, {
        "priority": "4",
        "action": "sound",
        "data": {
            "sound": "4"
        }
    }, {
        "priority": "5",
        "action": "voicemail",
        "data": {
            "email": "[email protected]"
        }
    }
]
 

 




 
Informações
titleValidade 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.