Ler um Chamado

Retornar informações de um chamado via API no TomTicket.


Endpoint

https://api.tomticket.com/chamado/{token}/{identificador_chamado}


Coluna
Descrição
token
Token de acesso único e secreto para sua empresa. Clique aqui para ver como criar.
identificador_chamado
Identificador do chamado.


Método

GET


Parâmetros

ColunaDescrição
Tipo
Tamanho Máximo
Parâmetros Opcionais
stopwatch
Permite listar os horário cronometrados num chamado. O valor deve ser 1 para ativar a listagem.
Int
-
show_staggered_tickets
Permite listar os chamados escalonados para o chamado. O valor deve ser 1 para ativar a listagem.
Int
-

Retorno

O retorno é feito no formato JSON.




Coluna
Descrição
Tipo
erro
Informa se ocorreu um erro na operação. Se o retorno for false, então significa que a operação ocorreu com sucesso e não ocorreram problemas.
Caso o retorno seja true, ocorreu um erro e será necessário verificar o campo mensagem para identificar o problema.
Boolean
mensagem
Detalhes da operação, caso tenha ocorrido ou não um problema.
String
idchamado
Identificador do chamado.
String
protocolo
Protocolo do chamado.
String
titulo
Título do chamado.
String
mensagem
Mensagem informado pelo cliente.
String
nomecliente
Nome do cliente.
String
email_cliente
Endereço de email do cliente.
String
id_cliente
Identificador interno do cliente.String
nomeorganizacao
Nome da organização do cliente.
String
prioridade
Identificador da prioridade do chamado.

1 - Baixo
2 - Normal
3 - Alto
4 - Urgente
Int
tipochamado
Tipo de chamado.

I - Interno (Criado entre atendentes)
E - Externo (Criado pelo cliente externo)
String
tempotrabalho
Tempo em segundos de quanto foi trabalhado.
Int
tempoabertura
Tempo em segundos desde a data de abertura do chamado.
Int
data_criacao
Data e hora de criação do chamado.
Timestamp
deadline
Data e hora para encerrar o chamado.
Timestamp
valoritemhora
Valor a ser cobrado por hora.
Float
valoritemhoraextra
Valor a ser cobrado por hora extra.
Float
valorfinal
Valor final do chamado.
Float
valorfinalextra
Valor final da hora extra.
Float.
valorfinalbruto
Valor de soma de do final + hora extra.
Float
avaliadoproblemaresolvido
Define se o problema foi resolvido.

S - Sim
N - Não
String
avaliadoatendimento
Avaliação do atendimento. B-Bom, R-Ruim, P-Péssimo,   O-Ótimo,   M-Regular,

B - Bom
R - Ruim
P - Péssimo
O - Ótimo
M - Regular
String
avaliacaocomentario
Observação do atendimento.
String
dataprimeiraresposta
Data/hora em que o chamado recebeu a primeira resposta.
Timestamp
dataencerramento
Data/hora em que o chamado foi finalizado.
Timestamp
ultimasituacao
Código da última situação do chamado.

1 - Aceito pelo atendente
2 - Respondida pelo atendente
3 - Respondida pelo usuário
4 - Cancelada
5 - Finalizada
6 - Troca de atendente
7 - Envio para equipe de suporte
String
dataultimasituacao
Data que ocorreu a última situação.
Timestamp
sla_inicializacao_cumprido
Informa se o SLA de Inicialização foi cumprido. Caso nulo significa que não possui SLA de inicialização definido.Boolean
sla_deadline_cumprido
Informa se o SLA de Deadline foi cumprido. Caso nulo significa que não possui SLA de deadline definido.Boolean
descsituacao
Descrição da situação.
String
categoria
Categoria do chamado.
String
departamento
Departamento do chamado.
String
atendente
Nome do atendente responsável pelo chamado.String
id_cliente
Identificador interno do cliente
String
status
Descrição do status do chamado
String
dataultimostatus
Data e hora do último status adicionado no chamado
Timestamp
nomeorganizacao
Nome da organização do cliente
String
anexos
Lista com todos os anexos do chamado na abertura.Array
anexos
nome
Nome do arquivo.
String
data
url
URL para download do arquivo.String
data
tamanhobytes
Tamanho em bytes do arquivo.Int
historicoLista com todas as respostas enviadas por atendente e cliente.Array
historico
id
Identificador único para o histórico.
String
historico
origem
Informação de quem enviou a resposta.

C - Cliente
A - Atendente
String
historico
mensagem
Resposta enviada.String
historico
atendente
Nome do atendente, caso a mensagem tenha sido enviada pelo atendente.String
historico
data_hora
Data e hora de envio da resposta.Timestamp
historico
hora_inicio
Hora de início de trabalho para a resposta.
Ela é preenchida pelo atendente.
Timestamp
historico
hora_fim
Hora de fimde trabalho para a resposta.
Ela é preenchida pelo atendente.
Timestamp
historico
anexos
Lista de anexos enviados ao responder um chamado.Array
historico
anexos
nome
Nome do arquivo.
String
historico
anexos
url
URL para download do arquivo.
String
historico
anexos
tamanhobytes
Tamanho em bytes do arquivo.
Int
campospersonalizados
Lista com os campos personalizados usados na abetura do chamado.
Array
campospersonalizados
id
Identificador do campo personalizado.
String
campospersonalizados
label
Nome do campo personalizado.
String
campospersonalizados
value
Valor do campo personalizado.
String
campospersonalizados_finalizados
Lista com os campos personalizados usados na finalização do chamado.
Array
campospersonalizados_finalizados
label
Nome do campo personalizado.
String
campospersonalizados_finalizados
value
Valor do campo personalizado.
String
historico_status
Lista com os status que o chamado recebeu.
Array
historico_status
id
Identificador único para o status.
String
historico_status
status
Nome do status.
String
historico_status
comentario
Comentário inserido no momento da definição do status.
String
historico_status
atendente_inicio
Nome do atendente que inseriu o status.
String
historico_status
atendente_fim
Nome do atendente que finalizou o status.
String
historico_status
inicio
Data e hora da definição do status.
Timestamp
historico_status
fim
Data e hora do encerramento do status.
Timestamp
stopwatch
Lista com horários cronometrados.
Array
stopwatch
id
Identificador único do horário.
String
stopwatch
start
Data e hora de início do horário cronometrado.
Timestamp
stopwatch
end
Data e hora de fim do horário cronometrado.
Timestamp
stopwatch
created_manually
Define se o horário foi criado manualmente ou através do recurso.

True: O horário foi adicionado manualmente.
False:O horário foi criado pelo sistema de cronômetro.

Boolean
stopwatch
operator
Atendente que criou o horário.
String
staggered_tickets
Lista de chamados escalonados.
Array
staggered_tickets
protocolo
Protocolo do chamado escalonado.
String
staggered_tickets
idchamado
Identificador do chamado.
String
staggered_tickets
titulo
Assunto do chamado.
String
parent_ticket_id
Identificador do chamado pai caso este seja um chamado escalonado.
String



Was this article helpful?  
We appreciate your review.