Adicionando a fonte de dados
O Movidesk é um sistema de atendimento brasileiro que une recursos de Help Desk e Service Desk, podendo ser utilizado para comunicação com os clientes ou interna. A integração de dados do Movidesk para o Data Warehouse criada pela Kondado possibilita que você tenha acesso a todos os componentes da plataforma, mesmo os campos e objetos customizados na sua nuvem analítica.
Adicionando o conector
Baseado na documentação da API do movidesk
Requisitos
- É necessário permissão para gerar a chave de API em Configurações / Conta / Parâmetros
Instruções
Para automatizar o ETL do Movidesk com a Kondado para o seu banco de dados, siga os passos abaixo:
1) Faça login na sua conta do Movidesk e, no painel esquerdo clique em configurações e depois em parâmetros
2) No final da página de configurações, você encontrará a sua chave. Copie-a, pois ela será utilizada para adicionar o conector do Movidesk na Kondado
3) Na plataforma da Kondado, vá para a página de adicionar conectores e selecione o conector do Movidesk
4) Dê um nome para o seu conector e, em "Token" cole a chave gerada no passo (2)
Agora basta salvar o conector e começar a integrar os seus objetos do Movidesk no Data Lake ou Data Warehouse
Pipelines
Resumo
Diagrama de relacionamento
Clique para expandir
Perguntas das pesquisas de satisfação
Tipo de replicacao: Integral
Objeto principal
Perguntas configuradas nas pesquisas de satisfação Movidesk.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador da pergunta da pesquisa de satisfação |
|
|
float |
[pt] Tipo da pesquisa: Satisfeito ou Insatisfeito = 1, Faces Sorridentes = 2, NPS (Net Promoter Score) = 3, Sim ou Não = 4. |
|
|
boolean |
[pt] Se a pergunta está ou não ativa |
movidesk_survey_questions__languages
Idiomas disponíveis para cada pergunta da pesquisa.
Pessoas
Tipo de replicacao: Integral
Objeto principal
Cadastro de pessoas do Movidesk (clientes, agentes ou departamentos).
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Campo Cód. Ref. Identificador único da pessoa. (Alfanumérico) |
|
|
text |
[pt] Tipo da pessoa. Pessoa = 1, Empresa = 2, Departamento = 4 |
|
|
text |
[pt] Classificação da pessoa |
|
|
text |
[pt] Nome do superior hierárquico |
|
|
text |
[pt] Idioma da pessoa no padrão CultureCode da Microsoft. Exemplo para idioma português do Brasil: pt-BR |
|
|
text |
[pt] CPF (11 dígitos) para pessoas, CNPJ (14 dígitos) para empresas e inexistente para departamentos |
|
|
text |
[pt] Cargo da pessoa |
|
|
text |
[pt] Observações |
|
|
text |
[pt] Tipo do perfil. Agente = 1, Cliente = 2, Agente e Cliente = 3. |
|
|
text |
[pt] Fuso horário da pessoa no padrão IANA. Exemplo para fuso horário de Brasília: America/Sao_Paulo |
|
|
text |
[pt] Campo Cód. Ref. Adicional. Identificador não obrigatório, porém único da pessoa. (Alfanumérico) |
|
|
text |
[pt] Cod. Ref. da pessoa que criou a pessoa consultada |
|
|
timestamp |
[pt] Data da criação da pessoa |
|
|
text |
[pt] Id (Cod. Ref.) existente do superior hierárquico da pessoa |
|
|
boolean |
[pt] Campo Pessoa habilitada |
|
|
text |
[pt] Campo usuário |
|
|
text |
[pt] Cod. Ref. da pessoa que alterou pela ultima vez a pessoa consultada |
|
|
text |
[pt] Caso a autenticação em diretório estiver habilitada e a pessoa se autentica em um domínio diferente do Movidesk, deve ser informado o servidor e domínio já cadastrados no sistema. Ex: hostdomeuservidorad\dominiodomeuservidorad |
|
|
text |
[pt] Campo Perfil de acesso |
|
|
timestamp |
[pt] Data da ultima alteração da pessoa |
|
|
text |
[pt] Nome fantasia para empresas ou Nome para pessoas e departamentos |
|
|
text |
[pt] Razão social |
movidesk_persons__relationships
Relacionamentos e hierarquias associados às pessoas.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Id da pessoa |
|
|
boolean |
[pt] Se este valor for verdadeiro, a pessoa terá acesso a todos os itens do catálogo de serviços. Caso contrário, deverão ser especificados os serviços para os quais a pessoa terá acesso |
|
|
text |
[pt] Se este valor for verdadeiro, será incluído esse relacionamento nas pessoas da organização pai e para desfazer será necessário remover manualmente esse relacionamento das pessoas da organização pai |
|
|
boolean |
||
|
text |
[pt] Descrição da hierarquia |
|
|
text |
[pt] Contrato de SLA utilizado pelo cliente |
|
|
boolean |
[pt] Se este valor for verdadeiro, serão incluídos relacionamentos com as organizações filhas da organização pai e para desfazer será necessário remover manualmente esses relacionamentos |
|
|
boolean |
[pt] Se este valor for informado como verdadeiro, todas as pessoas ligadas a esta hierarquia obrigatoriamente terão o mesmo contrato de SLA |
|
|
text |
[pt] Id (Cod. ref.) existente da empresa ou departamento ao qual a pessoa pertence |
movidesk_persons__contacts
Contatos vinculados às pessoas (telefones, e-mails, etc.).
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Id da pessoa |
|
|
text |
[pt] Descrição ex: (11) 9999-9999. |
|
|
boolean |
[pt] Indicador se esse é o contato principal da pessoa. Somente um contato poderá ser o contato principal |
|
|
text |
[pt] Tipo do contato ex: (Telefone, Celular, Skype, etc) |
movidesk_persons__emails
Endereços de e-mail adicionais cadastrados para as pessoas.
Respostas das pesquisas de satisfação
Tipo de replicacao: Incremental
Respostas enviadas nas pesquisas de satisfação Movidesk.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador da resposta da pesquisa de satisfação |
|
|
text |
[pt] Identificador da pergunta da pesquisa de satisfação |
|
|
timestamp |
[pt] Data de resposta da pesquisa de satisfação |
|
|
float |
[pt] Pontuação da resposta com base no tipo. Satisfeito ou insatisfeito (1 = Satisfeito, 2 = Insatisfeito), Faces sorridentes (1 = Muito insatisfeito, 2 = Insatisfeito, 3 = Neutro, 4 = Satisfeito, 5 = Muito satisfeito), NPS (0 a 10), Sim ou não (1 = Sim, 2 = Não) |
|
|
text |
[pt] Comentários da reposta |
|
|
float |
[pt] Número do ticket |
|
|
float |
[pt] Tipo da pesquisa: Satisfeito ou Insatisfeito = 1, Faces Sorridentes = 2, NPS (Net Promoter Score) = 3, Sim ou Não = 4 |
|
|
text |
[pt] Id (Cod. ref.) da empresa, departamento ou pessoa relacionado como cliente da resposta |
Tickets
Tipo de replicacao: Incremental
Tickets principais com campos padrão, SLAs e metadados de atendimento.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Número do ticket. [nota da kondado: pode conter valores negativos, que acreditamos serem referentes a tickets deletados (confira o campo isdeleted) e/ou provenientes de migração, mas a documentação do movidesk não é clara neste sentido] |
|
|
text |
[pt] Protocolo do ticket |
|
|
text |
[pt] Canal de abertura do ticket: 1= Via web pelo cliente; 2= Via web pelo agente; 3= Recebido via email; 4= Gatilho do sistema; 5= Chat (online); 7= Email enviado pelo sistema; 8= Formulário de contato; 9= Via web API; 10= Agendamento automático ; 11= JiraIssue; 12= RedmineIssue; 13= ReceivedCall; 14= MadeCall; 15= LostCall; 16= DropoutCall; 17= Acesso remoto; 18= WhatsApp; 19= MovideskIntegration; 20= ZenviaChat; 21= NotAnsweredCall; 23= WhatsApp Business Movidesk |
|
|
text |
[pt] Relação dos e-mails informados no campo Cc, separados por vírgula |
|
|
boolean |
[pt] Indica se o contrato SLA foi manualmente alterado pelo usuário |
|
|
text |
||
|
boolean |
[pt] Verdadeiro se foi deletado |
|
|
float |
[pt] Tempo de duração do chat em segundos |
|
|
timestamp |
[pt] Data de solução do SLA. Caso informado, será considerado que o SLA foi manualmente alterado pelo usuário que criou a ação. A data informada deve estar no formato UTC |
|
|
text |
||
|
text |
[pt] ID da issue do Redmine que está associada ao ticket por integração |
|
|
timestamp |
[pt] Data na qual o ticket foi indicado como fechado. A data informada deve estar no formato UTC |
|
|
float |
[pt] Tempo de solução do contrato SLA |
|
|
text |
[pt] Tipo do ticket: 1 = Interno 2 = Público |
|
|
text |
[pt] Aplicativo de chat através do qual o ticket foi aberto |
|
|
text |
[pt] Contrato SLA utilizado no ticket |
|
|
text |
||
|
timestamp |
[pt] Data de abertura do ticket |
|
|
float |
[pt] Quantidade de ações do ticket |
|
|
text |
[pt] Nome do primeiro nível do serviço selecionado no ticket |
|
|
text |
[pt] Lista com os nomes dos níveis do serviço selecionado no ticket |
|
|
text |
[pt] Lista de strings com as TAGs as quais o ticket esta relacionado |
|
|
text |
[pt] Número inteiro armazenado no campo Sequência |
|
|
float |
[pt] Tempo de resposta do contrato SLA |
|
|
text |
[pt] Chave da issue do Jira Software que está associada ao ticket por integração |
|
|
text |
[pt] Nome do terceiro nível do serviço selecionado no ticket |
|
|
timestamp |
[pt] Data na qual o ticket foi indicado pelo agente como resolvido |
|
|
timestamp |
[pt] Data UTC da última ação do ticket |
|
|
float |
[pt] Tempo que o cliente ficou aguardando para ser atendido em segundos |
|
|
text |
[pt] Assunto do ticket |
|
|
text |
[pt] Nome da categoria do ticket |
|
|
timestamp |
[pt] Data UTC de resposta do SLA |
|
|
text |
[pt] Regra do contrato SLA |
|
|
timestamp |
[pt] Data na qual o ticket teve a ultima reabertura |
|
|
text |
[pt] Id (Código) do serviço selecionado no ticket |
|
|
float |
[pt] Tempo de vida do ticket em minutos em horas úteis desde a abertura |
|
|
boolean |
[pt] Indica se a data de solução do SLA está pausada |
|
|
float |
[pt] Tempo que o ticket ficou no status parado em minutos em horas corridas |
|
|
text |
[pt] Nome do status base do ticket: New, InAttendance, Stopped, Canceled, Resolved, Closed |
|
|
text |
[pt] Nome do status do ticket |
|
|
timestamp |
[pt] Data UTC da ultima alteração do ticket |
|
|
text |
[pt] Justificativa do ticket |
|
|
timestamp |
[pt] Data UTC real da resposta do SLA |
|
|
text |
[pt] Conta de e-mail na qual o ticket foi recebido |
|
|
text |
[pt] Grupo de chat através do qual o ticket foi aberto |
|
|
text |
[pt] Equipe do responsável pelo ticket |
|
|
text |
[pt] Nome do formulário de contato através do qual o ticket foi aberto |
|
|
float |
[pt] Tempo que o ticket ficou no status parado em minutos em horas úteis |
|
|
boolean |
[pt] Indicador que representa se o ticket foi resolvido já no momento da abertura ou num momento posterior |
|
|
text |
[pt] Nome do segundo nível do serviço selecionado no ticket |
|
|
text |
[pt] Nome da urgência do ticket |
Notas
- Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas
Integrar dados do Movidesk via Kondado
Configure o conector do Movidesk na Kondado para enviar eventos de atendimento ao seu Data Warehouse ou Data Lake.
Obtenha a chave de API no Movidesk
Acesse sua conta do Movidesk com permissão de administrador, vá em Configurações / Conta / Parâmetros e copie a chave de API gerada no final da página.
Adicione o conector na Kondado
Na plataforma da Kondado, acesse a página de conectores, selecione o Movidesk e dê um nome ao conector.
Configure o token de autenticação
No campo Token, cole a chave de API copiada no passo anterior e salve o conector.
Selecione objetos e campos para integração
Escolha quais objetos do Movidesk deseja integrar — como Tickets, Pessoas, Ações, Pesquisas de Satisfação e Campos Customizados — e defina seu destino (Data Warehouse ou Data Lake).
Valide os dados no destino
Após a primeira carga, verifique se os campos customizados e objetos relacionados foram sincronizados corretamente, consultando a documentação de campos e tipos disponível no artigo.
