PABX/Situator
(→Configurando a integração do PABX uTech com Situator) |
(→Servidor Primário e Secundário) |
||
(48 edições intermediárias de um usuário não apresentadas) | |||
Linha 1: | Linha 1: | ||
__TOC__ | __TOC__ | ||
+ | |||
+ | |||
+ | Siga a sequencia abaixo para configurar a integração so PABX uTech com Situator. | ||
+ | <BR><BR> | ||
= Configurando a integração do PABX uTech com Situator = | = Configurando a integração do PABX uTech com Situator = | ||
<BR> | <BR> | ||
A configuração de integração fica no menu '''GESTÃO''' ⇒ '''Configuração''' ⇒ '''Integrações''' ⇒ '''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 === | ||
<BR> | <BR> | ||
[[Arquivo:situator-config-srv.png|border|right|550px]] | [[Arquivo:situator-config-srv.png|border|right|550px]] | ||
<BR> | <BR> | ||
+ | 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 ([https://seventh.atlassian.net/wiki/spaces/SITAPI/pages/358547457/Login '''/api/login''']). | ||
+ | * Criar ocorrências ([https://seventh.atlassian.net/wiki/spaces/SITAPI/pages/157351937/Gerar+Ocorr+ncias '''/api/remote-events''']) | ||
+ | * Atender automaticamente ocorrências ([https://seventh.atlassian.net/wiki/spaces/SITAPI/pages/497254404/Atendimento+autom+tico+de+ocorr+ncias '''/api/voip/events''']]). Ver [https://seventh.atlassian.net/wiki/spaces/SITAPI/pages/497254404/Atendimento+autom+tico+de+ocorr+ncias '''configurações necessárias'''] do ramal do usuário no Situator! | ||
+ | * Finalizar ocorrências ('''/api/occurrences/{id}/force-close'''). | ||
+ | <BR> | ||
+ | {| style="width: 55%; background-color: orange;" | ||
+ | | 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'' | ||
+ | |} | ||
+ | <BR> | ||
{| class="wikitable" width="55%" | {| class="wikitable" width="55%" | ||
! scope="row" colspan=2 style="width: 15%" align="center"| Configuração Situator - Servidores | ! scope="row" colspan=2 style="width: 15%" align="center"| Configuração Situator - Servidores | ||
Linha 25: | Linha 48: | ||
<BR> | <BR> | ||
{| style="width: 55%; background-color: orange;" | {| style="width: 55%; background-color: orange;" | ||
− | | Utilize as configurações do '''Servidor Secundário''' caso queira enviar | + | | 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. |
|} | |} | ||
<BR> | <BR> | ||
+ | |||
+ | === Confioguração Geral === | ||
<BR> | <BR> | ||
[[Arquivo:situator-config-geral.png|border|right|550px]] | [[Arquivo:situator-config-geral.png|border|right|550px]] | ||
Linha 45: | Linha 70: | ||
|- | |- | ||
! scope="row" style="width: 25%" align="right"| '''Filas''' | ! scope="row" style="width: 25%" align="right"| '''Filas''' | ||
− | | Selecione | + | | Selecione neste campo, quais filas do PABX fazer parte da integração com Situator. |
|- | |- | ||
! scope="row" style="width: 25%" align="right"| '''Monitorar Ramais''' | ! scope="row" style="width: 25%" align="right"| '''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. | | 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. | ||
|} | |} | ||
− | <BR> | + | <BR><BR><BR> |
− | + | === Configuração de Eventos Padrão === | |
− | <BR> | + | |
[[Arquivo:situator-config-evt-def.png|border|right|550px]] | [[Arquivo:situator-config-evt-def.png|border|right|550px]] | ||
<BR> | <BR> | ||
− | |||
{| class="wikitable" width="55%" | {| class="wikitable" width="55%" | ||
! scope="row" colspan=2 style="width: 15%" align="center"| Configuração Situator - Eventos | ! scope="row" colspan=2 style="width: 15%" align="center"| Configuração Situator - Eventos | ||
Linha 71: | Linha 94: | ||
| Prioridade dos eventos de '''Ramal Ativo''' e '''Ramal Inativo'''. | | Prioridade dos eventos de '''Ramal Ativo''' e '''Ramal Inativo'''. | ||
|- | |- | ||
− | ! scope="row" style="width: 25%" align="right"| '''Finalizar Ocorrências para Ramal Ativo''' | + | ! scope="row" style="width: 25%" align="right"| '''Finalizar Ocorrências para Ramal Ativo |
− | | Se habilitado, informa para o Situator fechar automaticamente de ''''Ramal Inativo''' ao receber um evento de '''Ramal Ativo'''. | + | ''' |
+ | | Se habilitado, informa para o Situator fechar automaticamente ocorrência de ''''Ramal Inativo''' ao receber um evento de '''Ramal Ativo'''. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''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. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''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) | ||
|} | |} | ||
<BR><BR><BR><BR> | <BR><BR><BR><BR> | ||
− | + | ||
+ | === Configuração de Portaria Autônoma === | ||
[[Arquivo:situator-config-ia.png|border|right|550px]] | [[Arquivo:situator-config-ia.png|border|right|550px]] | ||
<BR> | <BR> | ||
− | |||
{| class="wikitable" width="55%" | {| class="wikitable" width="55%" | ||
! scope="row" colspan=2 style="width: 15%" align="center"| Configuração Situator - Portaria Autônoma | ! scope="row" colspan=2 style="width: 15%" align="center"| Configuração Situator - Portaria Autônoma | ||
|- | |- | ||
! scope="row" style="width: 25%" align="right"| '''Assistente Virtual''' | ! scope="row" style="width: 25%" align="right"| '''Assistente Virtual''' | ||
− | | Habilita a integração com assistente | + | | 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. |
|- | |- | ||
! scope="row" style="width: 25%" align="right"| '''Mensagem de Saudação''' | ! scope="row" style="width: 25%" align="right"| '''Mensagem de Saudação''' | ||
− | | Mensagem inicial de saudação para o usuário. Ex. '''''Bem vindo, eu sou a assistente virtual do condomínio | + | | Mensagem inicial de saudação para o usuário. Ex. '''''Bem vindo, eu sou a assistente virtual do condomínio Pedro Coelho!'''''. |
|- | |- | ||
! scope="row" style="width: 25%" align="right"| '''Tempo Limite de Resposta''' | ! scope="row" style="width: 25%" align="right"| '''Tempo Limite de Resposta''' | ||
Linha 96: | Linha 126: | ||
<BR> | <BR> | ||
− | = Importando Eventos = | + | <BR><BR> |
+ | == Configuração de Contas == | ||
+ | <BR> | ||
+ | No menu contas, deve-se adicionar todas as contas existentes no Situator. | ||
+ | <BR><BR> | ||
+ | [[Arquivo:situator-accounts-list.png|border|center|800px]] | ||
+ | <BR> | ||
+ | [[Arquivo:situator-accounts-add.png|border|right|550px]] | ||
+ | |||
+ | |||
+ | {| class="wikitable" width="55%" | ||
+ | ! scope="row" colspan=2 style="width: 15%" align="center"| Configuração Situator - Adicionando Contas | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Estado da Conta''' | ||
+ | | Valor numérico da conta. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Conta''' | ||
+ | | Valor numérico da conta. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Descrição''' | ||
+ | | Descrição da conta. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Endereço''' | ||
+ | | Endereço físico da conta. | ||
+ | |} | ||
+ | <BR><BR><BR><BR><BR><BR> | ||
+ | |||
+ | == Configuração de Zonas == | ||
+ | <BR> | ||
+ | No menu zonas. | ||
+ | <BR><BR> | ||
+ | [[Arquivo:situator-zones-list.png|border|center|650px]] | ||
+ | <BR> | ||
+ | [[Arquivo:situator-zone-add.png|border|right|600px]] | ||
+ | |||
+ | |||
+ | {| class="wikitable" width="55%" | ||
+ | ! scope="row" colspan=2 style="width: 15%" align="center"| Configuração Situator - Adicionando Zonas | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Conta''' | ||
+ | | Conta pré-configurada. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Zona''' | ||
+ | | Valor numérico da zona. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Descrição''' | ||
+ | | Descrição da zona. | ||
+ | |} | ||
+ | <BR><BR><BR><BR><BR><BR> | ||
+ | |||
+ | == Configuração de Eventos == | ||
+ | <BR> | ||
+ | No menu Eventos. | ||
+ | <BR><BR> | ||
+ | [[Arquivo:situator-evts-list.png|border|center|850px]] | ||
+ | <BR> | ||
+ | [[Arquivo:situator-evts-add.png|border|right|500px]] | ||
+ | |||
+ | |||
+ | {| class="wikitable" width="55%" | ||
+ | ! scope="row" colspan=2 style="width: 15%" align="center"| Configuração Situator - Adicionando Eventos | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Evento''' | ||
+ | | Código numérico do evento. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Descrição''' | ||
+ | | Descrição do evento. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Número''' | ||
+ | | Identidade da chamada recebida para gerar este evento (Número do chamador - NA). | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Zona''' | ||
+ | | Zona associada ao evento. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Prioridade''' | ||
+ | | Prioridade do evento. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Agrupar Eventos''' | ||
+ | | Indica para o Situator agrupar eventos iguais. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Portaria Autônoma''' | ||
+ | | Habilita portaria autônoma. | ||
+ | |||
+ | |} | ||
+ | <BR><BR><BR><BR><BR><BR> | ||
+ | <BR><BR> | ||
+ | |||
+ | |||
+ | === Importando Eventos === | ||
'''Tutorial de como importar eventos do Situator no PABX.''' | '''Tutorial de como importar eventos do Situator no PABX.''' | ||
* [[PABX/Situator/ImportarEventos| '''Importando Eventos do Situator''']] | * [[PABX/Situator/ImportarEventos| '''Importando Eventos do Situator''']] | ||
+ | <BR> | ||
+ | |||
+ | == Inserindo Usuário de Callback == | ||
+ | <BR> | ||
+ | Para utilização da opção ''click-to-call'', é necessário a configuração de um usuário e senha.<BR> | ||
+ | * Na interface web do PABX uTech, acesse o menu '''APLICAÇÕES''' ⇒ '''Callback'''. Clique em '''Adicionar''', e insira um usuário e senha conforme abaixo:<BR> | ||
+ | [[Arquivo:situator-config-c2c.png|border|center|650px]] | ||
+ | <BR> | ||
+ | <BR> | ||
+ | |||
+ | == Inserindo um Usuário CTI == | ||
+ | <BR> | ||
+ | Na interface do web do PABX uTech, acesse o menu CTI (menu '''APLICAÇÕES''' ⇒ '''CTI''') e crie um usuário conforme abaixo: | ||
+ | [[Arquivo:situator-config-ctiuser.png|border|center|650px]] | ||
+ | <BR> | ||
+ | * '''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. | ||
+ | |||
+ | <BR><BR> | ||
+ | = Configurando a integração no Situator = | ||
+ | <BR> | ||
+ | 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: | ||
+ | <BR><BR> | ||
+ | [[Arquivo:situator-config-telefonia0.png|border|center|650px]] | ||
+ | <BR> | ||
+ | [[Arquivo:situator-config-telefonia1.png|border|right|610px]] | ||
+ | <BR> | ||
+ | |||
+ | {| class="wikitable" width="50%" | ||
+ | ! scope="row" colspan=2 style="width: 15%" align="center"| Configuração do Situator | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Tipo''' | ||
+ | | Selecione '''uTech'''. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Url''' | ||
+ | | Insira o endereço de acesso ao PABX uTech no formato <nowiki>http://IP_DO_PABX/</nowiki>.<BR> | ||
+ | * Exemplo: | ||
+ | <pre>http://10.0.0.1/</pre> | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Login''' | ||
+ | | Usuário de acesso à função de ''callback'' (Ver [[PABX/Situator#Inserindo_Usu.C3.A1rio_de_Callback|'''Inserindo Usuário de Callback''']]). A mesma configurado no PABX uTech (Em '''APLICAÇÕES''' ⇒ '''Callback'''). | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Senha''' | ||
+ | | Senha de acesso à função de ''callback'' (Ver [[PABX/Situator#Inserindo_Usu.C3.A1rio_de_Callback|'''Inserindo Usuário de Callback''']]). A mesma configurado no PABX uTech (Em '''APLICAÇÕES''' ⇒ '''Callback'''). | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''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. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Porta Socket''' | ||
+ | | Porta de acesso ao protocolo CTI do PABX uTech. É definido no configurado no pabx uTech, menu '''APLICAÇÕES''' ⇒ '''CTI'''. '''PADRÃO 3000'''. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Login Socket''' | ||
+ | | Usuário de acesso ao protocolo CTI do PABX uTech ('''DEVE ser um usuário com permissão de operador) Ver [[PABX/Situator#Inserindo_um_Usu.C3.A1rio_CTI|'''Inserindo Usuário CTI''']] no pabx uTech, menu '''APLICAÇÕES''' ⇒ '''CTI'''. | ||
+ | |- | ||
+ | ! scope="row" style="width: 25%" align="right"| '''Senha Socket''' | ||
+ | | Senha de acesso ao protocolo CTI do PABX uTech. Senha do usuário configurado no pabx uTech. Ver [[PABX/Situator#Inserindo_um_Usu.C3.A1rio_CTI|'''Inserindo Usuário CTI''']] no pabx uTech, menu '''APLICAÇÕES''' ⇒ '''CTI'''. | ||
+ | |} | ||
<BR> | <BR> | ||
Linha 169: | Linha 349: | ||
* Documentações de todos os eventos e comandos do protocolo CTI: [[Protocolo_CTI_uTech|'''Protocolo CTI uTech''']] | * Documentações de todos os eventos e comandos do protocolo CTI: [[Protocolo_CTI_uTech|'''Protocolo CTI uTech''']] | ||
<BR> | <BR> | ||
− | + | === Exemplo de evento de chamada: === | |
+ | {| class="wikitable" | ||
+ | ! style="text-align: left; font-weight: bold;" | | ||
+ | <pre> | ||
+ | << 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 | ||
+ | </pre> | ||
+ | |} | ||
+ | <BR><BR> | ||
+ | === Exemplo de evento de gravação: === | ||
{| class="wikitable" | {| class="wikitable" | ||
! style="text-align: left; font-weight: bold;" | REC CALLID:30303045 RECID:1234567 URL:<nowiki>https://pabx.dominio.com.br:8888/storage/14092020/3000_100_410000a_16462_c810000a_26944_134908.wav</nowiki>\r\n\r\n | ! style="text-align: left; font-weight: bold;" | REC CALLID:30303045 RECID:1234567 URL:<nowiki>https://pabx.dominio.com.br:8888/storage/14092020/3000_100_410000a_16462_c810000a_26944_134908.wav</nowiki>\r\n\r\n |
Edição atual tal como 16h14min de 21 de setembro de 2022
Tabela de conteúdo |
Siga a sequencia abaixo para configurar a integração so PABX uTech com Situator.
[editar] 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.
[editar] Configuração Geral
[editar] 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).
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:
|
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. |
[editar] 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. |
[editar] 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) |
[editar] 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. |
[editar] 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. |
[editar] 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. |
[editar] 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. |
[editar] Importando Eventos
Tutorial de como importar eventos do Situator no PABX.
[editar] 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:
[editar] 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:
- 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.
[editar] 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 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.
|
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. |
[editar] Formato dos eventos enviados
[editar] 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 } |
---|
[editar] 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
[editar] 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 |
---|
[editar] 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 :
|