A integração de domínios Movidesk permite melhor alinhamento das demandas geradas entre dois diferentes domínios Movidesk que possuem alguma ligação. Esta integração permite que quando uma solicitação for aberta por um cliente, o agente possa registrar o problema também em outra base através do ticket aberto no Movidesk e encaminhá-lo para tratamento em outro domínio. Por sua vez, após solucionar a questão, a equipe da base integrada poderá adicionar ações, ou mesmo, alterar o status do ticket diretamente do outro domínio Movidesk.
Como agente, é possível criar um novo ticket na base integrada a partir de um ticket do Movidesk origem, ou vincular com link uma demanda tratada na outra base através de um ticket. A integração permite, então, utilizar o link para rastrear todo o progresso realizado pela equipe responsável sobre a solução do problema.
Configurando a integração de domínios Movidesk
Antes de mais nada, verifique se há um token gerado em seu sistema. Para tal procedimento, acesse a tela de parâmetros do sistema e selecione a aba "Ambiente". Utilize a barra de rolagem para descer até o final da página. Caso o campo "Chave da API" esteja em branco, clique em "Gerar nova chave".
ATENÇÃO: Este procedimento é muito importante para que a integração possa ser concluída com sucesso.
Após verificar (ou gerar) o token do seu Movidesk, a configuração de fato, pode ser iniciada. Para isso, a partir da tela principal do sistema, basta acessar "Configurações" e no menu "Integrações", acessar "Central de integrações" e clicar sobre o ícone 
NOTA: Caso o menu integrações não esteja sendo exibido, você deverá habilitar o parâmetro "Permitir acessar a central de integrações", na guia "Configurações", em "Perfis de acesso".
Executado o procedimento anterior, o sistema apresentará a tela para configuração da integração. Na guia "Principal", defina um nome para a integração cadastrada (no exemplo abaixo, nomeamos como Movi-Movi). Depois, você deve selecionar a opção "Movidesk" clicando na caixa de tipo de integração (por padrão, o sistema traz como primeira opção a integração ao Pipedrive) e em seguida, marque o checkbox "Integração habilitada".
Tendo realizado as configurações na guia principal, selecione a guia "Dados para conexão". Nesta guia, informe a URL do domínio Movidesk ao qual deseja integrar e o token do mesmo.
A próxima guia a ser definida, é a de configurações da integração. Nesta aba você define de que forma funcionará esta integração, se automaticamente (ou não) e ainda, se deseja enviar as alterações de status do ticket aberto em sua base para o ticket aberto no domínio integrado.
- ENVIAR ALTERAÇÕES DE STATUS DO TICKET ABERTO EM SUA BASE PARA O TICKET ABERTO EM OUTRO DOMÍNIO MOVIDESK - Se este parâmetro estiver marcado, todas as alterações de status que ocorrerem no ticket cadastrado em sua base serão enviadas para outro domínio Movidesk, obedecendo a correlação estabelecida. Do contrário, apenas a reabertura de um ticket será enviada para o domínio integrado. As demais alterações de status no ticket serão ignoradas.
- INTEGRAÇÃO AUTOMÁTICA - Se este parâmetro estiver marcado, a integração ocorrerá de forma automática quando as condições forem atingidas. Caso contrário, quando as condições forem atingidas, o sistema somente exibirá uma área onde o agente poderá optar por enviar o ticket para outro domínio Movidesk ou não. A integração automática sempre irá gerar um novo ticket no domínio Movidesk integrado, enquanto que a integração manual permite que o agente opte entre criar um novo ticket, ou associar o ticket a um ticket já existente na outra base.
Também é possível definir um agente como gerador do ticket. Caso a sua integração seja automática, o Movidesk sempre registrará este agente como gerador do ticket. Caso sua integração seja manual, o Movidesk buscará o gerador do ticket através da correlação do campo “Agente”. Se não houver correlação, o sistema utilizará este agente como o gerador.
O último parâmetro a ser configurado nesta guia é a definição da chave para localização do cliente no domínio Movidesk integrado. É importante mencionar que ao gerar um ticket, o sistema buscará os clientes no domínio Movidesk integrado ao seu considerando a chave informada.
Após ajustar as configurações da integração, é possível apontar condições para definir quando a integração será executada (quando de forma automática) ou terá os campos exibidos, possibilitando o vínculo a um ticket existente ou criação de um novo ticket no domínio integrado ao seu Movidesk (quando de forma manual). Essas configurações se dão na guia "Condições" e caso forem deixadas em branco, a integração não fará distinção entre os tickets, integrando todo e qualquer ticket.
NOTA: Apesar de semelhante aos gatilhos, estas condições não necessitam do validador (
Por fim, utilize a guia "Correlação entre campos" para definir a ligação dos campos do seu Movidesk com os campos do domínio Movidesk integrado. Você pode correlacionar status, categoria, urgência, agente (esta correlação aponta o responsável pelo ticket gerado pela integração através do ticket em seu Movidesk. Não é necessário que o agente seja o mesmo nos dois domínios) e campos adicionais (caso deseje integrar estas informações). Os campos à esquerda correspondem à base integrada, enquanto os da direita referem-se ao seu Movidesk. A correta configuração destes campos é muito importante para que a integração ocorra da maneira desejada.
IMPORTANTE: As informações sobre campos adicionais, bem como urgência e categoria, são enviadas do Movidesk para a base integrada apenas no momento de abertura do ticket. Após estabelecida a integração, as alterações realizadas nestes campos não são espelhadas, com exceção às alterações em campos adicionais nos tickets da base integrada (que quando editados, enviarão os dados atualizados para os tickets do seu Movidesk quando uma nova ação for apontada).
Ao finalizar as configurações da integração no Movidesk, clique em 
ATENÇÃO: Após salvar a integração, o Movidesk criará automaticamente um novo gatilho padrão já habilitado no domínio integrado ao seu. Este gatilho garantirá o funcionamento da webhook que possibilita que as informações cadastradas na base integrada sejam enviadas ao seu Movidesk.
Para que o gatilho funcione corretamente, é necessário realizar uma edição na ação predefinida pelo sistema. Basta substituir a palavra “TOKEN” pela chave API do seu Movidesk.
Desta forma:
Realizada a edição do gatilho, basta salvá-lo. Tendo efetuado este procedimento, a integração estará completa e pronta para uso.
Gerando um ticket no domínio integrado através de um ticket do Movidesk
Conforme visto anteriormente, existem duas maneiras de definição para abertura de tickets através da integração, sendo uma delas de forma automática e outra manualmente.
Quando de maneira automática, sempre que um ticket atingir as condições da integração, um novo ticket será instantaneamente criado na base integrada e vinculado ao ticket de origem. No exemplo abaixo, estamos criando um novo ticket (vale ressaltar que a integração automática também ocorre em tickets já abertos, desde que atinjam as condições para integração pré-configuradas). Note que a tela do ticket está com a sua exibição padrão, sem qualquer campo referente a outro domínio.
NOTA: Ao criar um novo ticket no domínio integrado, o Movidesk validará o tipo da ação e do ticket no seu Movidesk, respeitando-as e espelhando-as no destino. Todas as iterações seguintes serão enviadas de um tenant ao outro como ações internas, independentemente do seu tipo original.
Ao clicar em "Salvar", as condições da integração do exemplo foram alcançadas e uma novo ticket foi aberto na base integrada. Observe que o ticket já apresenta um bloco com informações acerca da integração ao lado esquerdo da tela, inclusive com um link direto para acesso ao ticket gerado, logo abaixo da numeração do ticket de origem.
Veja que ao verificar o histórico de alterações do ticket, o sistema também informa quando foi criada um novo ticket na base integrada, bem como, o número do mesmo.
Quando definido que a integração acontecerá manualmente, o bloco dedicado à integração será exibido sempre que as condições pré-configuradas forem atingidas (assim como funciona no modo automático), porém ao contrário da alternativa anterior, um ticket não será gerado automaticamente. Neste caso, o agente poderá optar entre associar o ticket a algum já existente no outro domínio, criar um novo a partir do ticket, ou ainda, simplesmente não gerar integração caso não julgue necessário.
Caso você decida por criar um novo ticket, basta clicar em “Criar ticket” e o sistema exibirá uma janela para confirmação dos dados. Clique em “Salvar” para gerar o novo ticket.
Numa situação hipotética, onde um novo ticket no Movidesk é aberto para tratar de um problema que já esteja cadastrado na outra base, a opção "Associar ticket" pode ser a melhor opção. Basta informar o número do ticket a ser vinculado e você evitará a abertura de uma nova demanda para o mesmo problema.
Veja que após salvar, o vínculo foi gerado e é informado no bloco da integração, dentro da tela do ticket. Repare que é exibida a opção "Remover link" e você pode desassociar os tickets se assim desejar.
No histórico de alterações do ticket, observe que a integração é informada. Atente para o detalhe da informação de que maneira se criou o elo entre os tickets. O sistema difere as alternativas automática e manual e as especifica dentro das alterações.
Veja o exemplo a seguir. Vamos cadastrar uma ação no ticket do Movidesk e validar a importação para o ticket aberto no domínio integrado.
Repare que a ação foi incluída no ticket.
Agora, verificando o ticket na base integrada do Movidesk, observamos que a ação foi corretamente importada.
Validaremos agora o caminho oposto. Vamos adicionar um comentário no ticket do domínio integrado e verificar a importação no ticket de origem (esta ação por padrão será tratada como interna no Movidesk, independentemente do tipo da ação apontada no ticket da base integrada (pública ou privada)).
Observe que a ação foi cadastrada corretamente na base integrada.
Também alteramos o status do ticket e isso deverá ser espelhado automaticamente no ticket de origem de acordo com a correlação definida.
Veja que o status do ticket da base integrada foi alterado.
Tendo realizado as alterações na base integrada, vamos verificar o comportamento do ticket no Movidesk origem. Observe que o sistema aponta que o ticket sofreu alterações. Clique sobre o alerta e verifique as ações apontadas no ticket. Note que a ação inserida no ticket foi incorporada ao ticket em forma de ação interna.
Tanto o status do ticket origem, quanto o do ticket integrado (exibido na caixa de integração), também foram atualizados com sucesso.
Extra - Opções da central de integrações
Acessando a central de integrações do Movidesk, além de cadastrar uma nova integração, através da caixa de opções é possível realizar o procedimento de clonagem de integrações, habilitar, desabilitar e excluir integrações, bem como, exportar estes dados para Microsoft Excel.
