Сообщения

Управляйте 1-к-1 диалогами сообщений проекта и добавляйте сообщения в них.

Уведомления: запись доходит до людей — в зависимости от того, кто написал.

Отправитель	Кого уведомляем
`end_user`	Участников проекта, согласно их настройкам уведомлений — а также Slack, исходящие webhooks и push
`member`	Конечного пользователя по электронной почте, в той же переписке
`system`	Никого

POST /v1/messages с body записывает это тело как сообщение member, поэтому отправляет письмо конечному пользователю. Доставка выполняется после ответа — уведомления никогда не задерживают ваш запрос.

Передайте необязательный locale (en, ar, de, es, fr, he, hi, 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"
  }'