Messages

Gérez les fils de messages 1:1 d’un projet et ajoutez-y des messages.

GET/v1/messages

Parameter	Type	Description
`status`	`string`	Filtrer les fils : open ou closed.
`limit`	`integer`	Taille de page. 20 par défaut.
`offset`	`integer`	Nombre d'éléments à sauter. 0 par défaut.

GET/v1/messages/:threadId

POST/v1/messages

Parameter	Type	Description
`email`required	`string`	E-mail de l'utilisateur final avec qui est le fil.
`name`	`string`	Nom d'affichage de l'utilisateur final.
`subject`	`string`	Sujet du fil.
`body`	`string`	Premier message optionnel du fil.
`locale`	`string`	Langue des e-mails de notification déclenchés (en, ar, de, es, fr, he, hi, it, ja, ru, zh). Par défaut : en.

PATCH/v1/messages/:threadId

Parameter	Type	Description
`status`	`string`	open ou closed.
`subject`	`string`	Nouveau sujet du fil.

DELETE/v1/messages/:threadId

POST/v1/messages/:threadId/messages

Parameter	Type	Description
`body`required	`string`	Texte du message.
`sender`	`string`	end_user, member ou system. member par défaut.
`locale`	`string`	Langue des e-mails de notification déclenchés (en, ar, de, es, fr, he, hi, it, ja, ru, zh). Par défaut : en.

Notifications : une écriture atteint quelqu’un, selon qui a parlé.

Expéditeur	Qui est notifié
`end_user`	Les membres du projet, selon leurs préférences de notification — plus Slack, webhooks et push
`member`	L’utilisateur final par e-mail, rattaché à la conversation
`system`	Personne

POST /v1/messages avec un body enregistre ce corps comme message member et envoie donc un e-mail à l’utilisateur final. L’envoi a lieu après la réponse : les notifications ne retardent jamais votre requête.

Passez un locale optionnel (en, ar, de, es, fr, he, hi, it, ja, ru, zh) sur toute écriture pour choisir la langue des e-mails déclenchés. Absent → anglais.

Lister les fils


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": "Question sur la fonction d'exportation",
      "status": "open",
      "created_at": "2026-07-01T10:00:00Z"
    }
  ],
  "pagination": { "limit": 20, "offset": 0, "has_more": false }
}

Obtenir un fil


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


{
  "data": {
    "id": "t_abc123",
    "end_user_id": "eu_xyz789",
    "subject": "Question sur la fonction d'exportation",
    "status": "open",
    "created_at": "2026-07-01T10:00:00Z",
    "messages": [
      {
        "id": "m_123",
        "sender": "end_user",
        "member_id": null,
        "body": "J'ai des problèmes avec le bouton d'exportation.",
        "via": "email",
        "created_at": "2026-07-01T10:05:00Z"
      },
      {
        "id": "m_456",
        "sender": "member",
        "member_id": "mem_789",
        "body": "Quel navigateur utilisez-vous ? Ceci pourrait être un problème spécifique à Safari.",
        "via": "web",
        "created_at": "2026-07-01T10:10:00Z"
      }
    ]
  }
}

Créer un fil


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": "Question sur la fonction d'exportation",
    "body": "J'ai des problèmes avec le bouton d'exportation sur Safari."
  }'


{
  "data": {
    "id": "t_abc123",
    "end_user_id": "eu_xyz789",
    "subject": "Question sur la fonction d'exportation",
    "status": "open",
    "created_at": "2026-07-01T10:00:00Z",
    "messages": [
      {
        "id": "m_456",
        "sender": "member",
        "member_id": "mem_789",
        "body": "J'ai des problèmes avec le bouton d'exportation sur Safari.",
        "via": "web",
        "created_at": "2026-07-01T10:00:00Z"
      }
    ]
  }
}

Mettre à jour un fil


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": "Résolu : Problème du bouton d'exportation"
  }'


{
  "data": {
    "id": "t_abc123",
    "end_user_id": "eu_xyz789",
    "subject": "Résolu : Problème du bouton d'exportation",
    "status": "closed",
    "created_at": "2026-07-01T10:00:00Z"
  }
}

Supprimer un fil


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

Renvoie 204 No Content en cas de succès.

Ajouter un message à un fil


curl -X POST https://api.supdesk.app/v1/messages/t_abc123/messages \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Ce problème a été résolu dans la version 1.4.0.",
    "sender": "member"
  }'


{
  "data": {
    "id": "m_789",
    "sender": "member",
    "member_id": "mem_789",
    "body": "Ce problème a été résolu dans la version 1.4.0.",
    "via": "web",
    "created_at": "2026-07-01T11:00:00Z"
  }
}