Painel do Agente – Dial

Através da API Dial um sistema remoto pode solicitar ao AiOAgent (Painel do Agente) que faça uma chamada de voz ativa, ou seja, inicie a discagem para um número de telefone especifico.

Esta solicitação deve ser feita através do método POST e os dados devem ser enviados no corpo da solicitação.

Parâmetros de Chamada:

Request
Elemento Atributo Tipo Tamanho Descrição Req.
uid Alfanumérico 32 Código de Idenditifacação Sim
src Numérico 5 Ramal Sim
dst Numérico 10-11 Telefone Sim
sec Numérico Duração em segundos Não
ring Numérico 2 Duração em segundos Não
name Texto 100 Nome do Cliente Não
mail Texto 100 E-mail do Cliente Não
tax Numérico 20 CPF / CNPJ Não
cod Alfanúmerico 100 Código do Cliente Não
order Alfanúmerico 100 Número de Pedido Não
field01 a field20 Texto 100 Campo livre: [chave:valor] Não
Url
 

http://servidor/api/dial/?

 

Exemplo:

{“uid”:”001″,”src”:”20001″,”dst”:”1141992276″,”sec”:0,”ring”:30,”info”:{“Id”:”1″,”name”:”Sylvio Jollenbeck”,”tax”:null,”mail”:sylvio.jollenbeck@hosannatecnologia.com.br,”cod”:null,”order”:null},”extra”:{“Veiculo”:null,”Placa”:null,”Status”:null,”URL”:null}}

 

Observações:

  1. UID (Código de Identificação da Integração) – Requerido para troca de dados entre API;

 

  1. SRC (Número do Ramal) – Requerido para estabelecer a primeira perna da chamada de voz com o ramal do NetPBX;

 

  1. DST (Número do Telefone) – Requerido para estabelecer a segunda perna da chamada de voz com o cliente;

 

  1. SEC (Limite de Duração em Segundos) – Não requerido, porém a duração da chamada é controlada através deste elemento, o valor 0 (zero) não limitará a duração da chamada em curso, qualquer valor superior a 0 (zero) limitará a duração da chamada, ou seja, a chamada será desconectada automaticamente após o tempo indicado;

 

  1. RING (Limite de tempo em Segundos) – Não requerido, porém se definido, limitará a duração do status “discando” de acordo com o valor especificado.

 

  1. NAME, MAIL, TAX, COD, ORDER, Não requerido, porém se definidos, esses campos serão exibidos no Painel do Agente (AiOAgent);

 

  1. FIELD01 a FIELD20 – Não requerido, porém se definidos, esses campos serão exibidos no Painel do Agente (AiOAgent)

 

  1. RequestID – para toda solicitação de Dial será gerado um requestID, através desse será possível consultar o status da chamada e obter demais campos e variáveis da mesma.

 

Resposta de Chamada:

Response
Código                                                     Descrição
200 RETURN_MSG_OK
400 RETURN_MSG_BAD_REQUEST
403 RETURN_MSG_FORBIDDEN
404 RETURN_MSG_NOT_FOUND
405 RETURN_MSG_METHOD_NOT_ALLOWED
406 RETURN_MSG_NOT_ACCEPTABLE
409 RETURN_MSG_CONFLICT
420 RETURN_MSG_BAD_EXTENSION
421 RETURN_MSG_EXTENSION_REQUIRED
Exemplo
 

{“RequestId“:1,”Request”:{“uid”:{“number”:”001″,”status”:200},”ramal”:{“number”:”20001″,”status”:200},”telefone”:{“number”:”1141992276″,”status”:200}}}

 

 

CompartilheShare on FacebookTweet about this on TwitterShare on LinkedIn

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *