N|Solid

# Service - Agile

# Descrição

Este módulo é utilizado na integração de seu Asterisk/SNEP com alguma API RestFul de terceiros para consultas e redirecionamento de chamadas dinamicamente.

Através de uma Regra de Negócio (SNEP) ou de uma extension do DialPlan (Asterisk) você pode chamar o Service Agile para que ele consulte uma API externa e encaminhe a ligação conforme esta interação.

# Diagrama de Operação

N|Solid

# Operação da API

Para fazer a consulta em sua API RestFul o Agile irá fazer uma requisição seguindo os seguintes padrões:

  • HTTP Request
  • Método POST
  • Payload (body) contendo:
{ 
    callerid: INT, 
    user_input: INT 
}
1
2
3
4
  • Exemplo:
{
    callerid: "4839548000", 
    user_input: "1234"
}
1
2
3
4

# Resposta esperada pela API

O Agile espera como resposta um JSON no payload (body) no seguinte formato:

{
    return: INT(opcional), 
    desc: STRING(opcional)
}
1
2
3
4

Onde:

  • return: é um código inteiro que represente uma extension do dialplan (Asterisk) ou destino de Regra de Negócio (SNEP) para qual o Agile irá enviar a ligação. Caso ela não seja informada o Agile irá ignorar a ação de encaminhar a ligação e continuará a execução do dialplan normalmente.
  • desc: uma string qualquer que será utilizada para mudar o CALLERID(name) da chamada. Ela será vista no display do Softphone ou Telefone IP do Atendente. Caso ela não seja enviada ou esteja em branco (NULL), será mantido o callerid original da ligação