Este artigo foi criado para ajudá-lo a identificar e resolver os problemas mais comuns encontrados nas Integrações do Movidesk. Os pontos abaixo reúnem situações comuns que podem impactar no funcionamento das Integrações. 

1. Por que o status do meu ticket Movidesk não atualiza quando a issue do Jira muda?

Os Webhooks são responsáveis por notificar o Movidesk quando uma issue muda no Jira. Sem eles, não há atualização automática. Se o seu status do ticket de Movidesk não atualiza quando a issue do Jira muda, deve ser por falhas na configuração dos webhooks. Para verificar essa configuração, siga os passos abaixo:

• Verifique a Configuração no Jira: em Projeto > Fluxos de Trabalho > Editar.
• Post Functions: Em cada transição de status (ex: “To Do” → “In Progress”), confira se existe uma Post Function que chama a URL do webhook do Movidesk.
• URL Correta: Encontre a URL do webhook na Central de Integrações do Movidesk e confirme que está igual no Jira.
  

Fique atento! Os erros mais comuns são: Ausência de Post Function, URL incorreta ou erros de autenticação.

2. Os projetos do Jira não aparecem no Movidesk. Como corrigir?

Verifique os seguintes pontos:

• Token de API: Confirme se foi copiado corretamente e ainda é válido.
• URL do Jira: Use apenas o domínio principal (ex: https://suaempresa.atlassian.net/), sem caminhos adicionais.
• Permissões: O usuário do Jira precisa ser administrador do projeto desejado.
• Tipo de Projeto: A integração funciona apenas com projetos Clássicos.
• Autopreenchimento: Digite a URL e o usuário manualmente para evitar caracteres invisíveis.

3. Por que as imagens dos meus tickets aparecem quebradas em outras ferramentas, por exemplo no Jira?

As imagens coladas diretamente no corpo da ação têm links temporários por segurança, que sistemas externos não conseguem acessar.

Para isso, adicione imagens como Anexos na ação do ticket, anexos são transferidos diretamente e permanecem visíveis.

4. Recebo o erro “Campo X é necessário” ao criar uma issue no Jira. Por quê?

Porque o projeto do Jira contém campos obrigatórios que não estão sendo preenchidos pelo Movidesk.

• Opção A (Recomendada): Crie os mesmos campos no Movidesk (mesmo nome e tipo) e faça o mapeamento na Central de Integrações.
• Opção B: Altere o Jira para tornar os campos opcionais.

5. Por que e-mails automáticos do Jira não abrem tickets?

E-mails com cabeçalhos de resposta automática (X-Auto-Response-Suppress) são intencionalmente ignorados para evitar loops. Isso inclui notificações automáticas e e-mails de recuperação de senha. Esse comportamento não pode ser alterado.

6. Os comentários do Jira aparecem duplicados no meu ticket. Como resolver?

Isso pode ocorrer por instabilidades momentâneas entre as plataformas. Se acontecer em apenas um ticket, tende a não se repetir.

Se for recorrente, verifique os webhooks no Jira para garantir que não existem regras duplicadas para a mesma transição.

 7. A opção de integrar com o Jira desapareceu do meu ticket. Por quê?

Primeiramente, verifique as condições da integração, na Central de Integrações, se o ticket atual atende às condições definidas, por exemplo, categoria, status, responsável.

Logo após, veja se a issue foi excluída ou movida, caso a issue vinculada tenha sido excluída ou movida, o vínculo quebra. Pode ser necessário clonar o ticket para recriar o vínculo.

8. Recebo erros genéricos ao criar issues no Jira. Como identificar?

• Veja o Histórico de alterações do ticket para detalhes do erro.
• Verifique campos obrigatórios no Jira.
• Confirme se o Responsável está preenchido no ticket Movidesk.

9. Estou recebendo "Erro 500 ou falhas de login" na integração com Active Directory. O que fazer?

Use este checklist de diagnóstico:

• Conexão: Verifique se o seu servidor AD (Active Directory) está online e acessível.
• Firewall: Libere os IPs do Movidesk:
  • 34.198.5.29
  • 52.3.134.169
  • 52.0.96.168
• Credenciais: Confirme se a senha do usuário de integração não expirou.
• Teste de Conexão: Na tela de autenticação, clique em Iniciar em para listar as OUs (Unidades Organizacionais). Se falhar, o problema é de conexão.

10.  Como posso filtrar a importação de usuários do Active Directory?

• Vá em Configurações > Pessoas > Importação de diretório e edite a regra.
• Em Unidade organizacional, selecione apenas as OUs (Unidades Organizacionais) desejadas.
• Se estiver importando múltiplas OUs, considere criar regras separadas para cada uma.

11. Estou recebendo erros na integração entre domínios Movidesk. Quais as causas comuns?

• Solicitante Inexistente: O usuário precisa existir nas duas bases (origem e destino) com a mesma chave (ex: e-mail).
• Permissões: Verifique se o perfil do solicitante na base de destino permite abertura de tickets.
• Campos Obrigatórios: Se a base de destino exige campos que não existem/mapeados na origem, a integração falhará.

12. Meu WhatsApp parou de funcionar. O que devo verificar?

Verifique os seguintes itens:

• Conta de E-mail: Veja se precisa reautorizar em Configurações > Contas de e-mail.
• Status do Broker: Valide em Configurações > WhatsApp.
• Migração de Broker: Caso tenha recebido comunicado sobre migração (Gupshup → Zenvia), confirme a conclusão.

Por fim, faça um teste e envie uma mensagem de um celular externo para checar se o bot responde.

13. Os tickets de telefonia não estão sendo criados. O que fazer?

• Verifique se o problema ocorre com outros agentes.
• Confirme o vínculo do seu usuário à integração de telefonia.
• Deslogue e logue novamente nas plataformas.
• Analise os logs da plataforma de telefonia.

14. Os dados do meu bot NLU não aparecem no ticket. Como diagnosticar?

• Valide o JSON: Confira a requisição POST enviada à API Movidesk — as variáveis (ex: <?$subjectTickets?>) devem estar corretas.
• Garanta que os campos adicionais existem no Movidesk.
• O createdBy.id precisa corresponder a um ID válido de pessoa.

15. A formatação (negrito, listas) das minhas macros não aparece no chat do cliente. Por quê?

A integração com o widget NLU só transmite texto puro. Formatações HTML não são renderizadas. Essa é uma limitação atual da integração.