¶ Integração API Movidesk com Contact Center USCall UC
Este documento tem por objetivo descrever o funcionamento da integração com o sistema Movidesk , com os agentes de contact center do USCall UC.
¶ Facilidades disponíveis com a API Movidesk
- Abertura de tickets para chamadas efetuadas e recebidas dos agentes de contact center
- Visualização de ticket em tela, quando chamada atendida no ramal do agente
- Gravação do áudio da chamada
¶ Funcionamento da integração
A integração com sistema deve ser utilizada nas operações de contact center do USCall UC que recebam ou efetuem chamadas de voz.
Quando uma chamada é atendida nos ramais dos agentes de contact center, o USCall UC verifica se existe alguma integração com o sistema movidesk configurada, caso positivo, realiza a abertura de um ticket no sistema com as informações de chamada do cliente, tais como número de telefone,
Após a abertura do ticket, o USCall UC envia uma requisição ao sistema, para disponibilizar em tela as informações do ticket aberto ao usuário associado com o agente de contact center que atendeu a chamada.
¶ Configurando e habilitando a integração
Para habilitar a integração é necessário a criação de um novo token no módulo Webservice do USCall UC, onde o tipo de aplicação selecionado deverá ser CRM Moviddesk em:
Aplicações Extra > Webservice > Tokens App's
Ao selecionar o tipo da aplicação com CRM Movidesk o campo parâmetro será preenchido com os parâmetros necessários para o USCall UC realizar a comunicação com a API Movidesk, os valores dos parâmetros devem ser preenchidos após o caractere = (igual). Abaixo tabela com os parâmetros e descrição:
| Parâmetro | Descrição | Obrigatório | Valor padrão |
|---|---|---|---|
| urlapi | url api movidesk | sim | https://api.movidesk.com/public/v1/ |
| token | Cliente deve fornecer o Token | sim | |
| urlrecord | link da gravação anexa no ticket | sim | https://integracao.uscall.com.br/api/record |
Após habilitar os parâmetros de comunicação com a API ,é necessário associar os agentes a integração de contact center. Para isso, é necessário navegar até as configurações dos agentes no USCall UC, e selecionar o tipo de integração como CRM Movidesk no campo Habilitar API. Após selecionado, o campo Parâmetros API será preenchido com os parâmetros necessários para habilitar a integração
Contact center > Cadastros operações > Agentes
| Parâmetro | Descrição | Obrigatório | Valor padrão |
|---|---|---|---|
| movidesk.in | ativar integração para chamadas receptivas com valores 1 ou 0 | sim | 1 |
| movidesk.ativo | ativar para chamadas efetuadas ,defina uma fila diferente da receptiva | não |
Configure o movidesk para integração utilizando os link abaixo:
Recebimento de chamadas
Telefonia - Sem controle da fila: Integração com o uscall.
¶ Configurando o ClickToCall no Movidesk
¶ Configurando Endpoint de Telefonia
Acesse o menu:
Configurações > Telefonia > Parâmetros de Telefonia
Após acessar a opção Parâmetros da Telefonia, selecione o provedor Outros.
Em seguida:
- Ative a opção Permitir chamadas a partir do Movidesk
- Preencha o campo Efetuar chamada com a seguinte URL:
https://URLEXEMPLO.com.br/api/startcall?token=TOKEN&tipo=outbound&origem={call.source.number}&destino={call.destination.number}&categoria=1&idcti={ticket.id}
Substitua os parâmetros abaixo:
| Parâmetro | Descrição |
|---|---|
| URLEXEMPLO.com.br | URL ou DNS do servidor USCall |
| TOKEN | Token gerado no módulo Webservice do USCall |
| categoria | Categoria de saída utilizada para envio das chamadas |
Após preencher a URL:
- Altere o método para GET
- Em Autenticação, selecione a opção Nenhum
¶ Vinculando usuários aos agentes
Para associar os usuários do Movidesk aos agentes do USCall UC, acesse:
Configurações > Pessoas > Pessoas
Selecione o usuário que utilizará o recurso ClickToCall.
Na seção Outros contatos:
- Selecione o tipo RAMAL
- Insira o agente correspondente ao usuário
Após realizar a configuração, clique em Salvar.
Este procedimento deve ser realizado para todos os usuários do Movidesk que utilizarão o recurso ClickToCall.