Endpoint: Listando timeline de chamado

Endpoint que permite a listagem da timeline (interações e ações realizadas) de um chamado específico na plataforma da SULTS.

URL: https://api.sults.com.br/api/v1/chamado/ticket/<chamadoId>/timeline

Método: GET

Parâmetros

Headers

Header	Valor
Authorization	<token_de_acesso>
Content-Type	application/json;charset=UTF-8

Path parameters

Parâmetro	Valor
chamadoId	Id do chamado, deve ser passado na URL como parâmetro de path

Exemplo

fetch("https://api.sults.com.br/api/v1/chamado/ticket/1/timeline", {
	method: "GET",
	headers: {
		"Authorization":"<token_de_acesso>",
		"Content-Type":"application/json;charset=UTF-8"
	}
})

Resposta

{
    "data": [
        {
            "criado": "2022-06-27T13:15:26Z",
            "pessoa": {
                "id": 1,
                "nome": "Pessoa que interagiu"
            },
            "situacao": 1,
            "interacao": {
                "id": 301,
                "mensagemHtml": "<p>Mensagem</p>",
                "interno": false,
                "anexos": [
                    {
                        "id": 21,
                        "nome": "arquivo.png",
                        "url": "https://link/arquivo.png",
                        "tamanho": 7633
                    }
                ]
            }
        },
        {
            "criado": "2022-06-27T13:15:26Z",
            "pessoa": {
                "id": 191,
                "nome": "colaborador SULTS"
            },
            "tipo": 3,
            "prazoResolver": {
                "anterior": "2022-06-27T13:15:26Z",
                "novo": "2022-06-27T13:15:26Z"
            }
        },
        {
            "criado": "2022-06-27T13:15:26Z",
            "pessoa": {
                "id": 191,
                "nome": "colaborador SULTS"
            },
            "situacao": 3,
            "interacao": {
                "id": 307,
                "mensagemHtml": "<p>ok</p>",
                "anexos": []
            }
        },
        {
            "criado": "2022-06-29T17:15:26Z",
            "pessoa": {
                "id": 105,
                "nome": "colaborador SULTS"
            },
            "tipo": 9,
            "avaliacaoNota": 5,
            "avaliacaoObservacao": ""
        }
    ]
}

Campos da reposta

Campos principais

Nome Atributo	Tipo	Descrição
criado	String	Data em que foi criado o item da timeline.
pessoa	Objeto Pessoa: – id – nome	Pessoa que fez a solicitação do chamado.
situacao	Integer referente a um dos valores abaixo: 1 – Novo Chamado 2 – Concluído 3 – Resolvido 4 – Em Andamento 5 – Aguardando Solicitante 6 – Aguardando Responsável	Situação atual do chamado.
tipo	Integer referente a um dos valores abaixo: 1 – Nova interação 3 – Mudança de prazo estipulado 4 – Mudança de responsável 5 – Mudança de Assunto 7 – Adição de pessoa como apoio 8 – Remoção 9- Concluído	Tipo da interação do chamado

Campo interacao

Nome Atributo	Tipo	Descrição
id	Integer	Código do item da timeline
mensagemHtml	String	Mensagem em texto HTML da interação
anexos	Lista de Objeto Anexo: – id – nome – URL	Lista de arquivos anexados na interação
interno	Boolean	Indica se a interação é interna ou não
avaliacaoNota	Integer	Nota de avaliação do chamado. Observação: Esse campo é enviado apenas se a interação for do tipo igual a 9.
avaliacaoObservacao	String	Observação da avaliação do chamado. Observação: Esse campo é enviado apenas se a interação for do tipo igual a 9.

Campo prazoResolver

Objeto PrazoResolver, esse campo só é retornado se o tipo do item da timeline for igual a 3 ou 5.

Nome Atributo	Tipo	Descrição
anterior	String	Prazo anterior
novo	String	Prazo novo

Campo responsavelAnterior

Objeto Pessoa, esse campo somente é retornado se o tipo do item da timeline for igual a 4.

Nome Atributo	Tipo	Descrição
id	Integer	Código da pessoa
nome	String	Nome da pessoa responsável anterior do chamado

Campo responsavelNovo

Objeto Pessoa, esse campo somente é retornado se o tipo do item da timeline for igual a 4.

Nome Atributo	Tipo	Descrição
id	Integer	Código da pessoa
nome	String	Nome da nova pessoa responsável do chamado

Campo assuntoAnterior

Objeto Assunto, esse campo somente é retornado se o tipo do item da timeline for igual a 5.

Nome Atributo	Tipo	Descrição
id	Integer	Código do assunto
assunto	String	Texto com assunto anterior da interação

Campo assuntoNovo

Objeto Assunto, esse campo somente é retornado se o tipo do item da timeline for igual a 5.

Nome Atributo	Tipo	Descrição
id	Integer	Código do assunto
assunto	String	Texto com assunto novo da interação