Envio de Evento de Desligamento

Esta integração consiste em enviar um evento via api toda vez que uma chamada for desligada, atendida ou não. Esta integração pode ser realizada via banco de dados ou via http (o integrador deverá prover a url para busca).

Formato

Para realizar esta integração, é necessário o integrador prover uma url que receba um ou mais parâmetros via requisição HTTP GET.

Exemplo:

http://servidor.integrador.lan/api_integracao/desligamento?ramal=3001&numero=4730339292&id=5cafdebe4e78588628681c0fa5fda8a410ccd966&datahora=2015-12-31%2023%3A59%3A59&status=call_ended&tempo=62
ou
http://servidor.integrador.lan/api_integracao/desligamento?ramal=3001&numero=4730339292&status=call_ended

A requisição deve retornar a string ‘ok’

Na interface de configuração, a URL deve ser configurada com os valores chaves a serem substuidos. ex:

http://servidor.integrador.lan/api_integracao/desligamento?ramal=RAMAL&numero=NUMERO&id=ID&datahora=DATAHORA&status=STATUS&tempo=TEMPO

Parâmetros

Como parâmetros do evento, podem ser usados os seguintes campos:

  • RAMAL: Ramal de destino da chamada
  • NUMERO: Número de origem da chamada
  • ID: Identificador único da chamada
  • DATAHORA: Data e hora da chamada, no formato ‘2015-12-31 23:59:59’
  • STATUS: Status do desligamento, valores possíveis:
    • call_ended: Chamada foi atendida e desligada
    • exten_busy: Ramal ocupado
    • exten_noanswer: Ramal não atendeu a chamada
    • number_cancel: Número desligou a chamada antes de o ramal atender
    • exten_not_present: Ramal não existe ou não está conectado
  • TEMPO: Tempo de conversação da chamada, em segundos

Obs.: Não é necessário usar todos os parâmetros.

Banco de Dados

Para realizar esta integração, é necessário criar uma tabela ou stored procedure que receba um ou mais parâmetros do evento.

Exemplo:

INSERT INTO `teste_api_desligamento` (`ramal`, `numero`, `id_chamada`, `datahora`, `status`, `tempo`) VALUES ("3001", "4730339292", "5cafdebe4e78588628681c0fa5fda8a410ccd966", "2015-12-31 23:59:59", "call_ended", 62);
ou
INSERT INTO `teste_api_desligamento` (`ramal`, `numero`, `status`) VALUES ("3001", "4730339292", "call_ended");

Exemplo de formato da tabela:

CREATE TABLE `teste_api_atendimento` (
  `id_chamada` VARCHAR(40) NOT NULL,
  `ramal` VARCHAR(80) NOT NULL,
  `numero` VARCHAR(80) NOT NULL,
  `datahora` DATETIME DEFAULT NULL,
  `status` VARCHAR(80) NOT NULL,
  `tempo` INTEGER NOT NULL
);