PABX/Movidesk
(→Configurando) |
(→Relatório de Integração) |
||
(23 edições intermediárias de um usuário não apresentadas) | |||
Linha 7: | Linha 7: | ||
=== Configurações Gerais === | === Configurações Gerais === | ||
− | Acesse o menu '''GESTÃO''' => '''Configuração''', aba '''Movidesk''' e configure os campos: | + | {| style="width: 100%; background-color: orange;" |
+ | | | ||
+ | * Para integração com chat (chatbot, chatbox, whatsapp, telegram, etc...), é mandatório selecionar a opção '''Habilitar Integração''' em cada fila que será integrada com chat's. Acesse o menu '''CALL CENTER''' ⇒ '''Filas'''. Edite a fila em questão e habilite a opção '''Habilitar Integração'''. | ||
+ | |} | ||
+ | |||
+ | * Primeiramente. habilite a integração no PABX uTech, acessando o menu '''GESTÃO''' ⇒ '''Configuração''', aba '''Integrações''' e depois '''Geral'''. Habilite o campo '''Habilitar chamadas aos webhooks de integradores''' e salve a configuração. | ||
+ | <BR> | ||
+ | [[Arquivo:habilitarwebhooks.png|center|400px]] | ||
+ | <BR> | ||
+ | |||
+ | * Acesse o menu '''GESTÃO''' => '''Configuração''', aba '''Movidesk''' e configure os campos: | ||
<BR> | <BR> | ||
[[Arquivo:pabx-movidesk-geral.jpg|right|border|300px]] | [[Arquivo:pabx-movidesk-geral.jpg|right|border|300px]] | ||
− | {| class="wikitable" width=" | + | {| class="wikitable" width="70%" |
! scope="row" colspan=2 style="width: 15%" align="center"| Movidesk - Parâmetros gerais | ! scope="row" colspan=2 style="width: 15%" align="center"| Movidesk - Parâmetros gerais | ||
|- | |- | ||
Linha 39: | Linha 49: | ||
! scope="row" style="width: 25%" align="right"| '''Endereço IP Público''' | ! scope="row" style="width: 25%" align="right"| '''Endereço IP Público''' | ||
| Endereço publico para acesso ao PABX uTech. Utilizado no caso de agentes estiverem em uma localidade diferente do PABX uTech. Será utilizado para montar a url utilizada para escutar a gravação e para utilização do '''click to call'''. | | Endereço publico para acesso ao PABX uTech. Utilizado no caso de agentes estiverem em uma localidade diferente do PABX uTech. Será utilizado para montar a url utilizada para escutar a gravação e para utilização do '''click to call'''. | ||
+ | {| style="width: 100%; background-color: orange;" | ||
+ | | | ||
+ | * Sempre inserir o '''http://''' ou '''https://'''. Caso contrário a url será interpretada de forma incorreta oo visualizar no ticket dentro do Movidesk | ||
+ | |} | ||
|- | |- | ||
! scope="row" style="width: 25%" align="right"| '''Apenas Usuário Abrem Ticket''' | ! scope="row" style="width: 25%" align="right"| '''Apenas Usuário Abrem Ticket''' | ||
| Selecione habilitado, apenas usuário cadastrados na plataforma poderão abrir novos ticket's. Se o numero de origem da chamada casar com o numero telefônico do cadastro do cliente. | | Selecione habilitado, apenas usuário cadastrados na plataforma poderão abrir novos ticket's. Se o numero de origem da chamada casar com o numero telefônico do cadastro do cliente. | ||
+ | {| style="width: 100%; background-color: red;" | ||
+ | | | ||
+ | * Se esta opção estiver desmarcada, e o contato não existir no Movidesk, o PABX uTech insere um novo contato no Movidesk. Para que seja realizado o cadastro/inclusão automática de novos contatos, é '''MANDATOÓRIO''' que o campo '''"Obrigar a informação de ao menos uma Organização ao cadastrar clientes do tipo pessoa"''' esteja desmarcado no '''Movidesk'''! | ||
+ | [[Arquivo:movidesk-person-wout-org.png|border|500px]] | ||
+ | |} | ||
|- | |- | ||
! scope="row" style="width: 25%" align="right"| '''Monitorar Agentes''' | ! scope="row" style="width: 25%" align="right"| '''Monitorar Agentes''' | ||
Linha 57: | Linha 76: | ||
<BR><BR> | <BR><BR> | ||
+ | |||
=== URA / Mensagens / Áudios === | === URA / Mensagens / Áudios === | ||
Linha 137: | Linha 157: | ||
* '''Abrir''': Encaminhar as chamadas para abertura de ticket. | * '''Abrir''': Encaminhar as chamadas para abertura de ticket. | ||
* '''Consultar''': Encaminhar as chamadas para consulta de ticket. | * '''Consultar''': Encaminhar as chamadas para consulta de ticket. | ||
− | * '''Fila''': Chamadas serão tratadas conforme API de Telefonia da Movidesk, onde toda configuração de agentes | + | * '''Fila''': <span style="color:red;">Chamadas serão tratadas conforme API de Telefonia da Movidesk com controle de fila, onde toda configuração de agentes fica no Movidesk e o PABX consulta via API qual o agente deve atendar a chamada em questão. '''Somente neste modo serão mostradas as janelas de informação de chamadas no Movidesk</span> |
|} | |} | ||
<BR><BR> | <BR><BR> | ||
Linha 157: | Linha 177: | ||
* Configurando a URL de telefonia: No Movidesk, acesse menu '''Configuração''' ⇒ '''Conta''' ⇒ '''Parâmetros''' ⇒ '''Módulos Adicionais''' ⇒ '''Atendimento via telefonia''' | * Configurando a URL de telefonia: No Movidesk, acesse menu '''Configuração''' ⇒ '''Conta''' ⇒ '''Parâmetros''' ⇒ '''Módulos Adicionais''' ⇒ '''Atendimento via telefonia''' | ||
− | + | * Insira a URL abaixo no campo '''URL na central telefônica''' substituindo os campos: | |
− | * Insira a URL abaixo | + | ** '''IP_DO_PABX_UTECH''' pelo endereço IP do PABX. |
+ | ** '''TOKEN_UTECH''': Token configurado no campo '''Token uTech''', nas [[PABX/Movidesk#Configura.C3.A7.C3.B5es_Gerais|'''configurações gerais''']] de integração com Movidesk no PABX uTech. | ||
<pre> | <pre> | ||
− | http://IP_DO_PABX_UTECH/movidesk/v1?token= | + | http://IP_DO_PABX_UTECH/movidesk/v1?token=TOKEN_UTECH&ticket={ticket.id}&number={call.destination.number}&extension={call.source.number} |
</pre> | </pre> | ||
* '''Exemplo''': | * '''Exemplo''': | ||
<pre> | <pre> | ||
− | http://10.0.0.1/movidesk/v1?token= | + | http://10.0.0.1/movidesk/v1?token=3456456756744779bf416222&ticket={ticket.id}&number={call.destination.number}&extension={call.source.number} |
</pre> | </pre> | ||
+ | <BR> | ||
+ | [[Arquivo:movidesk-c2c-config-url.png|center|border|944px]] | ||
+ | <BR> | ||
+ | * '''NOTA:''' Na configuração dos agentes (Pessoas) deve-se configurar no número preferencial/principal, o ramal do agente. | ||
+ | <BR> | ||
+ | [[Arquivo:movidesk-c2c-config-exten.png|center|border|961px]] | ||
− | [[ | + | <BR><BR> |
+ | == Utilizando o ''Click to Call'' == | ||
+ | |||
+ | Acesse o ticket em questão. No canto superior esquerdo, nas informações do contato, clique sobre o ícone do telefone, conforme imagem abaixo - '''figura 1'''. Selecione o telefone/contato da pessoa que deseja ligar e depois clique em chamar, conforme imagem abaixo - '''figura 2'''. | ||
+ | |||
+ | [[File:movidesk-user-icone.png|thumb|left|500px|'''figura 1''']]<BR> | ||
+ | [[File:movidesk-user-select.png|thumb|left|500px|'''figura 2''']] | ||
+ | |||
+ | |||
+ | <BR><BR><BR><BR><BR><BR><BR><BR><BR><BR> | ||
+ | <BR><BR><BR><BR><BR><BR><BR><BR><BR><BR><BR> | ||
+ | <BR><BR><BR><BR> | ||
+ | = Relatório de Integração = | ||
+ | <BR> | ||
+ | * [https://www.youtube.com/watch?v=-D3S5_S8iQc '''Relatório de Integrações do PABX IP uTech com CRM e sistemas de Tickets'''] | ||
+ | <BR><BR> |
Edição atual tal como 13h42min de 26 de outubro de 2022
Tabela de conteúdo |
Este tutorial é utilizado para configuração da integração do PABX uTech com a sistema de ticket/telefonia da plataforma Movidesk.
[editar] Configurações
[editar] Configurações Gerais
|
- Primeiramente. habilite a integração no PABX uTech, acessando o menu GESTÃO ⇒ Configuração, aba Integrações e depois Geral. Habilite o campo Habilitar chamadas aos webhooks de integradores e salve a configuração.
- Acesse o menu GESTÃO => Configuração, aba Movidesk e configure os campos:
Movidesk - Parâmetros gerais | ||
---|---|---|
Habilitar Integração | Habilita a integração com sistema Movidesk. | |
Endereço do Servidor | URL do servidor de integração com Movidesk (Normalmente https://api.movidesk.com/public). | |
Token | Token de acesso a API de integração da Movidesk (Criado no sistema Movidesk). | |
Versão | Versão a utilizar da API do Movidesk. | |
Token uTech | Defina um token (senha) que será utilizada para a função Click to Call (Discar para o cliente diretamente pela tela do agente utilizando o PABX uTech). | |
Destino Padrão | Destino para onde as chamadas deverão ser encaminhadas no caso de falha comunicação com Movidesk. Por exemplo, para a fila 1000 ou um ramal. Caso o PABX uTech não consiga se comunicar com Movidesk, as chamadas serão encaminhadas para este numero (Normalmente uma fila de atendimento) | |
Timeout para Atendimento | Tempo, em segundos, para tratamento da chamada com a API do Movidesk. Após este tempo, a chamada será direcionada para o destino padrão configurado no campo acima. | |
Endereço IP Público | Endereço publico para acesso ao PABX uTech. Utilizado no caso de agentes estiverem em uma localidade diferente do PABX uTech. Será utilizado para montar a url utilizada para escutar a gravação e para utilização do click to call.
| |
Apenas Usuário Abrem Ticket | Selecione habilitado, apenas usuário cadastrados na plataforma poderão abrir novos ticket's. Se o numero de origem da chamada casar com o numero telefônico do cadastro do cliente.
| |
Monitorar Agentes | Se habilitado, chamadas serão encaminhadas diretamente para o agente responsável pelo ticket (caso o ticket já esteja aberto e associado a um agente). Se for um novo ticket, o PABX irá colocar a chamada em espera até que o ticket seja atribuído a um agente pela API do Movidesk. Assim que o novo ticket for atribuído, a chamada será para o agente.
| |
Vocalizar Ticket | Se habilitado, reproduz mensagem com o número do ticket aberto ao receber uma chamada. |
[editar] URA / Mensagens / Áudios
Nestes campos, são configurados os áudios personalizados da URA de atendimento e/ou abertura de ticket's do cliente. O PABX já possui áudios padrão do sistema. Porem, se o usuário desejar, estes áudios podem ser alterados. Os áudios podem ser carregados no menu do PABX Configurações ⇒ Gravações do Sistema.
Configuração Freshdesk - Mensagens | |
---|---|
Anuncio | Mensagem inicial para chamadas na ura da plataforma Movidesk. Mensagem Padrão: "Digite 1 para abrir um ticket, digite 2 para consultar um ticket, digite 3 para sair. |
Reproduzir Ticket | Mensagem reproduzida antes de anunciar o número ticket. (reproduzido depois de solicitar a opção 1 da ura do Movidesk - abrir ticket). Mensagem Padrão: O número do seu ticket é:". |
Digitar Ticket | Mensagem reproduzida ao selecionar a opção 2 da ura do Movidesk - abrir ticket. Mensagem Padrão: Digite o número do seu ticket seguido pela tecla sustenido. |
Repetir Ticket | Mensagem reproduzida pela ura do Movidesk após reproduzir o número do ticket. Mensagem Padrão: Para repetir o número do seu ticket pressione 1. |
Ticket Inválido | Mensagem reproduzida na opção 2 da ura do Movidesk, ao consultar um ticket inválido. Mensagem Padrão: O número do ticket não foi encontrado. |
[editar] Regras
Após realizar as configurações padrões, é necessário configurar as regras de destino das chamadas que serão integradas com Movidesk. Acesse o menu GESTÃO => Configuração, aba Movidesk e depois clique no botão Regras.
- Clique no botão Adicionar para incluir uma nova regra.
Movidesk - regras | |
---|---|
Nome | Nome da regra. |
Padrão de Origem | Filtro utilizado para filtrar chamadas pelo padrão de origem. Por exemplo para que esta regra só se aplique a chamadas originadas de celular, utilizamos: .*9.........
|
Padrão de Destino | Filtro utilizado para filtrar chamadas pelo padrão de destino. Por exemplo para que esta regra só se aplique a chamadas destinadas ao DDR 5000, utilizamos: 5000.
|
URA | Indica se a integração deverá utilizar uma URA do sistema. |
Opção da URA | Selecione a opção da ura que deseja integrar. |
Fila | Fila do sistema de telefonia do Movidesk para onde as chamadas desta regra serão direcionadas.
|
Prioridade | Prioridade padrão dos ticket's abertos pelo PABX uTech, ao passarem por esta regra. Assim, é possível criar diversas regras, dando prioridade diferentes conforme a chamada. Por exemplo, pela origem ou pelo fila de atendimento destino. |
Campo | Campo customizado no contato do cliente para que o PABX direcione a chamada diretamente para o ramal contido neste campo, sem utilizar a API padrão de filas do Movidesk. Caso o campo não exista, ou o ramal destino não exista, a chamada será direcionada para a API padrão configurado no campo Fila do Movidesk.
|
Ação | Este campo define a ação tomada pela integração do Freshdesk para esta regra.
|
[editar] Informações mostradas no Ticket
Abaixo um exemplo de como as informações são mostradas no ticket.
[editar] Click to Call
A Função click to call é utilizada para discar para os contatos do Movidesk, diretamente pela interface do agente. Ao utilizar o click to call, o PABX uTech gera uma chamada para o ramal do agente em questão e, ao atender, o PABX uTech gera uma chamada para o cliente selecionado.
É inserido no ticket as informações dessa chamada com link para a gravação.
[editar] Configurando
- Configurando a URL de telefonia: No Movidesk, acesse menu Configuração ⇒ Conta ⇒ Parâmetros ⇒ Módulos Adicionais ⇒ Atendimento via telefonia
- Insira a URL abaixo no campo URL na central telefônica substituindo os campos:
- IP_DO_PABX_UTECH pelo endereço IP do PABX.
- TOKEN_UTECH: Token configurado no campo Token uTech, nas configurações gerais de integração com Movidesk no PABX uTech.
http://IP_DO_PABX_UTECH/movidesk/v1?token=TOKEN_UTECH&ticket={ticket.id}&number={call.destination.number}&extension={call.source.number}
- Exemplo:
http://10.0.0.1/movidesk/v1?token=3456456756744779bf416222&ticket={ticket.id}&number={call.destination.number}&extension={call.source.number}
- NOTA: Na configuração dos agentes (Pessoas) deve-se configurar no número preferencial/principal, o ramal do agente.
[editar] Utilizando o Click to Call
Acesse o ticket em questão. No canto superior esquerdo, nas informações do contato, clique sobre o ícone do telefone, conforme imagem abaixo - figura 1. Selecione o telefone/contato da pessoa que deseja ligar e depois clique em chamar, conforme imagem abaixo - figura 2.
[editar] Relatório de Integração