FlowmageDocs

List conversation messages

BetaReads dataVersion 2

Reads the messages inside one conversation, newest first.

Settings

SettingWhat it is
ConnectionRequiredThe MessageBird connection the step signs in with.
Conversation idRequiredThe List conversations node gives you the ids.
Messages per call1 to 20 — MessageBird's own maximum here. It answers 10 by default.
SkipHow many messages to skip. Ignored when Fetch every page is on.
Fetch every pageWalks the offset from the start. Pages here hold at most 20 rows, so this is many calls — it refuses past 1,000 messages.
CursorPaste a previous run's Next cursor to read the page after it.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `messagebird`)
conversationIdtextits `{{ }}` must give a string
limitnumber, by default 10
offsetnumber, by default 0
returnAlltrue/false, by default false
cursortext

Output

FieldType
messagesarray
messageCountMessages in this answernumber
hasMoreMore messages are waiting behind this pageboolean
totalCountMessages in the conversation in totalnumber
nextCursorCursor for the next pagestring
Sample output, and the expression for each field
  • hasMorefalse
  • messageCount0
  • messages[]
  • totalCount0

Errors

When a step of this node stops a run, the run page shows a code. Look it up:

Example step

The step as a flow file holds it. Replace each value in <…>.

{
  "config": {
    "connection": "<connection id>",
    "conversationId": "<conversation id>",
    "cursor": "",
    "limit": 10,
    "offset": 0,
    "returnAll": false
  },
  "label": "List conversation messages",
  "type": "messagebird.listConversationMessages",
  "version": 2
}

Older versions

A flow that already has this version keeps running it. A new step always gets the newest.

Version 1
SettingWhat it is
ConnectionRequiredThe MessageBird connection the step signs in with.
Conversation idRequiredThe List conversations node gives you the ids.
Messages per call1 to 20 — MessageBird's own maximum here. It answers 10 by default.
SkipHow many messages to skip. Ignored when Fetch every page is on.
Fetch every pageWalks the offset from the start. Pages here hold at most 20 rows, so this is many calls — it refuses past 1,000 messages.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `messagebird`)
conversationIdtextits `{{ }}` must give a string
limitnumber, by default 10
offsetnumber, by default 0
returnAlltrue/false, by default false