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
| Coluna | Descriçã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 |
| historico | Lista 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 |