API do Movidesk - Tickets
Essa documentação descreve os procedimentos para utilização da API de consulta, inclusão e alteração de tickets.
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
©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
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.
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
Ticket origem WhatsApp
Neste artigo você encontrará conteúdo sobre:
Visualizando listagem de tickets de origem WhatsApp
Interagindo com tickets de origem WhatsApp
Recebendo respostas do usuário para ação pública que inseri em um ticket
⚓Visualizando listagem de tickets de origem WhatsApp
Para visualizar os tickets orige
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ó
Qual a diferença entre ticket resolvido e ticket fechado?
Ticket resolvido é sempre o ticket que recebeu a última ação do agente, e foi considerado como solucionado.
Com este status, o ticket fica disponível para avaliação do cliente, que pode ainda concordar ou discordar da solução apresentada. Com isso, tickets com status Resolvido ainda podem ser reaber
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
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:
Qual a diferença de "Envolvidos no ticket" e "Clientes do ticket"?
A condição "Envolvidos no ticket" irá enviar o e-mail para o cliente, CC e responsável pelo ticket, ou seja, todos que, de alguma forma, estão envolvidos naquele ticket (sem distinção entre agente e cliente).
Enquanto isso, a condição "Clientes do ticket" irá enviar somente para o solicitante, sem c
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.
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
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
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
O que significa a mensagem Este ticket é uma continuação do ticket N° 01?
O ticket possui dois status para indicar a conclusão que são eles: resolvido e fechado, sendo que o status resolvido reabre ao receber um e-mail do cliente. Já o status de fechado não reabre, porém, o sistema abre um novo ticket com o e-mail recebido e aplica a mensagem de Este ticket é uma continua
Candidatar ação de ticket como artigo
Neste artigo você irá aprender como utilizar a ação de ticket como artigo.
Como agente, você pode sugerir a publicação de um artigo a partir de um ticket. Essa função pode ser muito útil na ocasião de uma resposta de um agente a um cliente, sobre determinada funcionalidade ou informação, que aind
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 - 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ê
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
Como criar um evento através do ticket?
É possível criar um evento na agenda do Movidesk diretamente pelo ticket, fazendo com que o ticket fique atrelado a ele.
Para isso, acesse o ticket que desejar e vá em Opções > Eventos.
Em seguida, clique no + na tela que aparecerá para criação de evento.
Note que já aparece a relação do ticket ao
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 o limite de solicitantes no mesmo ticket?
É possível adicionar até 15 solicitantes no mesmo ticket no Movidesk.
Caso um 16º solicitante seja adicionado, uma mensagem de erro será exibida em tela avisando que o limite foi atingido, como a imagem abaixo.
Por isso, caso seja preciso integrar mais pessoas ao chamado, estas podem ser adicionadas
Como configurar dois responsáveis dentro de um ticket?
Por padrão, o Movidesk permite apenas um responsável por ticket.
É possível designar dois responsáveis diferentes para um mesmo ticket utilizando campos adicionais, como forma de acompanhamento dos tickets, mas essa ação possui algumas limitações por se tratar de um campo adicional, e não do campo R
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
Como alterar o responsável do ticket automaticamente, via gatilho?
Para alterar o responsável de um chamado aberto via e-mail, ou seja, que chega na conta configurada no sistema, você deve ir até configurações > automação > gatilhos. Vá até o ícone + para criar um novo gatilho. Preencha o nome e o tipo do gatilho, nesse caso, será um gatilho para tickets. As condiç
É possível enviar um e-mail através do ticket?
Para enviar um e-mail através do ticket, basta acessar opções > enviar e-mail.
Dessa forma você pode enviar um e-mail para qualquer destinatário e esse e-mail será adicionado ao histórico de ações desse ticket.
É possível também enviar junto à esse e-mail um histórico das ações ali já registradas, b
É possível resolver um ticket por meio da macro?
É possível somente quando o ticket não estiver salvo ainda, pois é habilitada a opção Resolvido.
Caso o ticket já esteja salvo e em andamento, o sistema exige uma ação para resolver o ticket. Por isso, você não conseguirá utilizar a macro para resolver tickets já salvos.
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 - 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
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
02 - Quanto tempo está sendo gasto para concluir cada ticket?
Tempo trabalhado nos tickets
O Movidesk disponibiliza alguns relatórios gerenciais para controlar os tempos trabalhados pelos agentes.
Importante: Para garantir que o tempo trabalhado seja registrado de forma precisa, é fundamental que o apontamento de horas esteja habilitado no Movidesk. Para sabe
Como direcionar um ticket aberto para uma equipe via gatilho?
Para atribuir uma equipe a um chamado aberto, você deve acessar as Configurações > Automação > Gatilhos. Vá até o ícone + para criar um novo gatilho. Preencha o nome e o tipo do gatilho, nesse caso será um gatilho para tickets. As condições para a ação requerida devem ser as seguintes:
Todas as cond
Como criar macro pessoal e utilizar em chat ou ticket
Uma maneira de agilizar certas etapas do atendimento é a utilização de macros pessoais.
Ao combiná-las com o uso de algumas placeholders, é possível automatizar a inserção de dados como nome do cliente em uma saudação ou encerramento, por exemplo.
Neste artigo, daremos um exemplo de como criar uma m
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
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
Sou um agente, consigo incluir um cliente como Solicitante no ticket?
Pode ocorrer de já existir o cadastro do cliente no sistema, mas ele não aparecer ao procurar no campo "Solicitante" do ticket.
Em casos como esse, você consegue abrir um ticket no nome do cliente.
Para isso, você deve ir no perfil de acesso que o cliente está usando em seu cadastro (Configurações >
Gerar uma issue no JIRA através de um ticket do Movidesk
Este artigo explica como Gerar uma issue no JIRA através de um ticket do Movidesk, porém para isso, é necessário que você tenha realizado a Integração Movidesk, no qual explica que existem duas maneiras de definição para abertura de issues através de tickets, sendo uma delas de forma automática e ou
Campo adicional não exibindo todo o nome do campo no ticket
No Movidesk temos a possibilidade de criarmos campos adicionais e os mesmos permitem cadastrar um nome, contudo se o nome do campo for muito extenso, temos que atentar para um detalhe na configuração da regra de exibição desse campo.
Por padrão o tamanho máximo aceito no Movidesk é de 12 colunas,
Como permitir o agente a alterar a previsão de solução do ticket?
Para permitir que o agente realize a alteração na previsão de solução de um ticket é necessário acessar configurações > pessoas > perfis de acesso. Acesse o perfil do agente que deseja alterar, em seguida clique na aba tickets e habilite o parâmetro permite informar a data de vencimento na abertura
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,
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
Consigo editar ou excluir um apontamento de um ticket feito no mês passado?
É possível editar e excluir apontamentos realizados em um ticket vinculado a um contrato de horas até o mês anterior.
Ou seja, se você está no mês de dezembro tentando editar o apontamento de um ticket de contrato de horas de novembro, ainda é possível.
Mas um período anterior a este, como outubro,
Como adicionar um campo de assunto no ticket que o cliente possa editar?
O campo "Assunto", em conversas, é de responsabilidade do agente, sendo este quem deve alterá-lo de acordo com os processos da empresa em que trabalha.
Por padrão, no atendimento por mensagens instantâneas (chat direto, WhatsApp, Facebook Messenger, etc), quando um agente não especifica um assunto,
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
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
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
08 - Como permitir que os clientes removam e-mails em cópia (Ccs) do ticket
É possível permitir que clientes removam os e-mails em cópia de um ticket pelas configurações de perfil de acesso.
Dessa forma, você garante mais segurança e liberdade para o seu cliente, de forma que apenas quem precisa receber as atualizações de e-mail do ticket vai acompanhá-las.
Existem duas for
Como consultar uma pessoa via API de Pessoas pelo Cod. Ref?
Como consultar uma pessoa via API de Pessoas pelo Cod. Ref?
Para pesquisar uma pessoa pelo Cod. Ref, é necessário colocar entre aspas o Cod. Ref, segue a consulta:
https://api.movidesk.com/public/v1/persons?token=COLOCAR O TOKEN&$filter=codeReferenceAdditional eq 'Inserir aqui o Cod. Ref'
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
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
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
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
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
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
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
Janeiro /2023
Demandas Solucionadas:
Corrigimos o erro de timeout ao emitir relatório de tempo trabalhado nos tickets e de tempo de permanência por responsável;
Corrigimos a importação de um E-mail recebido como resposta de um ticket concluído gera apenas um novo ticket;
Ajustamos os campos adicionais para pessoa
11 - FAQ - Movidesk
Neste artigo você pode conferir uma lista de FAQs públicas. Perguntas isoladas ficam aqui, mas alguns temas, devido a grande quantidade de perguntas relacionadas, possuem artigos próprios para melhor visualização e organização. Observe que algumas perguntas podem aparecer em mais de um artigo, uma v
01 - Chamada ativa
A chamada ativa é uma feature de telefonia que permite realizar ligações a partir do Movidesk e registrá-las como ações em tickets existentes.
Por padrão, o parâmetro da chamada ativa vem desabilitado. Portanto, para poder efetuar as ligações, é preciso habilitá-lo e vincular o ramal ao agente que f
[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
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
Macros
Neste artigo você irá aprender sobre macro e como utilizá-las.
A macro é uma importante ferramenta para a automatização de tarefas na abertura ou atendimento de um ticket. Sempre que você tiver uma ação que se repita com certa frequência, considere a criação de uma macro.
Macros são templates que p
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