Mensajes

Gestiona los hilos de mensajes 1:1 de un proyecto y añade mensajes a ellos.

GET/v1/messages

Parameter	Type	Description
`status`	`string`	Filtrar hilos: open o closed.
`limit`	`integer`	Tamaño de página. Por defecto 20.
`offset`	`integer`	Número de elementos a saltar. Por defecto 0.

GET/v1/messages/:threadId

POST/v1/messages

Parameter	Type	Description
`email`required	`string`	Email del usuario final con quien es el hilo.
`name`	`string`	Nombre visible del usuario final.
`subject`	`string`	Asunto del hilo.
`body`	`string`	Primer mensaje opcional del hilo.
`locale`	`string`	Idioma de los emails de notificación que dispara (en, ar, de, es, fr, he, hi, it, ja, ru, zh). Por defecto: en.

PATCH/v1/messages/:threadId

Parameter	Type	Description
`status`	`string`	open o closed.
`subject`	`string`	Nuevo asunto del hilo.

DELETE/v1/messages/:threadId

POST/v1/messages/:threadId/messages

Parameter	Type	Description
`body`required	`string`	Texto del mensaje.
`sender`	`string`	end_user, member o system. Por defecto member.
`locale`	`string`	Idioma de los emails de notificación que dispara (en, ar, de, es, fr, he, hi, it, ja, ru, zh). Por defecto: en.

Notificaciones: una escritura llega a personas, según quién haya hablado.

Remitente	A quién se notifica
`end_user`	A los miembros del proyecto, según sus preferencias de notificación — más Slack, webhooks y push
`member`	Al usuario final por email, dentro del mismo hilo
`system`	A nadie

POST /v1/messages con body guarda ese cuerpo como mensaje member, así que envía un email al usuario final. La entrega ocurre después de la respuesta: las notificaciones nunca retrasan tu petición.

Envía un locale opcional (en, ar, de, es, fr, he, hi, it, ja, ru, zh) en cualquier escritura para elegir el idioma de los emails que dispara. Ausente → inglés.

Listar hilos


curl "https://api.supdesk.app/v1/messages?status=open&limit=20" \
  -H "Authorization: Bearer sd_live_..."


{
  "data": [
    {
      "id": "t_abc123",
      "end_user_id": "eu_xyz789",
      "subject": "Pregunta sobre la funcionalidad de exportación",
      "status": "open",
      "created_at": "2026-07-01T10:00:00Z"
    }
  ],
  "pagination": { "limit": 20, "offset": 0, "has_more": false }
}

Obtener un hilo


curl "https://api.supdesk.app/v1/messages/t_abc123" \
  -H "Authorization: Bearer sd_live_..."


{
  "data": {
    "id": "t_abc123",
    "end_user_id": "eu_xyz789",
    "subject": "Pregunta sobre la funcionalidad de exportación",
    "status": "open",
    "created_at": "2026-07-01T10:00:00Z",
    "messages": [
      {
        "id": "m_123",
        "sender": "end_user",
        "member_id": null,
        "body": "Tengo problemas con el botón de exportación.",
        "via": "email",
        "created_at": "2026-07-01T10:05:00Z"
      },
      {
        "id": "m_456",
        "sender": "member",
        "member_id": "mem_789",
        "body": "¿Qué navegador estás usando? Esto podría ser un problema específico de Safari.",
        "via": "web",
        "created_at": "2026-07-01T10:10:00Z"
      }
    ]
  }
}

Crear un hilo


curl -X POST https://api.supdesk.app/v1/messages \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jamie@example.com",
    "name": "Jamie",
    "subject": "Pregunta sobre la funcionalidad de exportación",
    "body": "Tengo problemas con el botón de exportación en Safari."
  }'


{
  "data": {
    "id": "t_abc123",
    "end_user_id": "eu_xyz789",
    "subject": "Pregunta sobre la funcionalidad de exportación",
    "status": "open",
    "created_at": "2026-07-01T10:00:00Z",
    "messages": [
      {
        "id": "m_456",
        "sender": "member",
        "member_id": "mem_789",
        "body": "Tengo problemas con el botón de exportación en Safari.",
        "via": "web",
        "created_at": "2026-07-01T10:00:00Z"
      }
    ]
  }
}

Actualizar un hilo


curl -X PATCH https://api.supdesk.app/v1/messages/t_abc123 \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "status": "closed",
    "subject": "Resuelto: Problema con el botón de exportación"
  }'


{
  "data": {
    "id": "t_abc123",
    "end_user_id": "eu_xyz789",
    "subject": "Resuelto: Problema con el botón de exportación",
    "status": "closed",
    "created_at": "2026-07-01T10:00:00Z"
  }
}

Eliminar un hilo


curl -X DELETE https://api.supdesk.app/v1/messages/t_abc123 \
  -H "Authorization: Bearer sd_live_..."

Devuelve 204 No Content en caso de éxito.

Añadir un mensaje a un hilo


curl -X POST https://api.supdesk.app/v1/messages/t_abc123/messages \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Este problema ha sido resuelto en la versión 1.4.0.",
    "sender": "member"
  }'


{
  "data": {
    "id": "m_789",
    "sender": "member",
    "member_id": "mem_789",
    "body": "Este problema ha sido resuelto en la versión 1.4.0.",
    "via": "web",
    "created_at": "2026-07-01T11:00:00Z"
  }
}