Integração do chat do Movidesk
Este material fornece informações para integrar o chat do Movidesk a alguma aplicação do cliente, de forma que não será necessário uma nova autenticação no chat.
Importante: Quando os dados do cliente não são encontrados, ele é cadastrado automaticamente pelo Movidesk.
Parâmetros:
| Parâmetro | Tipo | Tamanho | Obrigatório | Descrição |
|---|---|---|---|---|
| ID do Aplicativo | numérico | 64 | ✓ | O ID do aplicativo é o código que identifica o seu aplicativo de chat no Movidesk. Ele poderá ser obtido nas configurações do aplicativo do seu Movidesk. |
| Name | string | 128 | ✓ | Nome do cliente |
| string | 128 | E-mail que irá identificar o cliente. Informação opcional caso o campo CodeReference seja informado. Do contrário, será obrigatório. | ||
| CodeReference | string | 128 | Código de referência do cliente. Informação opcional caso o campo E-mail seja informado. Do contrário, será obrigatório.Se esse campo for informado, é através dele que o cliente será identificado no Movidesk. | |
| OrganizationCodeReference | string | 128 | Código de referência da organização (Empresa) do cliente. Informação opcional que será utilizada somente se o cliente não for encontrado e precisar ser cadastrado associado a alguma organização. | |
| StayConnected | bool | ✓ | Informar true ou false. Quando true, mantém o usuário conectado indefinidamente no chat | |
| EmptySubject | bool | ✓ | Informar true ou false. Quando true, mantêm o assunto do ticket gerado pelo atendimento via chat vazio, precisando ser preenchido pelo agente que atender a solicitação de conversa. se for falso, fixa o assunto do ticket com o nome do cliente, podendo ainda o agente que atendeu a conversa alterar o assunto posteriormente | |
| StartChat | bool | ✓ | Informar true ou false. Quando true, a conversa será iniciada imediatamente no momento da integração. Do contrário, o cliente será direcionado para a tela inicial do chat, sendo necessário clicar em Iniciar chat para começar a conversa. |
* Nos exemplos abaixo, a sequência numérica 12345678901234567890123456789012 deverá ser substituida pelo seu ID de Aplicativo.
Integração do chat com link direto
Atenção: Os parâmetro devem ser passados no formato URL Encoded
http://www.w3schools.com/tags/ref_urlencode.asp
Integração do chat via formulário
Exemplo:
<form action="http://chat.movidesk.com/ChatWidget/Login/12345678901234567890123456789012" target="_blank" method="post">
<input type="hidden" name="Name" value="Nome do cliente" />
<input type="hidden" name="Email" value="emaildocliente@servidor.com" />
<input type="hidden" name="PhoneNumber" value="(99) 9999-9999" />
<input type="hidden" name="CodeReference" value="0000" />
<input type="hidden" name="OrganizationCodeReference" value="9999" />
<input type="hidden" name="StayConnected" value="false" />
<input type="hidden" name="EmptySubject" value="false" />
<input type="hidden" name="StartChat" value="false" />
<button type="submit" class="btn btn-primary">Entrar</button>
</form>
Integração do chat via aplicativo
Exemplos:
Implementação básica:
<!-- Chat do Movidesk -->
<script type="text/javascript">var mdChatClient="12345678901234567890123456789012";</script>
<script src="http://chat.movidesk.com/Scripts/chat-widget.min.js"></script>
<!-- Chat do Movidesk fim -->
Login automático e/ou sob demanda:
<script type="text/javascript">
// Função para login automático
// Esta função pode ser inserida logo abaixo do código do aplicativo
// ou então ser disparada posteriormente via javascript
movideskLogin({
name:"Nome do cliente",
email: "emaildocliente@servidor.com",
codeReference: "0000",
organizationCodeReference: "9999",
stayConnected: false,
emptySubject: false,
startChat: false, // Se o startChat for true, o aplicativo irá maximizar e a conversa irá inicializar automaticamente
});
</script>
Controle do aplicativo:
// Maximizar aplicativo
movideskChatWidgetChangeWindowState('maximized');
// Minimizar o aplicativo
movideskChatWidgetChangeWindowState('minimized');
// Para controlar a visibilidade do aplicativo você poderá manipular diretamente o elemento
// Exemplos:
// Para o aplicativo inicializar oculto você poderá incluir o CSS entre as tags <head> e </head> de seu site
<style type="text/css">
.md-chat-widget-wrapper {
visibility: hidden;
}
</style>
// Mostrar o aplicativo (via Javascript)
document.getElementById("md-app-widget").style.visibility = "visible";
// Ocultar o aplicativo (via Javascript)
document.getElementById("md-app-widget").style.visibility = "hidden";