PABX/Situator

De uTech Tecnologia
Edição feita às 16h14min de 21 de setembro de 2022 por Utechnet (disc | contribs)

(dif) ← Versão anterior | ver versão atual (dif) | Versão posterior → (dif)
Ir para: navegação, pesquisa

Tabela de conteúdo


Siga a sequencia abaixo para configurar a integração so PABX uTech com Situator.

Configurando a integração do PABX uTech com Situator


A configuração de integração fica no menu GESTÃO ⇒ Configuração ⇒ Integrações ⇒ Situator.

Configuração Geral

Servidor Primário e Secundário


Situator-config-srv.png


Nestes campos serão inseridos os dados de acesso a API do Situator. DEVE ser criado ou utilizado um usuário já existente no Situator. Verificar usuário e senha na interface web do Situator, no menu Configurações ⇒ Usuários. Certifique-se de que o usuário e senha que será utilizado tenha as permissões necessárias para:


As permissões do usuário do Situator são acessadas pelo menu Configurações, aba Usuários e depois PERFIS. Por padão, o usuário faz parte do perfil Cliente da API. Edite este perfil e insira as seguintes permissões:
  • API de chamadas VoIP: Permissão para enviar eventos relacionados a chamadas VoIP
  • API de eventos: Permissão para gerar ocorrências pela API de eventos
  • Monitoramento: Permissão para acessar a página de monitoramento, cadastrar visitantes, atender ocorrências e executar ações
  • Assumir ocorrências: Permissão para assumir a responsabilidade das ocorrências em atendimentos por outros usuários
  • Todas as contas: Permissão para acessar todas as contas


Configuração Situator - Servidores
Servidor Endereço de acesso ao servidor da API do Situador.
Porta Porta de acesso ao servidor da API do Situador.
Usuário Usuário de acesso a API do Situator.
Senha Senha de acesso a API do Situator.


Utilize as configurações do Servidor Secundário caso queira enviar os mesmos eventos para outro servidor. Ou deixe em branco para não enviar.


Confioguração Geral


Situator-config-geral.png


Configuração Situator - Geral
Conta Padrão Conta padrão enviado no evento caso o PABX não encontre nenhuma conta associada.
Zona Padrão Zona padrão dos eventos enviados para o Situator. Caso em algum evento não tenha configurado sua zona, ou o evento não está cadastrado no PABX, esta será a zona enviada.
Prioridade Padrão Prioridade padrão dos eventos enviados para o Situator. Caso em algum evento não tenha configurado sua prioridade, ou o evento não está cadastrado no PABX, esta será a prioridade enviada.
Filas Selecione neste campo, quais filas do PABX fazer parte da integração com Situator.
Monitorar Ramais Indica para o PABX monitorar o registro de ramais e troncos. Toda vez que ocorrer uma transição de registrado para não registrado, o PABX uTech irá enviar um evento informando o status do ramal.




Configuração de Eventos Padrão

Situator-config-evt-def.png


Configuração Situator - Eventos
Evento Padrão Código do evento padrão, caso nenhum evento associado for encontrado.
Ramal Ativo Código do evento de Ramal Ativo.
Ramal Inativo Código do evento de Ramal Inativo.
Prioridade do Evento Prioridade dos eventos de Ramal Ativo e Ramal Inativo.
Finalizar Ocorrências para Ramal Ativo

Se habilitado, informa para o Situator fechar automaticamente ocorrência de 'Ramal Inativo ao receber um evento de Ramal Ativo.
Finalizar Ocorrência para Chamadas Abandonadas Se habilitado, envia evento para o Situator fechar uma ocorrência caso a chamada seja abandonada antes do atendimento por um dos operadores.
Enviar Evento de Autoatendimento de Ocorrências Se habilitado, envia evento informando ao Situator que a chamada foi atendida por um operador. Assim, o Situator transfere automaticamente a ocorrência para o operador que atendeu a chamada. Somente habilitar este comando caso NÃO esteja integrado via CTI. (Evento de Autoatendimento via API REST)





Configuração de Portaria Autônoma

Situator-config-ia.png


Configuração Situator - Portaria Autônoma
Assistente Virtual Habilita a integração com assistente virtual. Assistente solicita informações se a pessoa é visitante, entregador ou morador e envia estar informações no evento para o Situator.
Mensagem de Saudação Mensagem inicial de saudação para o usuário. Ex. Bem vindo, eu sou a assistente virtual do condomínio Pedro Coelho!.
Tempo Limite de Resposta Tempo, em segundos que a assistente virtual irá aguardar pela resposta do usuário.
Tempo Limite de Resposta de Nome Tempo, em segundos que a assistente virtual irá aguardar pela resposta do NOME usuário.




Configuração de Contas


No menu contas, deve-se adicionar todas as contas existentes no Situator.

Situator-accounts-list.png


Situator-accounts-add.png


Configuração Situator - Adicionando Contas
Estado da Conta Valor numérico da conta.
Conta Valor numérico da conta.
Descrição Descrição da conta.
Endereço Endereço físico da conta.







Configuração de Zonas


No menu zonas.

Situator-zones-list.png


Situator-zone-add.png


Configuração Situator - Adicionando Zonas
Conta Conta pré-configurada.
Zona Valor numérico da zona.
Descrição Descrição da zona.







Configuração de Eventos


No menu Eventos.

Situator-evts-list.png


Situator-evts-add.png


Configuração Situator - Adicionando Eventos
Evento Código numérico do evento.
Descrição Descrição do evento.
Número Identidade da chamada recebida para gerar este evento (Número do chamador - NA).
Zona Zona associada ao evento.
Prioridade Prioridade do evento.
Agrupar Eventos Indica para o Situator agrupar eventos iguais.
Portaria Autônoma Habilita portaria autônoma.










Importando Eventos

Tutorial de como importar eventos do Situator no PABX.


Inserindo Usuário de Callback


Para utilização da opção click-to-call, é necessário a configuração de um usuário e senha.

  • Na interface web do PABX uTech, acesse o menu APLICAÇÕES ⇒ Callback. Clique em Adicionar, e insira um usuário e senha conforme abaixo:
Situator-config-c2c.png



Inserindo um Usuário CTI


Na interface do web do PABX uTech, acesse o menu CTI (menu APLICAÇÕES ⇒ CTI) e crie um usuário conforme abaixo:

Situator-config-ctiuser.png


  • Usuário: Selecione um usuário/ramal do PABX. Este ramal será utilizado somente para a integração com Situator e NÃO deve ser associado a mais nenhum serviço do PABX (URA, Filas, etc...)
  • Senha: Defina uma senha de acesso.
  • Permissão: Defina a permissão como OPERADOR.
  • Demais campos não precisam ser alterados.



Configurando a integração no Situator


Para configuar a integração com PABX uTech no Situator, acesse o menu Configurações ⇒ Integrações ⇒ COMUNICAÇÃO'. Edite o campo Telefonia, Conforme imagem abaixo:

Situator-config-telefonia0.png


Situator-config-telefonia1.png


Configuração do Situator
Tipo Selecione uTech.
Url Insira o endereço de acesso ao PABX uTech no formato http://IP_DO_PABX/.
  • Exemplo: 
http://10.0.0.1/
Login Usuário de acesso à função de callback (Ver Inserindo Usuário de Callback). A mesma configurado no PABX uTech (Em APLICAÇÕES ⇒ Callback).
Senha Senha de acesso à função de callback (Ver Inserindo Usuário de Callback). A mesma configurado no PABX uTech (Em APLICAÇÕES ⇒ Callback).
Atendimento Automático Define se a integração com Situator terá atendimento automático de ocorrências.
  • Desativado: Atendimento automático desativado.
  • Da Ocorrência: Atendimento automático das ocorrências.
  • Da Ligação VoIP: Atendimento automático das ligações VoIPs.
Porta Socket Porta de acesso ao protocolo CTI do PABX uTech. É definido no configurado no pabx uTech, menu APLICAÇÕES ⇒ CTI. PADRÃO 3000.
Login Socket Usuário de acesso ao protocolo CTI do PABX uTech (DEVE ser um usuário com permissão de operador) Ver Inserindo Usuário CTI no pabx uTech, menu APLICAÇÕES ⇒ CTI.
Senha Socket Senha de acesso ao protocolo CTI do PABX uTech. Senha do usuário configurado no pabx uTech. Ver Inserindo Usuário CTI no pabx uTech, menu APLICAÇÕES ⇒ CTI.


Formato dos eventos enviados


Via Webhook


O PABX envia eventos ao Situator, quando receber uma chamada, em uma fila de atendimento e que o número de origem case com um evento configurado no menu GESTÃO ⇒ Configuração ⇒ Integrações ⇒ Situator (Eventos).

Parâmetros enviados para o Situator
callId Id/Identificação única da chamada associada ao evento gerado.
accountCode Conta referente ao evento em questão. Campo alfa-numérico configurado ao adicionar uma configuração de cponta no PABX.
zoneCode Zona do evento. Campo alfa-numérico configurado ao adicionar uma configuração de zona no PABX.
eventCode Código do evento. Campo numérico configurado ao adicionar uma configuração de evento no PABX.
priority Prioridade do evento. Valor numérico configurado ao adicionar uma configuração de evento no PABX.
join Indica para o Situator agrupar os eventos iguais.
  • true: Agrupar.
  • false: Não agrupar.
  • Exemplo de evento enviado: 
{
  'callId': CALLID,
  'accountCode': ACCOUNT,
  'zoneCode': ZONE,
  'eventCode': EVENT,
  'priority': PRIORITY,
  'join':JOIN 
}



{
  'callId': 747d414e-d976-4e2a-9eb7-2e8d39c32955,
  'accountCode': 01,
  'zoneCode': 001,
  'eventCode': 2000,
  'priority': 3,
  'join':false
}

Via CTI

Para cada chamada realizada ou recebida pelo PABX uTech, o mesmo irá enviar eventos de chamadas para todos os usuário CTI conectados ao PABX (Como Operador).
Principais eventos relacionados:

  • De chamada: * De gravação: EVT_CALL. Evento informando novo status de chamada.
  • De gravação: EVT_REC. Evento informando nova gravação disponível.
  • Documentações de todos os eventos e comandos do protocolo CTI: Protocolo CTI uTech


Exemplo de evento de chamada: 

<< CALL CALLID:30303045 STATE:initiated
<< CALL CALLID:30303045 STATE:originated CALLING:2001 CALLED:2000
<< CALL CALLID:30303045 STATE:delivered CALLING:2001 CALLED:2000
<< CALL CALLID:30303045 STATE:established CALLING:2001 CALLED:2000
<< CALL CALLID:30303045 STATE:cleared CAUSE:48



Exemplo de evento de gravação:

REC CALLID:30303045 RECID:1234567 URL:https://pabx.dominio.com.br:8888/storage/14092020/3000_100_410000a_16462_c810000a_26944_134908.wav\r\n\r\n


Se o campo Endereço Público (Menu GESTÃO ⇒ Configuração ⇒ Integrações, aba Geral estiver configurado, o campo recordingUrl será enviado com o o prefixo Endereço Público configurado. Como mostrado no exemplo abaixo :
  • "URL":"https:\/\/test.com\/storage\/13102020\/2001_656_40a_104_c8000a_140_1622.wav"


Obtida de "https://wiki.utech.com.br/wiki/index.php?title=PABX/Situator&oldid=9400"
Ferramentas pessoais
Espaços nominais

Variantes
Visualizações
Ações
Navegação
Ferramentas