Get conversation history

getConversationHistory reads messages from a public channel, private channel, DM, or group DM. Use Get thread replies when you specifically need every reply beneath a parent.

Example

automations/read-slack-history.automation.ts

import { automation } from "automate.ax"
import { getConversationHistory } from "automate.ax/slack"

export default automation("Read Slack history", () => {
  getConversationHistory({
    conversationId: "C01234567",
    limit: 15,
    oldest: "1700000000.000000",
  })
})

Inputs

Input	Type	Required	Default	Description
`conversationId`	`string`	Yes	—	Stable Slack conversation ID.
`cursor`	`string`	No	First page	Opaque cursor from a preceding page.
`limit`	`number`	No	Slack default	Page size from 1 to 15. Slack applies this limit to newly distributed non-Marketplace apps.
`oldest`	`string`	No	Unbounded	Only return messages after this Slack timestamp.
`latest`	`string`	No	Unbounded	Only return messages before this Slack timestamp.
`inclusive`	`boolean`	No	Slack default	Includes messages exactly matching `oldest` or `latest`.
`account`	`string \| IntegrationAccountReference<"slack">`	No	Project default	Slack workspace binding.

Output

Returns messages: SlackMessage[], hasMore: boolean, and responseMetadata.nextCursor. Each message contains text, timestamp, and type, plus available author, thread, block, attachment, file, reaction, reply, app, bot, and subtype fields. hasMore describes Slack’s time-window results; use nextCursor for cursor pagination when present.

Get started

Concepts

Reference

Get conversation history

Example

Inputs

Output

​Example

​Inputs

​Output

Example

Inputs

Output