Movidesk

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

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

Integrações

Índice

Gráfico de relacionamento

Clique para ampliar

Pessoas

Objeto principal

Campo Tipo

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

Campo Tipo

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

Campo Tipo

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

Campo Tipo

emailtype

text

email

text

isdefault

boolean

persons_id

text

Tickets

Campo Tipo

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

Campo Tipo

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

Campo Tipo

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

Campo Tipo

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

Campos customizados dos tickets

Objeto principal

Campo Tipo

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

Campo Tipo

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

Objeto principal

Campo Tipo

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

Campo Tipo

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

Campo Tipo

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

Tickets Pais/Filhos

Campo Tipo

child_ticket_id

text

[pt] ID do ticket filho

    Tickets > > id

parent_ticket_id

text

[pt] ID do ticket pai

parent_ticket_subject

text

[pt] Assunto do ticket pai

parent_ticket_isdeleted

boolean

[pt] Verdadeiro se o ticket pai foi deletado