PABX/Situator
Tabela de conteúdo |
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
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:
- Realizar login (/api/login).
- Criar ocorrências (/api/remote-events)
- Atender automaticamente ocorrências (/api/voip/events]). Ver configurações necessárias do ramal do usuário no Situator!
- Finalizar ocorrências (/api/occurrences/{id}/force-close).
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
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
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
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.
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.
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.
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
Inserindo um Usuário CTI
No PABX uTech, acesse o menu CTI (menu APLICAÇÕES ⇒ CTI) e crie um usuário conforme abaixo:
- 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:
Configuração do Situator | |
---|---|
Tipo | Selecione uTech. |
Url | Insira o endereço de acesso ao PABX uTech no formato http://IP_DO_PABX/.
http://10.0.0.1/ |
Login | Usuário de acesso à função de callback (Ver XXXX). A mesma configurado no PABX uTech (Em APLICAÇÕES ⇒ Callback). |
Senha | Senha de acesso à função de callback (Ver XXXX). 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.
|
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 XXXX. Usuário configurado 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, 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.
|
- 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 :
|