Movidesk

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

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

id

text

[pt] Campo Cód. Ref. Identificador único da pessoa. (Alfanumérico)

persontype

text

[pt] Tipo da pessoa. Pessoa = 1, Empresa = 2, Departamento = 4

classification

text

[pt] Classificação da pessoa

bossname

text

[pt] Nome do superior hierárquico

cultureid

text

[pt] Idioma da pessoa no padrão CultureCode da Microsoft. Exemplo para idioma português do Brasil: pt-BR

cpfcnpj

text

[pt] CPF (11 dígitos) para pessoas, CNPJ (14 dígitos) para empresas e inexistente para departamentos

role

text

[pt] Cargo da pessoa

observations

text

[pt] Observações

profiletype

text

[pt] Tipo do perfil. Agente = 1, Cliente = 2, Agente e Cliente = 3.

timezoneid

text

[pt] Fuso horário da pessoa no padrão IANA. Exemplo para fuso horário de Brasília: America/Sao_Paulo

codereferenceadditional

text

[pt] Campo Cód. Ref. Adicional. Identificador não obrigatório, porém único da pessoa. (Alfanumérico)

createdby

text

[pt] Cod. Ref. da pessoa que criou a pessoa consultada

createddate

timestamp

[pt] Data da criação da pessoa

bossid

text

[pt] Id (Cod. Ref.) existente do superior hierárquico da pessoa

isactive

boolean

[pt] Campo Pessoa habilitada

username

text

[pt] Campo usuário

changedby

text

[pt] Cod. Ref. da pessoa que alterou pela ultima vez a pessoa consultada

authenticateon

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

accessprofile

text

[pt] Campo Perfil de acesso

changeddate

timestamp

[pt] Data da ultima alteração da pessoa

businessname

text

[pt] Nome fantasia para empresas ou Nome para pessoas e departamentos

corporatename

text

[pt] Razão social

movidesk_persons__relationships

Field Type

persons_id

text

[pt] Id da pessoa

allowallservices

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

includeinparents

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

isgetmethod

boolean

name

text

[pt] Descrição da hierarquia

slaagreement

text

[pt] Contrato de SLA utilizado pelo cliente

loadchildorganizations

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

forcechildrentohavesomeagreement

boolean

[pt] Se este valor for informado como verdadeiro, todas as pessoas ligadas a esta hierarquia obrigatoriamente terão o mesmo contrato de SLA

relationship_id

text

[pt] Id (Cod. ref.) existente da empresa ou departamento ao qual a pessoa pertence

movidesk_persons__contacts

Field Type

persons_id

text

[pt] Id da pessoa

contact

text

[pt] Descrição ex: (11) 9999-9999.

isdefault

boolean

[pt] Indicador se esse é o contato principal da pessoa. Somente um contato poderá ser o contato principal

contacttype

text

[pt] Tipo do contato ex: (Telefone, Celular, Skype, etc)

movidesk_persons__emails

Field Type

emailtype

text

email

text

isdefault

boolean

persons_id

text

Tickets

Field Type

id

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]

protocol

text

[pt] Protocolo do ticket

origin

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

cc

text

[pt] Relação dos e-mails informados no campo Cc, separados por vírgula

slasolutionchangedbyuser

boolean

[pt] Indica se o contrato SLA foi manualmente alterado pelo usuário

systemstatus

text

isdeleted

boolean

[pt] Verdadeiro se foi deletado

chattalktime

float

[pt] Tempo de duração do chat em segundos

slasolutiondate

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

movideskticketnumber

text

redmineissueid

text

[pt] ID da issue do Redmine que está associada ao ticket por integração

closedin

timestamp

[pt] Data na qual o ticket foi indicado como fechado. A data informada deve estar no formato UTC

slasolutiontime

float

[pt] Tempo de solução do contrato SLA

type

text

[pt] Tipo do ticket: 1 = Interno 2 = Público

chatwidget

text

[pt] Aplicativo de chat através do qual o ticket foi aberto

slaagreement

text

[pt] Contrato SLA utilizado no ticket

linkedtointegratedticketnumber

text

createddate

timestamp

[pt] Data de abertura do ticket

actioncount

float

[pt] Quantidade de ações do ticket

servicefirstlevel

text

[pt] Nome do primeiro nível do serviço selecionado no ticket

servicefull

text

[pt] Lista com os nomes dos níveis do serviço selecionado no ticket

tags

text

[pt] Lista de strings com as TAGs as quais o ticket esta relacionado

sequence

text

[pt] Número inteiro armazenado no campo Sequência

slaresponsetime

float

[pt] Tempo de resposta do contrato SLA

jiraissuekey

text

[pt] Chave da issue do Jira Software que está associada ao ticket por integração

servicethirdlevel

text

[pt] Nome do terceiro nível do serviço selecionado no ticket

resolvedin

timestamp

[pt] Data na qual o ticket foi indicado pelo agente como resolvido

lastactiondate

timestamp

[pt] Data UTC da última ação do ticket

chatwaitingtime

float

[pt] Tempo que o cliente ficou aguardando para ser atendido em segundos

subject

text

[pt] Assunto do ticket

category

text

[pt] Nome da categoria do ticket

slaresponsedate

timestamp

[pt] Data UTC de resposta do SLA

slaagreementrule

text

[pt] Regra do contrato SLA

reopenedin

timestamp

[pt] Data na qual o ticket teve a ultima reabertura

servicefirstlevelid

text

[pt] Id (Código) do serviço selecionado no ticket

lifetimeworkingtime

float

[pt] Tempo de vida do ticket em minutos em horas úteis desde a abertura

slasolutiondateispaused

boolean

[pt] Indica se a data de solução do SLA está pausada

stoppedtime

float

[pt] Tempo que o ticket ficou no status parado em minutos em horas corridas

basestatus

text

[pt] Nome do status base do ticket: New, InAttendance, Stopped, Canceled, Resolved, Closed

status

text

[pt] Nome do status do ticket

lastupdate

timestamp

[pt] Data UTC da ultima alteração do ticket

justification

text

[pt] Justificativa do ticket

slarealresponsedate

timestamp

[pt] Data UTC real da resposta do SLA

originemailaccount

text

[pt] Conta de e-mail na qual o ticket foi recebido

chatgroup

text

[pt] Grupo de chat através do qual o ticket foi aberto

ownerteam

text

[pt] Equipe do responsável pelo ticket

contactform

text

[pt] Nome do formulário de contato através do qual o ticket foi aberto

stoppedtimeworkingtime

float

[pt] Tempo que o ticket ficou no status parado em minutos em horas úteis

resolvedinfirstcall

boolean

[pt] Indicador que representa se o ticket foi resolvido já no momento da abertura ou num momento posterior

servicesecondlevel

text

[pt] Nome do segundo nível do serviço selecionado no ticket

urgency

text

[pt] Nome da urgência do ticket

Clientes dos Tickets

Field Type

ticket_id

text

[pt] Número do ticket

    Tickets > > id

persontype

text

[pt] Pessoa = 1, Empresa = 2, Departamento = 4 (Somente leitura).

reference

text

bairro

text

complement

text

address

text

number

text

phone

text

cep

text

client_id

text

[pt] Id (Cod. ref.) da empresa, departamento ou pessoa relacionado como cliente do ticket

isdeleted

text

[pt] Verdadeiro se o cliente foi deletado

city

text

pathpicture

text

profiletype

text

[pt] Agente = 1, Cliente = 2, Agente e Cliente = 3

businessname

text

[pt] Nome do cliente

email

text

[pt] E-mail principal do cliente

Donos dos Tickets

Field Type

ticket_id

text

[pt] ID do ticket

    Tickets > > id

persontype

text

[pt] Tipo da pessoa: Pessoa = 1, Empresa = 2, Departamento = 4

reference

text

bairro

text

complement

text

address

text

number

text

phone

text

[pt] Telefone principal da organização

cep

text

owner_id

text

[pt] Id (Cod. ref.) do owner

city

text

pathpicture

text

profiletype

text

[pt] Perfil da pessoa: Agente = 1, Cliente = 2, Agente e Cliente = 3

businessname

text

[pt] Nome da organização

email

text

[pt] E-mail principal da organização

Ações dos Tickets

Field Type

ticket_id

text

[pt] Número do ticket

    Tickets > > id

id

text

[pt] Id (Número da ação)

origin

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

status

text

[pt] Status da ação

justification

text

[pt] Justificativa da ação

description

text

[pt] Descrição da ação (somente texto)

actions__createddate

timestamp

[pt] Data de criação da ação

htmldescription

text

[pt] Descrição da ação em formato HTML

tags

text

[pt] Lista de strings com as TAGs as quais a ação esta relacionada

type

text

[pt] Tipo do ticket: 1 = Interno 2 = Público

isdeleted

boolean

[pt] Verdadeiro se a ação foi deletada

Pesquisas de Satisfação dos Tickets

Field Type

ticket_id

text

[pt] ID do ticket

    Tickets > > id

satisfactionsurveyresponses__id

text

[pt] Id (Código) da resposta de satisfação

positivenegativeresponse

float

[pt] Pontuação: 1 = Positivo e 2 = Negativo

responsedate

timestamp

[pt] Data UTC da resposta

netpromoterscoreresponse

float

[pt] Pontuação de 0 a 10 (NPS)

smileyfacesresponse

float

[pt] Pontuação de 0 a 10 (NPS)

comments

text

[pt] Comentários

satisfactionsurveymodel

text

[pt] Modelo de pontuação da resposta: 1 = Positivo/Negativo, 2 = Faces sorridentes, 3 = NPS

Campos Customizados dos Tickets

Main Object

Field Type

ticket_id

text

[pt] ID do ticket

    Tickets > > id

lastupdate

timestamp

[pt] Data UTC da ultima alteração do ticket

line

float

[pt] Número da linha da regra de exibição na tela do ticket

customfieldruleid

text

[pt] Id da regra de exibição dos campos adicionais

customfieldid

text

[pt] Id do campo adicional (pode ser obtido na listagem de campos adicionais no website)

value

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

ticket_id

text

customfieldid

text

personid

text

[pt] Id (Cod. ref.) da empresa, departamento ou pessoa

storagefileguid

text

clientid

text

[pt] Id (Cod. ref.) da empresa, departamento ou pessoa

filename

text

team

text

[pt] Nome da equipe

customfielditem

text

[pt] Nome do item do campo adicional

Perguntas das Pesquisas de Satisfação

Main Object

Field Type

id

text

[pt] Identificador da pergunta da pesquisa de satisfação

type

float

[pt] Tipo da pesquisa: Satisfeito ou Insatisfeito = 1, Faces Sorridentes = 2, NPS (Net Promoter Score) = 3, Sim ou Não = 4.

isactive

boolean

[pt] Se a pergunta está ou não ativa

movidesk_survey_questions__languages

Field Type

question_id

text

cultureid

text

[pt] Idioma da pesquisa de satisfação

description

text

[pt] Descrição da pergunta

Respostas das Pesquisas de Satisfação

Field Type

id

text

[pt] Identificador da resposta da pesquisa de satisfação

questionid

text

[pt] Identificador da pergunta da pesquisa de satisfação

    Perguntas das pesquisas de satisfação > > id

responsedate

timestamp

[pt] Data de resposta da pesquisa de satisfação

value

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)

commentary

text

[pt] Comentários da reposta

ticketid

float

[pt] Número do ticket

    Tickets > > id

type

float

[pt] Tipo da pesquisa: Satisfeito ou Insatisfeito = 1, Faces Sorridentes = 2, NPS (Net Promoter Score) = 3, Sim ou Não = 4

clientid

text

[pt] Id (Cod. ref.) da empresa, departamento ou pessoa relacionado como cliente da resposta