Mudanças entre as edições de "API Agente"

De Nuclear Erix
Ir para navegação Ir para pesquisar
 
Linha 2: Linha 2:
  
 
A API funciona por link '''HTTP''', com parâmetros em '''GET''' ou '''POST''' e a resposta em '''JSON'''.<br>
 
A API funciona por link '''HTTP''', com parâmetros em '''GET''' ou '''POST''' e a resposta em '''JSON'''.<br>
 +
 +
'''IMPORTANTE:''' É necessário desabilitar módulo do CRM para utilizar a API do Agente.
  
 
Para cada função (command) são necessários determinados parâmetros para realizar a ação.<br>
 
Para cada função (command) são necessários determinados parâmetros para realizar a ação.<br>

Edição atual tal como às 16h16min de 2 de setembro de 2020

Introdução

A API funciona por link HTTP, com parâmetros em GET ou POST e a resposta em JSON.

IMPORTANTE: É necessário desabilitar módulo do CRM para utilizar a API do Agente.

Para cada função (command) são necessários determinados parâmetros para realizar a ação.
Requisitos por função da API do Agente:

Command Requisitos
login agent, exten (Ramal), queue (fila)
logoff agent
pause agent, [reason (motivo) opcional]
unpause agent

Requisitos

agent: login do agente (não utilizar o Nome aqui), deve ser um agente válido (criado na interface).
exten: Número do ramal, somente dígitos, deve ser um ramal válido e configurado como ramal Call Center.
queue: Nome da fila, fila também deve ser configurada como Call Center.
reason (opcional): Utilize motivos de pausa padrão (nomes repetidos), pois as pausas podem ser agrupadas por motivos e facilitar a leitura dos relatórios.
Ou utilize as pausas criadas no Nuclear. <link para acesso aos motivos de pausa do sistema>

Exemplos

Exemplos simples utilizando GET.

Login:
http://<server_IP>/api/agent.php?agent=login_agente&command=login&exten=num_ramal&queue=nome_fila

Logoff:
http://<server_IP>/api/agent.php?agent=login_agente&command=logoff

Pause:
http://<server_IP>/api/agent.php?agent=login_agente&command=pause&reason=motivo_da_pausa

Unpause:
http://<server_IP>/api/agent.php?agent=login_agente&command=unpause

Respostas

A página ira retornar code status 200 seguido dos valores success ou error.
Obs.: Somente em caso de falha no envio dos requisitos o code status será 400.

success Descrição
Login OK Login efetuado
Logoff OK Logoff Efetuado
Pause OK Pausa efetuada
Unpause OK Retirado da Pausa
error Descrição
Argument list invalid Faltam parâmetros não requisição
Agent not logged A requisição não pode ser cumprida pois o ramal não esta logado (logoff, pause e unpause)
Agent not specified POST ou GET agent não enviado
Agent not exists Agente especificado não existe
Command not specified POST ou GET command não enviado
Queue not exists Fila especificada não existe (login)
Exten not exists Ramal especificado não existe (login)
Queue Call Center false Fila não esta configurada como Call Center, não pode receber login de agente (login)
Exten Call Center false Ramal não esta configurado como Call Center, não pode logar (login)
Agent alredy paused Tentando pausar um ramal já pausado (pause)
Agent alredy available Tentando despausar um ramal disponível (unpause)