Listar timeline de chamado na API v2 do SULTS

Lista a timeline de um chamado: as interações e cada mudança registrada (prazo, responsável, assunto, apoios e conclusão), com o autor e a data de cada evento. O campo type diz o que aconteceu e quais campos acompanham o evento: a interação vem em comment, a troca de assunto em previousCategory e newCategory, o apoio em collaborator e a avaliação de satisfação em satisfactionRating e satisfactionComment.

GET

api

chamados

ticket

timeline-event

list

Listar timeline de chamado

curl --request GET \
  --url https://api.sults.com.br/api/v2/chamados/ticket/timeline-event/list \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.sults.com.br/api/v2/chamados/ticket/timeline-event/list"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.sults.com.br/api/v2/chamados/ticket/timeline-event/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sults.com.br/api/v2/chamados/ticket/timeline-event/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

using RestSharp;


var options = new RestClientOptions("https://api.sults.com.br/api/v2/chamados/ticket/timeline-event/list");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

[
  {
    "createdAt": "2026-10-05T12:48:03Z",
    "user": {
      "id": 55,
      "name": "Carlos Mendes"
    },
    "type": "COMMENT_WITH_STATUS",
    "status": "IN_PROGRESS",
    "comment": {
      "id": 9812,
      "messageHtml": "<p>Técnico da assistência agendado para amanhã às 9h.</p>",
      "attachments": [
        {
          "name": "orcamento-assistencia.pdf",
          "url": "https://link/orcamento-assistencia.pdf",
          "fileLength": 20480
        }
      ],
      "private": false
    }
  },
  {
    "createdAt": "2026-10-05T14:05:12Z",
    "user": {
      "id": 55,
      "name": "Carlos Mendes"
    },
    "type": "CATEGORY_CHANGED",
    "previousCategory": {
      "id": 17,
      "name": "Manutenção preventiva"
    },
    "newCategory": {
      "id": 23,
      "name": "Equipamento com defeito"
    },
    "dueDate": {
      "previous": "2026-10-07T21:00:00Z",
      "new": "2026-10-08T21:00:00Z"
    }
  },
  {
    "createdAt": "2026-10-05T14:06:40Z",
    "user": {
      "id": 55,
      "name": "Carlos Mendes"
    },
    "type": "COLLABORATOR_ADDED",
    "collaborator": {
      "user": {
        "id": 45,
        "name": "Bruno Almeida"
      },
      "department": {
        "id": 4,
        "name": "Manutenção"
      },
      "userAdmin": true
    }
  },
  {
    "createdAt": "2026-10-06T15:22:41Z",
    "user": {
      "id": 63,
      "name": "Juliana Prado"
    },
    "type": "TICKET_CLOSED",
    "satisfactionRating": 5,
    "satisfactionComment": "Forno voltou a funcionar no mesmo dia."
  }
]

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}

{
  "error": "Acesso não autorizado."
}

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}

<string>

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}

Authorizations

Authorization

string

header

required

Token gerado na Gestão de Tokens v2 do SULTS. Deve ser enviado no cabeçalho Authorization de todas as requisições.

Query Parameters

ticketId

integer

required

Código do chamado.

Response

Eventos da timeline do chamado.

createdAt

string<date-time>

Data do evento, em UTC ISO 8601.

Example:

"2026-10-05T12:48:03Z"

user

object

Usuário que gerou o evento.

Show child attributes

type

enum<string>

Tipo do evento.

Valor	Significado
`COMMENT`	Interação
`COMMENT_WITH_STATUS`	Interação com troca de situação
`DUE_DATE_CHANGED`	Mudança de prazo
`ASSIGNEE_CHANGED`	Mudança de responsável
`CATEGORY_CHANGED`	Mudança de assunto
`COLLABORATOR_ADDED`	Adição de apoio
`COLLABORATOR_REMOVED`	Remoção de apoio
`COLLABORATOR_AUTO_ADDED`	Adição de apoio automático
`TICKET_CLOSED`	Conclusão

Available options:

COMMENT,

COMMENT_WITH_STATUS,

DUE_DATE_CHANGED,

ASSIGNEE_CHANGED,

CATEGORY_CHANGED,

COLLABORATOR_ADDED,

COLLABORATOR_REMOVED,

COLLABORATOR_AUTO_ADDED,

TICKET_CLOSED

Example:

"COMMENT_WITH_STATUS"

status

enum<string>

Situação definida pelo evento, em COMMENT_WITH_STATUS.

Available options:

NEW,

IN_PROGRESS,

AWAITING_REQUESTER,

AWAITING_ASSIGNEE,

RESOLVED,

CLOSED

Example:

"IN_PROGRESS"

comment

object

Interação registrada, nos eventos COMMENT e COMMENT_WITH_STATUS.

Show child attributes

previousCategory

object

Assunto anterior, em CATEGORY_CHANGED.

Show child attributes

newCategory

object

Assunto novo, em CATEGORY_CHANGED.

Show child attributes

dueDate

object

Prazo anterior e novo, quando o evento altera o prazo do chamado.

Show child attributes

collaborator

object

Apoio adicionado, em COLLABORATOR_ADDED.

Show child attributes

satisfactionRating

integer

Nota da avaliação de satisfação, de 1 a 5, em TICKET_CLOSED quando a conclusão teve avaliação.

Required range: 1 <= x <= 5

Example:

5

satisfactionComment

string

Comentário da avaliação de satisfação, em TICKET_CLOSED.

Example:

"Forno voltou a funcionar no mesmo dia."

Listar timeline de chamado

curl --request GET \
  --url https://api.sults.com.br/api/v2/chamados/ticket/timeline-event/list \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.sults.com.br/api/v2/chamados/ticket/timeline-event/list"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.sults.com.br/api/v2/chamados/ticket/timeline-event/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sults.com.br/api/v2/chamados/ticket/timeline-event/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

using RestSharp;


var options = new RestClientOptions("https://api.sults.com.br/api/v2/chamados/ticket/timeline-event/list");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

[
  {
    "createdAt": "2026-10-05T12:48:03Z",
    "user": {
      "id": 55,
      "name": "Carlos Mendes"
    },
    "type": "COMMENT_WITH_STATUS",
    "status": "IN_PROGRESS",
    "comment": {
      "id": 9812,
      "messageHtml": "<p>Técnico da assistência agendado para amanhã às 9h.</p>",
      "attachments": [
        {
          "name": "orcamento-assistencia.pdf",
          "url": "https://link/orcamento-assistencia.pdf",
          "fileLength": 20480
        }
      ],
      "private": false
    }
  },
  {
    "createdAt": "2026-10-05T14:05:12Z",
    "user": {
      "id": 55,
      "name": "Carlos Mendes"
    },
    "type": "CATEGORY_CHANGED",
    "previousCategory": {
      "id": 17,
      "name": "Manutenção preventiva"
    },
    "newCategory": {
      "id": 23,
      "name": "Equipamento com defeito"
    },
    "dueDate": {
      "previous": "2026-10-07T21:00:00Z",
      "new": "2026-10-08T21:00:00Z"
    }
  },
  {
    "createdAt": "2026-10-05T14:06:40Z",
    "user": {
      "id": 55,
      "name": "Carlos Mendes"
    },
    "type": "COLLABORATOR_ADDED",
    "collaborator": {
      "user": {
        "id": 45,
        "name": "Bruno Almeida"
      },
      "department": {
        "id": 4,
        "name": "Manutenção"
      },
      "userAdmin": true
    }
  },
  {
    "createdAt": "2026-10-06T15:22:41Z",
    "user": {
      "id": 63,
      "name": "Juliana Prado"
    },
    "type": "TICKET_CLOSED",
    "satisfactionRating": 5,
    "satisfactionComment": "Forno voltou a funcionar no mesmo dia."
  }
]

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}

{
  "error": "Acesso não autorizado."
}

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}

<string>

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}