API do Movidesk - Tickets
Essa documentação descreve os procedimentos para utilização da API de consulta, inclusão e alteração de tickets.
Fluxograma de API - Tickets
Neste artigo você irá ver os Primeiros Passos para construir sua API de Tickets.
Agora que você já sabe o que é API e como ela funciona, está na hora de ver o nosso fluxo da API de Tickets e como aplicar na prática para a construção da sua API de Tickets.Veja a imagem abaixo que é bem simples!
Você
API do Movidesk - Tickets/Merged
Importante: Nossas API's possuem um limite de 10 requisições por minuto para garantir um comportamento saudável no seu uso. Caso você tenha um cenário específico que precise aumentar este número, entre em contato com o nosso time de atendimento para a análise de viabilidade. Saiba mais sobre horário
Erros Frequentes - API de Tickets
Ao utilizar nossas APIs, podem ocorrer situações em que retorne alguma mensagem de erro por nossos sistemas, em resposta à consulta ou operação encaminhada para a API.
Neste artigo, você verá alguns dos casos mais comuns destes erros para a API de Tickets, em específico. O artigo está dividido em:
Parâmetros de SLA na API de Tickets
Parâmetros de SLA na API de Tickets
Este artigo visa auxiliar na correta interpretação dos dados de SLA (Service Level Agreement) disponíveis na API de Tickets do Movidesk, garantindo uma melhor gestão e análise das métricas de atendimento. Para acessar esses dados diretamente pelo sistema e obter
Tickets
Classificação
Qual a diferença entre ticket resolvido e ticket fechado?
Como visualizar os tickets resolvidos e fechados?
Qual a diferença entre ticket público e interno? E entre ações públicas e internas?
Como criar uma visualização tickets por equipe?
É possível resolver um ticket sem colocar uma
Material de apoio - API
Neste artigo, vamos abordar parametrizações que podem ser utilizadas nas APIs do Movidesk.
Parâmetros nativos OData
Operadores suportados nos filtros
Filtros com expressões lambda
Possibilidades de uso dos parâmetros de expansão
Funções nativas do OData suportadas
Exemplos de requisição
Lista de có
01 - Tickets
Os tickets representam cada solicitação recebida pelo suporte. Sempre que um cliente entra em contato, seja por chat, e-mail, telefone ou formulário, isso vira um ticket no sistema. Se o cliente tiver acesso direto à plataforma, ele mesmo pode abrir um ticket.
Como acessar um ticketNo menu de navega
Chamada de voz ativa nos Tickets
Atenda seus clientes realizando chamadas de voz ativa através do Movidesk. Monitore e registre informações ao final de todas as ligações nos Tickets de seus atendimentos.
As chamadas podem ser realizadas em novos tickets ou em tickets existentes que contenham o número telefônico do contato cadastrad
API de anexos
A API do Movidesk oferece funcionalidades que permitem consultar informações de anexos diretamente via requisições HTTP. Com essa API, é possível integrar e realizar o download dos anexos ao seu sistema, automatizando consultas e recuperando arquivos específicos.
Administração de APIsPara utilizar a
Como excluir tickets?
Você pode excluir tickets individualmente (na listagem ou no kanban) ou realizar manutenção coletiva (apenas na listagem).
É importante destacar que não é possível excluir tickets que estejam com status resolvido, fechado ou cancelado. Neste caso, o ticket deverá ser reaberto, para poder ser excluí
©WhatsApp Business API Movidesk
Este documento é um guia completo sobre configurações e regras relacionadas ao WhatsApp API no Movidesk.
Neste artigo você encontrará conteúdo sobre:
Como configurar o WhatsApp Business API Movidesk
- Configurando grupos de chat
- Por dentro do painel de configurações do WhatsApp Business API Movide
Como adicionar um anexo via API
Para incluir um anexo em um ticket pré-existente via API, utilize a requisição abaixo via método POST:
https://api.movidesk.com/public/v1/ticketFileUpload?token=[TOKEN]&id=[NUMERO_TICKET]&actionId=[NUMERO_ACAO]
No seu Postman na aba "Headers" selecione as seguintes opções:
KEY - Content-Type
VALU
API do Movidesk: o que é e como funciona?
A API (Application Programming Interface, ou Interface de Programação de Aplicativos) é um conjunto de regras e protocolos que permitem a comunicação entre diferentes sistemas.
No contexto do Movidesk, a API possibilita que seu sistema se conecte ao Movidesk para automatizar tarefas e obter dados,
API do Movidesk - Serviços
Essa documentação descreve os procedimentos para utilização da API de inclusão, alteração consulta e exclusão dos serviços.
03 - Distribuição de tickets
A distribuição automática de tickets é mais um grande recurso do Movidesk. Esta funcionalidade representa um ganho em agilidade de distribuição de demandas de forma precisa e eficaz.
Dúvidas frequentes sobre tickets
1. Como gero uma relação de tickets de uma categoria específica em CSV?Vá para a listagem de tickets.Clique em Filtros e selecione a categoria desejada.
Clique em Opções > Exportar todos os tickets e escolha CSV ou XLSX (Excel).
2. Como crio um painel para ver os tickets da minha equipe? Onde fica a
06 - Aprovação de tickets
Se você utiliza o Movidesk internamente na sua organização, ou mesmo se é um prestador de serviços que executa atividades com base na requisição dos colaboradores dos seus clientes, o módulo de aprovação de tickets poderá ser uma importante ferramenta para a sua organização. Com ele você poderá esta
Primeiros passos para construção de uma API
Neste artigo você irá ver os Primeiros Passos para construir sua API.
Agora que você já sabe o que é API e como ela funciona, está na hora de ver o nosso fluxo de Primeiros Passos para a construção da sua API.
Veja a imagem abaixo que é bem simples!
Para saber mais sobre cada uma delas, clique em
Horário e limite de acesso da API
Com objetivo de otimizar a nossa disponibilidade, resiliência e desempenho da plataforma, a Movidesk está aprimorando os mecanismos de acesso à informação.
Desde 01/04/2022, a nossa API (Application Programming Interface) passou a contar com um horário e limite de acesso diferenciados, distribuídos
Inteligência Artificial (IA) nos Tickets
Com o uso da Inteligência Artificial nos Tickets é possível obter insights, reduzir o tempo de atendimento e aumentar a agilidade na troca de informações entre agentes e clientes na Gestão de Atendimentos.
Você pode utilizar a funcionalidade de 3 formas diferentes:
Análise gerada por IAPerguntas par
02 - Variáveis relacionadas aos tickets
Aqui você pode consultar todas as variáveis de tickets que podem ser utilizadas no Movidesk. É possível usar as variáveis nas macros de ticket, nas mensagens configuráveis do grupo de chat e nos templates de HSM do ©WhatsApp Business Movidesk.
INFORMAÇÕES GERAIS DO TICKET
Assunto do ticket
ticke
Resolução de problemas em tickets
Este artigo foi criado para ajudá-lo a identificar e resolver os problemas mais comuns encontrados ao trabalhar com tickets no Movidesk. Aqui você encontrará orientações sobre erros de abertura, atualização, visualização, gatilhos, campos adicionais, exportações e outros possíveis problemas.
1. Meu
05 - Mesclar e Desmesclar Tickets
Esse artigo descreve os precedimentos para utilização da funcionalidade de Mesclar tickets. Um importante recurso para unificar tickets repetidos.
API do Movidesk - Pessoas
Essa documentação descreve os procedimentos para utilização da API de inclusão, alteração consulta e exclusão de pessoas.
Integração do Power BI com a API do Movidesk
Neste artigo, você vai ver como extrair dados do Movidesk via API e integrar com o Power BI.
É possível integrar o Movidesk com o Power BI para ter mais opções de indicadores e relatórios.
No Power BI, clique em Obter Dados e então selecione a opção Web.
Na nova janela, selecione a opção Básico
03 - Quais tickets tenho por serviço?
Resumo de Tickets por Serviço
Com o relatório de tickets por serviço, podemos obter uma visão quantitativa de todos os tickets do período, agrupados por serviço, status e prazos de SLA. Visão Geral do RelatórioPermitir Acesso ao RelatórioFiltros e PeríodosExportar DadosGerar relatório
⚓Visão Geral d
01- Quantos tickets tenho por cliente?
Tickets por Cliente
O relatório de Tickets por Cliente, permite visualizar a relação de tickets que cada cliente abriu na sua estrutura de atendimento, de acordo com o filtros aplicados.
Visão Geral do Relatório
Filtros e Períodos
Exportar Dados
Gerar Relatório
Visão Geral do Relatório
Para veri
Como filtrar tickets resolvidos com pesquisa respondida?
Para filtrar tickets resolvidos em um determinado período e que contenham a pesquisa de satisfação respondida no seu Movidesk, você deverá criar uma pesquisa nos indicadores, para isso acesse indicadores, clique na opção alterar painéis de indicadores. Na parte de pesquisas pressione o botão de par
Relatórios Personalizados: Como criar e exportar tickets
A funcionalidade de Relatórios personalizados permite gerar e exportar dados com filtros à sua escolha, proporcionando uma visão detalhada dos seus tickets para uma gestão de atendimentos mais eficiente.
⚠️ Atenção: Disponível apenas para usuários com perfil de Agente.
Habilitar a configuraçãoPara a
03 - Como utilizar os status em tickets
Neste artigo, aprenda a utilizar e configurar os status dos tickets na Movidesk.
Os status são essenciais para gerenciar o ciclo de vida de um ticket, ajudando a organizar, priorizar e acompanhar os atendimentos. Cada ticket precisa ter um status, que indica sua situação atual. Além dos status padrõ
05 - SLA de Solução aplicado nos tickets
Após cadastrar e configurar os contratos e regras de SLA, o sistema estará apto a definir o vencimento nos tickets.
Dentro do ticket, o SLA de Solução é apresentado no campo “Previsão de Solução”. Este campo será preenchido automaticamente sempre que o ticket atender às condições de alguma regra cad
Como visualizar os tickets resolvidos e fechados?
Para visualizar todos os seus tickets resolvidos e/ou fechados, você pode criar um painel personalizado. Para isso, vá na aba tickets, no menu lateral. No painel do agente, você pode clicar em personalizar visualizações, ao final da listagem de visualizações. Clique no ícone +, para criar uma nova.
Como permitir que um agente exclua tickets?
Por padrão todo perfil de acesso de agentes virá com a opção de excluir tickets desabilitada, mas você pode editar ou criar um novo perfil de acesso para configurar essa opção.
Clique em configurações, e no menu pessoas acesse perfis de acesso.
Dentro do perfil de acesso, clique na aba tickets e vá
Todo agente possui permissão para clonar tickets?
A permissão para clonar tickets não é realizada através de um botão específico, mas sim com base nas regras de políticas de acesso definidas no perfil de acesso do agente.
Neste caso, o agente poderá clonar os tickets em que possui permissão de acesso ou que cumpram as regras definidas.
Como remover uma abertura programada de tickets?
É necessário localizar o ticket que contém a programação de abertura de tickets.
Neste caso, poderá criar uma nova visualização apenas para filtrar os tickets que foram criados por Agendamento automático, clicando em Painel de Tickets e em seguida em "Personalizar Visualizações":
Após irá criar
Fluxograma de API - Serviços
Neste artigo você irá ver os Primeiros Passos para construir sua API de Serviços.
Agora que você já sabe o que é API e como ela funciona, está na hora de ver o nosso fluxo da API de Pessoas e como aplicar na prática para a construção da sua API de Serviços.
Veja a imagem abaixo que é bem simples!
Fluxograma de API - Pessoas
Neste artigo você irá ver os Primeiros Passos para construir sua API de Pessoas.
Agora que você já sabe o que é API e como ela funciona, está na hora de ver o nosso fluxo da API de Pessoas e como aplicar na prática para a construção da sua API de Pessoas.Veja a imagem abaixo que é bem simples!
Você
API do Movidesk - Atividades
Importante: Nossas API's possuem um limite de 10 requisições por minuto para garantir um comportamento saudável no seu uso. Caso você tenha um cenário específico que precise aumentar o uso, entre em contato com o nosso time de atendimento para análise de viabilidade. Saiba mais sobre horários e limi
Fluxograma de API - Atividades
Neste artigo você irá ver os Primeiros Passos para construir sua API de Atividades.
Agora que você já sabe o que é API e como ela funciona, está na hora de ver o nosso fluxo da API de Atividades e como aplicar na prática para a construção da sua API de Atividades.
Veja a imagem abaixo que é bem simp
Novas regras do painel e visualizações de tickets
Neste artigo, veja as atualizações de regras e fluxos do Painel de Tickets, incluindo mudanças na jornada de exportação e nas configurações das visualizações em modos Kanban e Listagem.
Requisitos obrigatórios para exportaçãoAntes de solicitar a exportação, faça as seguintes validações:
1. Filtro po
02 - Introdução aos tickets / Introducción a las entradas
🇧🇷 Português / 🇨🇴 🇲🇽 Español
Este treinamento gravado ensina como trabalhar com tickets, abordando temas como classificação de tickets, abertura, campos adicionais e visualizações nos painéis.
É importante que você se dedique a estes treinamentos, para que seu tempo de reunião com o ISM (Imple
Como obrigar o apontamento de horas nos tickets?
No sistema é possível habilitar o módulo de apontamento de horas e para obrigar o seu agente a inserir no ticket as horas trabalhadas, acesse configurações > pessoas > perfis de acesso. Abra o perfil de agente e na aba apontamentos localize o parâmetro permitir o apontamento de horas nos tickets e m
Como criar uma visualização de tickets por equipe?
Para criar uma visualização dentro de tickets, vá no ícone tickets, no menu lateral esquerdo do Movidesk. Clique em personalizar visualizações. Na nova aba aberta, escolha o painel que deseja criar a visualização. Clique no ícone + na parte superior do menu. Preencha o nome e as definições da visual
Como restringir a visualização de tickets por equipe?
Essa restrição será realizada com base na equipe responsável pelo ticket, porém tickets sem responsável também não serão visualizados (se assim desejado).
Para iniciar este tipo de configuração, é necessário que cada equipe possua seu perfil de acesso. No nosso exemplo, trabalharemos com a "Equipe A
Como utilizar Funções na API
Neste artigo você irá ver como podem ser utilizadas as funções na API.
Agora que você já sabe o que é API e como ela funciona, está na hora de aperfeiçoar suas API's utilizando as funções da API e com exemplos práticos aplicando na prática.
Veja a imagem abaixo que é bem simples!
Qual a diferença dos canais de abertura de tickets?
Formulário de contato: Quando se utiliza formulário da Movidesk embutido em algum site e quando preenchido este formulário irá gerar um ticket.
Aberto via Cliente: Quando o cliente com login e senha entrar dentro do sistema Movidesk e efetuar a abertura de um ticket.
Aberto via Agente: Quando o A
Fluxograma de API - Contrato de horas
Neste artigo você irá ver os Primeiros Passos para construir sua API - Contrato de horas.
Agora que você já sabe o que é API e como ela funciona, está na hora de ver o nosso fluxo de API - Contrato de horas e como aplicar na prática para a construção da sua API - Contrato de horas.
Veja a imagem aba
Julho/2025
🚀 Atualizações de JulhoEste mês, a base de conhecimento foi atualizada com respostas a dúvidas frequentes e explicações complementares para facilitar o uso do Movidesk. Confira os principais pontos de atenção:
1. Tickets: Como funciona a priorização na distribuição de tickets?📌 Você pode ativar d
Dúvidas sobre gerenciamento, configurações e acessos
1. Como encontro meu token (chave) da API?Para localizar seu token da API:
Clique em Configurações (ícone de engrenagem).Em Conta, acesse Parâmetros.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 c
Janeiro / 2025
🚀 Atualizações de JaneiroFique por dentro de todos os lançamentos, atualizações e novos recursos disponíveis.
📣 Qual é a atualização?
Alteração na exportação de tickets 🚀 Novos recursos:
Alteramos a jornada de exportação de tickets, agora é possível exportá-los por meio dos relatórios personali
Janeiro / 2024
🌎 By Humanz for Humans: O que há de novo no mundo Zenvia?
Nós da Zenvia acreditamos na evolução tecnológica combinada com a experiência humana.
Por isso, todos os meses aprimoramos nossos produtos com novas funcionalidades e recursos.
🚀 Confira o que há de novo em Janeiro
Fique por dentro de todo
Como solicitar sua conta WhatsApp Business API?
Este artigo possui informações necessárias para configurar a integração do WhatsApp Business com o Movidesk.
Para utilizar o WhatsApp Business Movidesk na sua empresa, precisamos solicitar ao WhatsApp uma conta do tipo WhatsApp Business API para um número fixo ou móvel que pertence à você. Para essa
API do Movidesk - Pesquisa de satisfação - Respostas
Importante: Nossas API's possuem um limite de 10 requisições por minuto para garantir um comportamento saudável no seu uso. Caso você tenha um cenário específico que precise aumentar o uso, entre em contato com o nosso time de atendimento para análise de viabilidade. Saiba mais sobre horários e limi
API do Movidesk - Pesquisa de satisfação - Perguntas
Importante: Nossas API's possuem um limite de 10 requisições por minuto para garantir um comportamento saudável no seu uso. Caso você tenha um cenário específico que precise aumentar o uso, entre em contato com o nosso time de atendimento para análise de viabilidade. Saiba mais sobre horários e limi
Agosto / 2024
O que há de novo na nossa plataforma
Aprimoramos nosso produto com um novo recurso. Confira:
🚀 Atualização de Agosto
📣 Qual é a atualização?
Nova API de Mescla de Tickets
🚀 Novos recursos: Tenha visibilidade dos tickets mesclados com a API no Movidesk: API do Movidesk - Tickets/Merged
🕓 Efetivo
[FAQ] - Duvidas Frequentes sobre - Campos Adicionais
Lista de FAQs sobre Campos Adicionais
É possível customizar os indicadores para que apresentem dados dos campos adicionais?
É possível fazer integração dos campos adicionais para pessoas com um CRM por API para puxar dados?
É normal, ao deixarmos campos adicionais somente para agentes, eles não apar
Resolução de problemas de Gerenciamento, Configurações e Acessos
1. Minha requisição funcionava antes, mas agora retorna erro 500. O que aconteceu?Esse erro geralmente está ligado a timeout por excesso de dados na consulta. Antes de abrir um chamado, tente seguir este checklist:
Reduza o intervalo de datas na requisição;Use a rota /tickets/past para buscar dados
Agosto/2025
Este mês, implementamos melhorias no Movidesk para otimizar o uso software. Além disso, a base de conhecimento foi atualizada com respostas a dúvidas frequentes e explicações complementares, facilitando a utilização do sistema.
Status: 400 Bad Request, com dados: "The $select parameter is required."
Status: 400 Bad Request, com dados: "The $select parameter is required."
Motivo
Quando a API de Tickets for utilizada com requisições GET para listas de tickets (ou seja, sem passar o parâmetro de “id” na URI da requisição), é obrigatório definir o parâmetro de “$select” em sua consulta, para especi
Fluxograma de API - Telefonia - Sem controle de fila
Neste artigo você irá ver os Primeiros Passos para construir sua API de Telefonia - Sem controle de fila.
Agora que você já sabe o que é API e como ela funciona, está na hora de ver o nosso fluxo da API de Telefonia - Sem controle de fila e como aplicar na prática para a construção da sua API de Tel
Fluxograma de API - Telefonia - Com controle de fila
Neste artigo você irá ver os primeiros passos para construir sua API de Telefonia - Com controle de fila.
Agora que você já sabe o que é API e como ela funciona, está na hora de ver o nosso fluxo da API de Telefonia - Com controle de fila e como aplicar na prática para a construção da sua API de Tel
Fluxograma de API - Consumo de Contrato de horas
Neste artigo você irá ver os Primeiros Passos para construir sua API - Consumo de Contrato de horas.
Agora que você já sabe o que é API e como ela funciona, está na hora de ver o nosso fluxo de API - Contrato de horas e como aplicar na prática para a construção da sua API - Consumo de Contrato de ho
Como impossibilitar um agente de editar a previsão de solução dos tickets?
Para impedir que um agente possa editar a previsão de solução nos tickets (representado pelo lápis, como mostra a imagem abaixo), é preciso alterar a configuração do perfil de acesso desse agente.
Vá em Configurações > Pessoas > Perfil de Acesso e selecione o perfil que deseja editar.
Na aba Tickets
Campos de ENUM: O que são, quais temos, e como utilizá-los em filtros
Neste artigo, iremos abordar o tópico de Enumerações utilizadas em nossas APIs do Movidesk.
Ao longo do artigo, trataremos sobre:
O que são ENUMS
ENUMS utilizados nas APIs do Movidesk
Como utilizar os ENUMs em suas buscas da API
O que são ENUMS
ENUM é um nome dado para campos com “enumeração” n
Dúvidas frequentes sobre Integrações
Este artigo reúne as principais dúvidas que podem surgir durante o uso das Integrações no Movidesk. Aqui você encontra soluções rápidas, dicas de interpretação e links para artigos com o passo a passo completo.
1. O Movidesk possui integração nativa com o Microsoft Teams?Atualmente, não possuímos u
04 - Qual o tempo de permanência dos tickets em cada etapa do atendimento?
Tempo de Permanência dos Tickets por Status
Com o relatório de tempo de permanência, podemos visualizar quanto tempo cada ticket permanece em cada etapa do atendimento.
Visão Geral do Relatório
Permitir Acesso ao Relatório
Filtros e Períodos
Exportar Dados
Gerar Relatório
Visão Geral do Relatório
Outubro/2022
Demandas Solucionadas:
Corrigimos o bloqueio de endereços de e-mail a partir de ticket para que funcione corretamente quando for definido para que o cliente do ticket também seja excluído;
Corrigimos o funcionamento do ticket para que o botão de atualização sempre seja exibido quando haver algum
Conceito de $Skip e $top
Vamos entender um pouco mais em qual momento devemos utilizar estes dois parâmetros em consultas de API
Para utilização de API's aconselhamos a utilização de programas específicos que conseguem ler esses dados RESTful com facilidade. No Service, utilizamos diariamente a ferramenta chamada "Postma
Dezembro/2022
Demandas Solucionadas:
Corrigimos a execução da macro para que ela altere corretamente o status do ticket, quando essa for uma ação solicitada;
Corrigimos as notificações de e-mail para deixar de exibir erroneamente falhas de conexão em contas @movidesk;
Corrigimos o funcionamento dos marcos de suce
Integração com a API Oficial da Meta - Módulo de WhatsApp
Não tenho a página (business id) do Facebook verificada:
Para nova integração com a API oficial da Meta, siga os passos abaixo:
É necessário ter a página verificada e cumprir com as condições comerciais impostas pela Meta. A verificação é de responsabilidade da empresa. Para verificar a página é nec
API do Movidesk - Consulta de Artigos da base de conhecimento
A API do Movidesk oferece funcionalidades que permitem consultar informações da Base de Conhecimento diretamente via requisições HTTP. Com essa API, é possível integrar a busca de artigos ao seu sistema, automatizando consultas e recuperando conteúdos específicos.
Administração de APIs .Para utiliza
Como Migrar Árvores de Serviços Utilizando a API do Movidesk
Este artigo explica como migrar árvores de serviços no Movidesk utilizando a API, com o método PATCH através da ferramenta Postman.
Passos para Migrar Árvores de Serviços
Obtenha o ID do Serviço:
Acesse as configurações do Movidesk.
Navegue até Configurações > Serviços.
Localize o ID do serviço na
Solicitações de Serviço Movidesk
Neste artigo, vamos de apresentar os principais cenários nos quais nossa equipe está à disposição para atender às suas solicitações.
Listamos abaixo, serviços que são realizados pela equipe. Caso sua solicitação não esteja na listagem, entre em contato com nosso atendimento! 😊
Solicitações de Serv