1. Como encontro meu token (chave) da API?

Para localizar seu token da API:

1. Clique em Configurações (ícone de engrenagem).
2. Em Conta, acesse Parâmetros.
3. O token estará visível na aba Ambiente. Role a página até a seção API, onde será exibida a sua chave de acesso (token).

2. Como exportar minha base de clientes?

1. Acesse Configurações > Pessoas.
2. Clique no ícone de filtro, aplique os filtros desejados e clique em Pesquisar.
3. Em seguida, selecione os registros que deseja exportar.
4. No menu Opções, escolha Exportar pessoas e selecione o formato desejado (CSV ou Excel).

3. Como alterar o perfil de um usuário para que ele possa abrir tickets?

Acesse Configurações > Pessoas, edite o cadastro do usuário e altere o tipo de Agente para Agente/Cliente.

4. Como alterar o nome exibido de um agente sem mudar o login?

Em Configurações > Pessoas, edite o campo Nome/Razão Social do agente. Essa alteração muda apenas o nome exibido, não o login.

5. Como criar uma nova organização (empresa)?

Vá em Configurações Pessoas > Novo > selecione o tipo Empresa. Depois, vincule as pessoas dessa organização.

6. Como cadastrar feriados móveis, como Carnaval?

Feriados com data variável devem ser cadastrados manualmente a cada ano em Configurações > Feriados. Os do ano anterior podem ser desativados.

7. Como saber quantas licenças de agentes tenho disponíveis?

O total de licenças contratadas e utilizadas pode ser consultado junto ao suporte Movidesk ou com o gerente da conta.

8. Como permitir que um agente veja todos os tickets da equipe ou organização?

1. Crie ou edite um perfil de acesso acessando Configurações > Perfis de acesso
2. Acesse o perfil e, na aba Políticas de Acesso, configure a regra para permitir visualização de todos os tickets da equipe ou organização.

Dúvidas sobre Tickets e API do Movidesk

1. Como consultar o histórico completo de tickets via API?

Use as rotas /tickets e /tickets/past para buscar tickets ativos e históricos. Combine os resultados para obter a base completa.

2. Como obter o histórico de ações ou conversas de um ticket via API?

Utilize:

/api/v1/tickets?$expand=actions($select=description,createdDate)

3. Como encontrar o ID de um campo adicional?

O ID aparece na URL ao editar o campo em Configurações > Campos Adicionais. Não há endpoint específico para listagem.

4. Como extrair campos personalizados via API?

Use o parâmetro $expand=customFieldValues e filtre por customFieldId.

5. Como consultar a organização do cliente via API?

Use o expand correto:

&$expand=clients($expand=organization($select=businessName))

6. Como realizar paginação para grandes volumes de dados via API?

Combine $skip e $top em um loop até percorrer todos os registros.

7. Como impedir que e-mails de desconhecidos criem novos usuários automaticamente?

Não é possível impedir a criação, mas é possível configurar em Configurações > Regras para associação para vincular novos usuários a uma organização padrão.

8. Como entender o cálculo do SLA com pausas e horários úteis?

O SLA considera apenas horas de atendimento definidas no calendário e é pausado conforme os status configurados. Exemplo: status “Aguardando retorno do cliente” pausa o SLA, se habilitado.

9. Por que o SLA não pausou corretamente?

Verifique:

1. Se o status está configurado para pausar.
2. Se o ticket pertence ao contrato de SLA correto.
3. Se houve edição manual do prazo.

10. Como isolar a visualização de tickets entre agentes da mesma equipe?

Crie uma regra em Políticas de Acesso:

“Responsável pelo ticket” → “É igual a” → “Agente logado”.

11. Como filtrar tickets por agente que realizou uma ação (e não o responsável)?

Use o filtro:

&$filter=actions/any(a: a/createdBy/id eq 'ID_DO_AGENTE')

12. Como entender por que um agente não consegue mudar o status de um ticket?

Verifique:

1. Se o fluxo de status permite a transição.
2. Se o perfil de acesso do agente tem permissão para essa ação.