Historial de conversaciones del Asistente de la persona

curl --request GET \
  --url https://api.ugps.io/api/assistant/conversations \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ugps.io/api/assistant/conversations', 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.ugps.io/api/assistant/conversations",
  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: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ugps.io/api/assistant/conversations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ugps.io/api/assistant/conversations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "conversations": [
    {
      "id": "27b7d741-4d0e-4f7e-9c2a-3f1b2c4d5e6f",
      "title": "¿Qué activos no reportan hoy?",
      "preview": "Tres activos llevan más de un día sin reportar.",
      "lastMessageAt": "2026-11-02T12:00:30.000Z"
    }
  ],
  "nextCursor": "MjAyNi0xMS0wMlQxMjowMDozMC4wMDBafDI3YjdkNzQx"
}

{
  "error": "El email es requerido"
}

{
  "error": "Token inválido o expirado"
}

{
  "error": "No tiene permisos para realizar esta acción"
}

{
  "message": "Error interno del servidor"
}

Asistente

Historial de conversaciones del Asistente de la persona

Las conversaciones del usuario de la sesión dentro de su empresa, de la más reciente a la más vieja, de a 30 por página y sin los mensajes. Ni otros usuarios de la empresa ni el staff de UGPS las ven. Sin búsqueda.

Comportamiento:

Mismas guardas que GET /api/auth/assistant-session: solo una sesión web directa (403 ASSISTANT_WEB_SESSION_REQUIRED para token OAuth del MCP, API token, sesión móvil, portal o impersonación) y empresa con el Asistente habilitado (403 ASSISTANT_DISABLED).
nextCursor es opaco; se manda tal cual en cursor para la página siguiente. null en la última página. Un cursor que no es de esta lista responde 400.

GET

api

assistant

conversations

Historial de conversaciones del Asistente de la persona

curl --request GET \
  --url https://api.ugps.io/api/assistant/conversations \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ugps.io/api/assistant/conversations', 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.ugps.io/api/assistant/conversations",
  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: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ugps.io/api/assistant/conversations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ugps.io/api/assistant/conversations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "conversations": [
    {
      "id": "27b7d741-4d0e-4f7e-9c2a-3f1b2c4d5e6f",
      "title": "¿Qué activos no reportan hoy?",
      "preview": "Tres activos llevan más de un día sin reportar.",
      "lastMessageAt": "2026-11-02T12:00:30.000Z"
    }
  ],
  "nextCursor": "MjAyNi0xMS0wMlQxMjowMDozMC4wMDBafDI3YjdkNzQx"
}

{
  "error": "El email es requerido"
}

{
  "error": "Token inválido o expirado"
}

{
  "error": "No tiene permisos para realizar esta acción"
}

{
  "message": "Error interno del servidor"
}

Authorizations

Authorization

string

header

required

Token de sesión Better Auth o API token (atk_...) en el header Authorization: Bearer <token>. Los JWT legacy ya no son válidos.

Query Parameters

cursor

string

El nextCursor de la página anterior

Response

Página del historial

conversations

object[]

required

Show child attributes

nextCursor

string | null

required

Example:

"MjAyNi0xMS0wMlQxMjowMDozMC4wMDBafDI3YjdkNzQx"