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

Add Movidesk as a Data Source on Kondado

Connect your Movidesk help desk data to Kondado's data warehouse by generating an API token and configuring the source.

1
Generate your Movidesk API token

Log in to Movidesk and navigate to Settings > Account > Parameters. Scroll to the bottom of the settings page to find your API key, then copy it for use in Kondado.

2
Add the Movidesk source on Kondado

On the Kondado platform, go to the add data sources page and select the Movidesk connector. Name your data source and paste the token from step 1 into the Token field.

3
Save and start integrating

Save the data source to begin integrating your Movidesk objects—including tickets, persons, satisfaction surveys, and custom fields—into your Data Lake or Data Warehouse.

4
Explore available pipelines

Review the extracted objects such as Pessoas, Tickets, Clientes dos Tickets, Ações dos Tickets, and Campos Customizados to plan your analytics and reporting needs.

Frequently asked questions

What permissions do I need to connect Movidesk to Kondado?
You need permission to generate an API key in Movidesk under Settings / Account / Parameters. Without this access, you won't be able to retrieve the token required for the Kondado connection.
Which Movidesk data objects are available in the Kondado pipeline?
The pipeline includes Pessoas, Tickets, Ticket Clients, Ticket Owners, Ticket Actions, Satisfaction Surveys, Custom Ticket Fields, Survey Questions, and Survey Responses—including custom fields and objects for full analytical coverage.
Can I analyze Movidesk satisfaction survey data with Kondado?
Yes. The pipeline extracts satisfaction survey responses, scores (including NPS and smiley face ratings), comments, and related questions—enabling you to build dashboards and visualizations on customer satisfaction trends.
How are custom fields handled in the Movidesk integration?
Custom fields are fully supported. The pipeline captures custom field values, display rules, and item selections, with dates in UTC format and numeric values in Brazilian format—ready for transformation in your data warehouse.
What should I do if my ticket IDs contain negative values?
Negative ticket IDs may indicate deleted tickets (check the isdeleted field) or migrated data. The Movidesk documentation is unclear on this, so we recommend filtering on isdeleted or validating against your source system when building reports.

Written by·Published 2023-07-17·Updated 2026-04-25