メッセージ

プロジェクトごとの1対1メッセージスレッドを管理し、スレッドにメッセージを追加します。

通知： 書き込みは、誰が発言したかに応じて相手に届きます。

送信者	通知される相手
`end_user`	プロジェクトのメンバー（各自の通知設定に従います）— および Slack、送信 Webhook、プッシュ
`member`	エンドユーザー宛にメールで、同じ会話にスレッド化されます
`system`	誰にも通知しません

body を指定した POST /v1/messages はその本文を member メッセージとして記録するため、エンドユーザーにメールを送信します。送信はレスポンスの後に実行されるため、通知がリクエストを遅らせることはありません。

任意の locale（en、de、es、fr、it、ja、ru、zh）を書き込みに渡すと、送信されるメールの言語を選べます。省略時は英語です。

スレッド一覧


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": "エクスポート機能についての質問",
      "status": "open",
      "created_at": "2026-07-01T10:00:00Z"
    }
  ],
  "pagination": { "limit": 20, "offset": 0, "has_more": false }
}

スレッド取得


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


{
  "data": {
    "id": "t_abc123",
    "end_user_id": "eu_xyz789",
    "subject": "エクスポート機能についての質問",
    "status": "open",
    "created_at": "2026-07-01T10:00:00Z",
    "messages": [
      {
        "id": "m_123",
        "sender": "end_user",
        "member_id": null,
        "body": "エクスポートボタンに問題があります。",
        "via": "email",
        "created_at": "2026-07-01T10:05:00Z"
      },
      {
        "id": "m_456",
        "sender": "member",
        "member_id": "mem_789",
        "body": "お使いのブラウザは何ですか？これはSafari固有の問題かもしれません。",
        "via": "web",
        "created_at": "2026-07-01T10:10:00Z"
      }
    ]
  }
}

スレッド作成


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": "エクスポート機能についての質問",
    "body": "Safariでエクスポートボタンに問題があります。"
  }'

スレッド更新


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": "解決済み：エクスポートボタンの問題"
  }'

スレッド削除


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

スレッドへのメッセージ追加


curl -X POST https://api.supdesk.app/v1/messages/t_abc123/messages \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "body": "この問題はバージョン1.4.0で修正されました。",
    "sender": "member"
  }'