Get Thread Replies

slack.get_thread_replies
ActionChat & messagingconnection required

Calls the Slack Web API with the connection's bot token.

Read a whole thread: its parent message and every reply, oldest first.

Connection

Required
Yes — the node will not save without one
Auth type
API key
Providers
Slack
Secret shape
the Slack bot token (xoxb-…), or {"token": "xoxb-…"}
Resolved by
config.connection_id, else node.connection_id

Configuration

7 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
channel
Channel id to act on (C…, G… or D…). Supports {{ }}.
stringYes———
ts
The ts of the thread's parent message, or of any message in it.
stringYes———
limit
Maximum messages to return on this page (1-1000).
numberNo1001–1000—
cursor
The next_cursor from a previous page.
stringNo———
oldest
Only messages at or after this Unix timestamp.
stringNo———
latest
Only messages at or before this Unix timestamp.
stringNo———
inclusive
Include the messages that sit exactly on oldest or latest.
booleanNofalse——

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "inclusive": false,
  "limit": 100
}

Output

One shape.

result

FieldTypeExample
messages[].ts
The message timestamp — its id within the channel.
string—
messages[].user
The author's user id, or its bot id for an app message.
string—
messages[].text
The message text.
string—
messages[].type
Always 'message' for a message row.
string—
messages[].thread_ts
The parent message ts when this is a threaded reply.
string—
count
How many messages this page carries.
number—
has_more
True when Slack has further pages of this thread.
boolean—
next_cursor
Cursor for the next page, or empty when done.
string—
{
  "count": 0,
  "has_more": false,
  "messages": [
    {
      "text": "",
      "thread_ts": "",
      "ts": "",
      "type": "",
      "user": ""
    }
  ],
  "next_cursor": ""
}

Notes

  • The bot must be a member of a private channel before it can act there (Slack answers not_in_channel otherwise).
  • Slack rate-limits each Web API method on its own tier; a throttled call fails with the number of seconds to wait and is safe for the node's retry policy to repeat.
  • The first message is the thread parent, so a reply count is count - 1.

See Get Thread Replies run in a workflow.

In a technical demo we add the Slack connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.