Support Inbox

List a conversation's messages

The thread's messages oldest first, 50 per page. internal: true notes are withheld unless the token also carries support-conversation:update: reading a private remark about a member takes the same permission as writing one.

direction is inbound (from the member) or outbound (from your team). author_kind is contact, creator or system; author_user_id names the team member on an outbound reply and is null for inbound and system messages.

source is the surface the message came through: connector_chat for a member writing to the connector's installation, dashboard, api or mcp for a reply from your team, and connector_relay_dm or connector_relay_group for a reply your team typed on the platform itself (into the relay's ping, or inside the thread the relay opened in a group). Messages recorded before the connector SDK carry the same three meanings under the Telegram connector's older words, telegram_bot, telegram_relay_dm and telegram_relay_group.

delivery_status on an outbound message is pending → sent, or failed / unreachable. unreachable means the member has blocked the bot: the reply is stored but will never arrive, and retrying will not help. failure_reason carries the detail.

body is null for media sent without a caption. A captioned photo puts the caption in body and does not create a second message. A member editing an earlier message updates the stored message in place and stamps edited_at; no new message is created and no event fires. Inbound messages are rate-limited per member: excess messages are dropped silently rather than queued, so a flooding member produces no burst of events.

Each entry of attachments carries the file's kind, mime, file_name, size, width, height, duration and url.

File ids are never returned. A platform file id plus the bot token is enough to download the file straight from the platform, so it is treated as a credential. url is populated only after the file has been fetched at least once; it is null until then.

get/v1/support/conversations/{conversation}/messages

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/support/conversations/{conversation}/messages
  • Auth: HTTP bearer

Path parameters

conversationstring uuid required

The thread, resolved by the route binder.

Query parameters

pageinteger

The page to return, 1-indexed.

per_pageinteger

Messages per page, 1 to 100.

limitinteger

An alias of per_page, kept for older integrations.

Response

The page.

Example response

{
  "data": [
    {
      "id": "6c18f7a3-2e95-4d60-b47a-c093e5182b7f",
      "conversation_id": "9e042b6f-5d81-4c37-a920-7b3e18cf6d45",
      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "direction": "inbound",
      "author_kind": "contact",
      "type": "text",
      "source": "connector_chat",
      "delivery_status": "sent",
      "body": "My invite link expired before I could join",
      "attachments": [
        {
          "kind": "photo",
          "mime": "image/jpeg",
          "size": 84213,
          "width": 1280,
          "height": 720,
          "url": "https://static.subscriby.net/support/6c18f7a3.jpg"
        }
      ],
      "created_at": "2026-08-20T10:05:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.