Minha consulta está demorando ou retornando “An error has occurred”, qual o motivo?

Dependendo da consulta que esteja realizando, isso pode ocorrer pois está tentando buscar muitos dados ou aplicando muitos filtros de uma só vez, sobrecarregando o sistema. Existem alguns métodos para tratar este problema. Exemplo 1: Tenho a intenção de baixar todos os tickets da base Esta consulta

Como adicionar Widget do Whatsapp na sua base de conhecimento

Neste artigo você irá aprender como criar um botão de WhatsApp e exibi-lo na sua KB, onde ao cliente clicar será direcionado para seu WhatsApp. Passo a passo por vídeo Siga o passo a passo a seguir: (link comentado no vídeo https://www.convertte.com.br/gerador-link-whatsapp/ ):   Passo a passo

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'          

Integração do login do Movidesk

Este artigo descreve como proceder para integrar o login do Movidesk ao seu sistema, de forma que se o usuário estiver autenticado na sua ferramenta, não seja necessária uma nova autenticação no site do Movidesk.

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 - 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.

Login externo

Atenção: é preciso estar logado no Movidesk para visualizar este artigo. Neste artigo você aprenderá como liberar um login externo.  Este material fornece informações para liberar o acesso de um usuário para qualquer página do Movidesk a partir de um token temporário.    Geração de Token temporário

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ó

Como importar mais de um número de telefone em um cadastro de pessoas?

Você poderá importar as pessoas utilizando a documentação aqui, inserindo apenas um Tipo de contato e um telefone. Para inserir os outros telefones destas pessoas que já criou, poderá fazer a inserção via API de Pessoas, consultando a documentação aqui. Um exemplo: Utilizando o programa de Postman 

Usando $filter, operadores quantitativos, e expressões Lambda em requisições da API

É comum que em integrações com nossas APIs seja necessário retornar os dados de Campos Adicionais de tickets (ou de pessoas), e-mails, dados de organizações, e várias informações mais extensas armazenadas em coleções. Consequentemente, o volume de dados retornados pode ficar pesado, às vezes contend

The query specified in the URI is not valid. A binary operator with incompatible types was detected

Status: 400 Bad Request, com dados: "message": "The query specified in the URI is not valid. A binary operator with incompatible types was detected. Found operand types 'Movidesk.Core.Data.Enums.TicketOrigin' and 'Edm.Int32' for operator kind 'Equal'." e semelhantes Motivo Esse erro ocorre quando se

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

Usando $expand para requisitar campos adicionais e outras coleções em consultas das API

A utilização do parâmetro “$expand” em sua URI da API serve para consultar coleções de dados/objetos dentro das requisições da API utilizada.  Neste artigo, você vai ver: Utilizando o parâmetro $Expand Requisitando dados de coleções dentro de outras coleções Utilizando o parâmetro $Expand De form

API do Movidesk - Cadastro de contrato de horas

Essa documentação descreve os procedimentos para utilização da API de consulta, inclusão e alteração de contratos de horas.

API do Movidesk - Telefonia - Sem controle da fila

Essa documentação descreve os procedimentos para utilização da API que integra centrais telefônicas com o Movidesk sem que o Movidesk controle a fila.

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.

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

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

API do Movidesk - Telefonia - Com controle da fila

Essa documentação descreve os procedimentos para utilização da API que integra centrais telefônicas com o Movidesk com o Movidesk controlando a fila da central.

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

Envio de templates (HSM) de recontato - Integração com Zenvia NLU

Com esta integração, é possível ter um fluxo de atendimento mais completo com clientes que transbordam do canal de WhatsApp via Zenvia NLU. O envio de templates permite oferecer assistência adicional após o suporte técnico, agendar follow-ups, atualizações de status, upgrades, informações adicionais

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

Informações gerais e planos do WhatsApp Business Movidesk

Neste artigo, você encontra conteúdo sobre: O ©WhatsApp Business MovideskPlanos e mensalidadesAtivação do planoMudança ou cancelamento do planoSituações de inadimplência⚓  O ©WhatsApp Business MovideskO WhatsApp Business Movidesk funciona por meio da integração entre: Um Business Service Provider (B

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

API do Movidesk - Contrato de horas - Consumo de horas

Essa documentação descreve os procedimentos para utilização da API de consulta do consumo de horas do contrato de horas.

Junho/2025

🚀 Atualizações de JunhoEste 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. Relatório: Como o relatório "Tickets por Serviço" agrupa os tickets por nível de servi

Por que a configuração do e-mail não funciona?

Após configurar o e-mail e testar a conexão, caso ocorra algum erro, é necessário verificar alguns fatores externos e detalhes que podem influenciar. O primeiro ponto fundamental para o funcionamento de envio e recebimento dos e-mails através do Movidesk, é a liberação de nossos IPs 52.0.96.168 (Env

API do Movidesk - Tickets

Essa documentação descreve os procedimentos para utilização da API de consulta, inclusão e alteração de tickets.

03 - Configurar e utilizar o aplicativo de chat

A Movidesk disponibiliza um importante meio de comunicação com os clientes, que é o atendimento via chat. Através dele, você pode estabelecer um canal online para que seus clientes possam conversar com a sua equipe.

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.

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

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 Canais

Este artigo reúne as principais dúvidas que podem surgir durante o uso dos Canais no Movidesk. Aqui você encontra soluções rápidas, dicas de interpretação e links para artigos com o passo a passo completo. 1. Como encontrar o link direto do seu chat?Você pode criar um link direto para qualquer um d

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

Integração Movidesk - JIRA

Veja como configurar a integração entre o Jira Software e o seu Movidesk.

API do Movidesk - Tickets/Past

Essa documentação descreve os procedimentos para utilização da API de consulta, inclusão e alteração de tickets.

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

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,

Perguntas Frequentes ©WhatsApp Business Movidesk

Aqui estão as principais dúvidas e respostas relacionadas ao Módulo ©WhatsApp Business Movidesk. Você encontrará conteúdo sobre: Número WhatsApp BusinessPlanos e pagamentoGrupo de chat para WhatsAppChat origem WhatsAppTicket origem WhatsAppHSMInteração com o aplicativo WhatsAppPara consultar por pal

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

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

Novembro/2022

Demandas Solucionadas: Corrigimos a aba de relatórios, onde não era possível abrir 2 ou mais abas simultâneas; Ao expandir o indicador, a data retornava para o valor padrão, ajustamos para que permaneça o filtro aplicado antes de expandir; Ajustes na tela de rolagem do relatório de tempo de permanên

API do Movidesk - Manutenção e manipulação de campos adicionais

Essa documentação descreve os procedimentos para utilização da API de consulta, inclusão e alteração de tickets.

Resolução de problemas em Integrações

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 Ji

Políticas de Uso do Movidesk

Atenção: Este termo é válido apenas para contratos assinados até 06/10/24. A partir de 07/10, os contratos seguem o modelo Zenvia. Este documento estabelece as diretrizes da relação entre você e a Movidesk. Aqui, você verá todas as informações sobre as Políticas de Uso da ferramenta e seus módulos a

Politica Privacidade Movidesk - Clientes

Política de privacidade de serviços web Movidesk A prioridade da Movidesk é assegurar a privacidade e a segurança das informações cedidas por Você (“USUÁRIO”) no momento do seu Cadastro e/ou navegação no Website, acessado a partir de domínios e subdomínios associados ao endereço eletrônico https://m