Movidesk is a Brazilian customer service system that combines Help Desk and Service Desk resources, and can be used for communication with customers or internally. Movidesk's data pipeline for the Data Warehouse created by Kondado allows you to have access to all platform components, even custom fields and objects in your analytical cloud.
Adding the data source
Based on movedesk API documentation
Requirements
- Permission required to generate API key in Settings / Account / Parameters
Instructions
To automate Movidesk ETL with Kondado for your database, follow the steps below:
1) Log in to your Movidesk account and in the left panel click on settings and then on parameters
2) At the end of the settings page you will find your key. Copy it, as it will be used to add the Movidesk data source to Kondado
3) On the Kondado platform, go to add data sources page and select the Movidesk data source
4) Name your data source and, in “Token”, the key generated in step (2)
Now just save the data source and start integrating your Movidesk objects in the Data Lake or Data Warehouse
Pipelines
Summary
Relationship Chart
Pessoas
Main Object
Field | Type | |
---|---|---|
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
Field | Type | |
---|---|---|
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
Field | Type | |
---|---|---|
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
Tickets
Field | Type | |
---|---|---|
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 |
Clientes dos Tickets
Field | Type | |
---|---|---|
text |
[pt] Número do ticket |
|
text |
[pt] Pessoa = 1, Empresa = 2, Departamento = 4 (Somente leitura). |
|
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
||
text |
[pt] Id (Cod. ref.) da empresa, departamento ou pessoa relacionado como cliente do ticket |
|
text |
[pt] Verdadeiro se o cliente foi deletado |
|
text |
||
text |
||
text |
[pt] Agente = 1, Cliente = 2, Agente e Cliente = 3 |
|
text |
[pt] Nome do cliente |
|
text |
[pt] E-mail principal do cliente |
Donos dos Tickets
Field | Type | |
---|---|---|
text |
[pt] ID do ticket |
|
text |
[pt] Tipo da pessoa: Pessoa = 1, Empresa = 2, Departamento = 4 |
|
text |
||
text |
||
text |
||
text |
||
text |
||
text |
[pt] Telefone principal da organização |
|
text |
||
text |
[pt] Id (Cod. ref.) do owner |
|
text |
||
text |
||
text |
[pt] Perfil da pessoa: Agente = 1, Cliente = 2, Agente e Cliente = 3 |
|
text |
[pt] Nome da organização |
|
text |
[pt] E-mail principal da organização |
Ações dos Tickets
Field | Type | |
---|---|---|
text |
[pt] Número do ticket |
|
text |
[pt] Id (Número da ação) |
|
text |
[pt] Origem da ação - 0: First Action; 1: Via web pelo cliente; 2: Via web pelo agente; 3: Recebido via email; 4: Gatilho do sistema; 5: Chat (online); 6: Chat (offline); 7: Email enviado pelo sistema; 8: Formulário de contato; 9: Via web API; 10: Abertura automática de tickets; 11: Issue integração Jira; 12: Issue integração Redmine; 13: Chamada recebida integração Telefonia; 14: Chamada realizada integração Telefonia; 15: Chamada perdida integração Telefonia; 16: Chamada que obteve desistência na fila de espera integração Telefonia; 17: Acesso remoto; 18: WhatsApp; 19: Integração Movidesk; 20: Integração Zenvia Chat; 21: Chamada não atendida integração Telefonia |
|
text |
[pt] Status da ação |
|
text |
[pt] Justificativa da ação |
|
text |
[pt] Descrição da ação (somente texto) |
|
timestamp |
[pt] Data de criação da ação |
|
text |
[pt] Descrição da ação em formato HTML |
|
text |
[pt] Lista de strings com as TAGs as quais a ação esta relacionada |
|
text |
[pt] Tipo do ticket: 1 = Interno 2 = Público |
|
boolean |
[pt] Verdadeiro se a ação foi deletada |
Pesquisas de Satisfação dos Tickets
Field | Type | |
---|---|---|
text |
[pt] ID do ticket |
|
text |
[pt] Id (Código) da resposta de satisfação |
|
float |
[pt] Pontuação: 1 = Positivo e 2 = Negativo |
|
timestamp |
[pt] Data UTC da resposta |
|
float |
[pt] Pontuação de 0 a 10 (NPS) |
|
float |
[pt] Pontuação de 0 a 10 (NPS) |
|
text |
[pt] Comentários |
|
text |
[pt] Modelo de pontuação da resposta: 1 = Positivo/Negativo, 2 = Faces sorridentes, 3 = NPS |
Campos Customizados dos Tickets
Main Object
Field | Type | |
---|---|---|
text |
[pt] ID do ticket |
|
timestamp |
[pt] Data UTC da ultima alteração do ticket |
|
float |
[pt] Número da linha da regra de exibição na tela do ticket |
|
text |
[pt] Id da regra de exibição dos campos adicionais |
|
text |
[pt] Id do campo adicional (pode ser obtido na listagem de campos adicionais no website) |
|
text |
[pt] Valor texto do campo adicional. Os campos de data estarão em horário UTC e no formato YYYY-MM-DDThh:MM:ss.000Z. O campo hora será informado juntamente com a data fixa "1991-01-01". O campo numérico estará no formato brasileiro, por exemplo "1.530,75". |
movidesk_customFieldValues__items
Field | Type | |
---|---|---|
text |
||
text |
||
text |
[pt] Id (Cod. ref.) da empresa, departamento ou pessoa |
|
text |
||
text |
[pt] Id (Cod. ref.) da empresa, departamento ou pessoa |
|
text |
||
text |
[pt] Nome da equipe |
|
text |
[pt] Nome do item do campo adicional |
Perguntas das Pesquisas de Satisfação
Main Object
Field | Type | |
---|---|---|
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
Respostas das Pesquisas de Satisfação
Field | Type | |
---|---|---|
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 |