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 - Pessoas
Essa documentação descreve os procedimentos para utilização da API de inclusão, alteração consulta e exclusão de pessoas.
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'
Pessoas
Perfis de acesso
Como configurar os perfis de acesso?
Como permitir que um agente exclua tickets?
Agentes inativos contam para a minha fatura?
Quem possui o perfil de acesso de Clientes pode publicar avisos?
Como parametrizar para que um agente consiga visualizar as agendas de todos os agentes?
Qua
Importação de pessoas
⚓O Movidesk permite automatizar o cadastro de pessoas, que são seus clientes ou agentes. Utilizando a importação de pessoas, podemos relacionar as empresas e as pessoas associadas a cada empresa. É importante que antes de realizar a importação de pessoas, compreender o fluxo do Movidesk relacionad
Cadastro de Pessoas
Neste artigo você irá aprender como cadastrar pessoas. O cadastro de pessoas é um dos módulos mais importantes do Movidesk. Compreende-se por pessoas tanto os agentes, que prestam o atendimento, quanto os seus clientes. Sejam eles pessoas, empresas ou departamentos. É apenas uma definição no cadast
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!
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ó
Mesclar Pessoas
Este artigo descreve os procedimentos para utilização da funcionalidade de Mesclar Pessoas. Um importante recurso para unificar pessoas repetidas em seu cadastro.
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
03 - Cadastrando pessoas
Dando sequência ao procedimento para configurar o seu Movidesk, abordaremos nesse vídeo o cadastramento das pessoas, que são os seus clientes e também a sua equipe de agentes.
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
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
©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 - 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ê
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
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:
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
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
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.
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
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
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
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
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
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
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!
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 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
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
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,
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
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
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
[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
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
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
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
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
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
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
Agosto/2022
22.08.11 - 12/08/2022
Realizamos um ajuste na API de anexos para que possibilite a inclusão de anexos passando o parâmetro de protocolo.
Fizemos uma correção nos tickets, quando existia uma regra de exibição com condição de data da última ação, para que funcione corretamente.
Atualizamos o indicador
Widget NLU
O Widget NLU permite facilitar o contato com seus clientes e abrir tickets de forma prática utilizando o chatbot do Zenvia NLU.
A funcionalidade fica localizada na tela inicial do Movidesk e para utilizá-la, basta clicar no ícone do Widget NLU.
⚠️ Atenção: Para usar os recursos desta funcionalidade
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
Solicitando a migração de APIs WhatsApp
Solicitando migração de outra API para a API WhatsApp Business MovideskCaso você já tenha um número de WhatsApp Business em outra API e queira usar o mesmo na Movidesk, você pode solicitar o processo de migração de número.
Para solicitar a migração, você precisa realizar os passos a seguir:
Solicita
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
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
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
Como criar políticas de acesso para serviços aos clientes
Neste artigo vamos entender um pouco mais como configurar as políticas de privacidade do seu catálogo de serviço para clientes específicos.
Para esta configuração você possui duas opções, restringir o catálogo de serviços através do usuário no cadastro de pessoas, ou diretamente pelo perfil de aces
Outubro / 2023
Demandas Solucionadas:
Ajustamos o comportamento ao selecionar um serviço com uma macro vinculada;
Corrigimos o comportamento das colunas ao navegar pelas abas do painel de visualizações de tickets;
Ajustamos o comportamento de gatilhos com ação de inserção de tag via gatilho, para que o ticket sej
Importação de Campos Adicionais Movidesk
Neste artigo, você vai aprender a preencher a planilha de Campos Adicionais (custom fields) a serem migrados.
O que é migração de Campos Adicionais?
Consiste em importar o histórico contido nos campos personalizados que foram cadastrados para atender as necessidades do cliente.
Lembrando que hoje
01 - Catálogo de serviços
Neste artigo você irá aprender a configurar e consultar os serviços.
O catálogo de serviços é um recursos que permite você organizar de forma clara quais são as atividades executadas pela sua empresa.
Esse vídeo exibe o passo a passo e os parâmetros para que você configure os serviços em sua base M
Material de apoio - Gatilhos
Neste artigo, vamos abordar o uso de gatilhos em sua base Movidesk.
Vamos focarna estruturação de gatilhos mais complexos, utilizando:
Condições envolvendo tempo - Tempo de permanência;
Campos adicionais pessoas;
Campos adicionais Tickets;
Placeholders.
Tempo de permanência
Como o nome indica, a con
Perfis de acesso
Neste artigo você aprenderá como criar e configurar seus perfis de acesso. A configuração dos perfis de acesso é o que possibilita as concessões e restrições de usuários dentro do sistema pelo administrador conforme a necessidade da sua empresa.
Para configurar os perfis de acesso você deverá seleci
Fevereiro /2023
Demandas Solucionadas:
Corrigimos o erro da pesquisa de satisfação enviada por e-mail;
Ajustamos a busca de filtros de ativos através da data de garantia;
Ajustamos o painel do kanban, onde anteriormente era possível exibir status ou justificativas excluídas;
Corrigimos o filtro de data no relatório
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
Como habilitar a central de integrações?
Acesse configurações > pessoas > perfis de acesso. Localize o perfil que deseja alterar e na aba de configurações, habilite o parâmetro permitir acessar a central de integrações. Salve suas alterações e atualize a página do Movidesk para validar a configuração.
Um novo item aparecerá no seu menu de
Como restringir um artigo na base de conhecimento?
Para restringir um artigo na base de conhecimento, você deverá acessar configurações > base de conhecimento > artigos. Acesse o artigo que deseja alterar e na parte de configurações > artigo visível na central de ajuda, marque a opção de sua preferência para restringir o artigo. As opções podem ser:
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
Passo a passo das configurações Zenvia Voice/ Movidesk
Este artigo irá auxiliar na configuração e integração entre Zenvia Voice e Movidesk
Configurações Realizadas no Zenvia Voice
Números de Telefone
Ramais
Filas
URA
Dica
Configurações Realizadas no Movidesk
Configurações Realizadas no Zenvia Voice
Primeiro parâmetro precisamos definir é o que irá
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
Como funciona o registro de edição e/ou exclusão de um gatilho?
A exclusão de um gatilho é uma operação irreversível e não registra log de alterações. Entretanto, é possível apenas desabilitar o gatilho ao invés de excluí-lo.
Desabilitando dentro do gatilho este parâmetro:
Com essa ação é possível identificar quem foi o agente responsável por tal alteração e ain
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
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
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 os perfis de acesso?
A configuração dos perfis de acesso é o que possibilita as concessões e restrições dentro do sistema. O administrador poderá fazer as permissões e configurações necessárias para cada perfil.
Para configurar os perfis de acesso você deverá selecionar configurações no menu lateral do Movidesk e, na ca
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
Como configurar as regras de exibição de campos adicionais?
As regras de exibição permitem definir critérios específicos que, ao serem atendidos, fazem com que campos adicionais apareçam automaticamente em telas de tickets ou pessoas. Esse recurso é útil para personalizar as informações que aparecem em diferentes contextos, garantindo que você só veja campos
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
Central de Processamentos
A central de processamento possibilita a extração assíncrona de dados e disponibiliza arquivo para download por 30 dias.
Exportar Dados
Central de Processamentos
Exportar Dados
Ao solicitar a exportação dos dados dos relatórios para o arquivo, o mesmo será gerado e disponibilizado via Central de