Messaggi

Notifiche: una scrittura raggiunge qualcuno, in base a chi ha parlato.

Mittente	Chi viene avvisato
`end_user`	I membri del progetto, secondo le loro preferenze di notifica — più Slack, webhook e push
`member`	L’utente finale via email, nello stesso thread
`system`	Nessuno

POST /v1/messages con un body registra quel corpo come messaggio member, quindi invia un’email all’utente finale. La consegna avviene dopo la risposta: le notifiche non rallentano mai la tua richiesta.

Passa un locale opzionale (en, ar, de, es, fr, he, hi, it, ja, ru, zh) su qualsiasi scrittura per scegliere la lingua delle email che genera. Assente → inglese.

Elenca i thread


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": "Domanda sulla funzionalità di esportazione",
      "status": "open",
      "created_at": "2026-07-01T10:00:00Z"
    }
  ],
  "pagination": { "limit": 20, "offset": 0, "has_more": false }
}

Ottieni un thread


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


{
  "data": {
    "id": "t_abc123",
    "end_user_id": "eu_xyz789",
    "subject": "Domanda sulla funzionalità di esportazione",
    "status": "open",
    "created_at": "2026-07-01T10:00:00Z",
    "messages": [
      {
        "id": "m_123",
        "sender": "end_user",
        "member_id": null,
        "body": "Sto avendo problemi con il pulsante di esportazione.",
        "via": "email",
        "created_at": "2026-07-01T10:05:00Z"
      },
      {
        "id": "m_456",
        "sender": "member",
        "member_id": "mem_789",
        "body": "Quale browser stai usando? Questo potrebbe essere un problema specifico di Safari.",
        "via": "web",
        "created_at": "2026-07-01T10:10:00Z"
      }
    ]
  }
}

Crea un thread


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": "Domanda sulla funzionalità di esportazione",
    "body": "Sto avendo problemi con il pulsante di esportazione su Safari."
  }'


{
  "data": {
    "id": "t_abc123",
    "end_user_id": "eu_xyz789",
    "subject": "Domanda sulla funzionalità di esportazione",
    "status": "open",
    "created_at": "2026-07-01T10:00:00Z",
    "messages": [
      {
        "id": "m_456",
        "sender": "member",
        "member_id": "mem_789",
        "body": "Sto avendo problemi con il pulsante di esportazione su Safari.",
        "via": "web",
        "created_at": "2026-07-01T10:00:00Z"
      }
    ]
  }
}

Aggiorna un thread


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": "Risolto: Problema pulsante esportazione"
  }'


{
  "data": {
    "id": "t_abc123",
    "end_user_id": "eu_xyz789",
    "subject": "Risolto: Problema pulsante esportazione",
    "status": "closed",
    "created_at": "2026-07-01T10:00:00Z"
  }
}

Elimina un thread


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

Restituisce 204 No Content in caso di successo.

Aggiungi un messaggio a un thread


curl -X POST https://api.supdesk.app/v1/messages/t_abc123/messages \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Questo problema è stato risolto nella versione 1.4.0.",
    "sender": "member"
  }'


{
  "data": {
    "id": "m_789",
    "sender": "member",
    "member_id": "mem_789",
    "body": "Questo problema è stato risolto nella versione 1.4.0.",
    "via": "web",
    "created_at": "2026-07-01T11:00:00Z"
  }
}