List conversations
Fetches the conversations on your WhatsApp and other channels.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The MessageBird connection the step signs in with. |
| Conversations per call | 1 to 20 — MessageBird's own maximum here. It answers 10 by default. |
| Skip | How many conversations to skip. Ignored when Fetch every page is on. |
| Fetch every page | Walks the offset from the start. Pages here hold at most 20 rows, so this is many calls — it refuses past 1,000 conversations. |
| Cursor | Paste a previous run's Next cursor to read the page after it. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `messagebird`) |
limit | number, by default 10 |
offset | number, by default 0 |
returnAll | true/false, by default false |
cursor | text |
Output
| Field | Type |
|---|---|
conversations | array |
conversationCountConversations in this answer | number |
hasMoreMore conversations are waiting behind this page | boolean |
totalCountConversations MessageBird has in total | number |
nextCursorCursor for the next page | string |
Sample output, and the expression for each field
- conversationCount0
- conversations[]
- hasMorefalse
- 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>",
"cursor": "",
"limit": 10,
"offset": 0,
"returnAll": false
},
"label": "List conversations",
"type": "messagebird.listConversations",
"version": 2
}Older versions
A flow that already has this version keeps running it. A new step always gets the newest.
Version 1
| Setting | What it is |
|---|---|
| ConnectionRequired | The MessageBird connection the step signs in with. |
| Conversations per call | 1 to 20 — MessageBird's own maximum here. It answers 10 by default. |
| Skip | How many conversations to skip. Ignored when Fetch every page is on. |
| Fetch every page | Walks the offset from the start. Pages here hold at most 20 rows, so this is many calls — it refuses past 1,000 conversations. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `messagebird`) |
limit | number, by default 10 |
offset | number, by default 0 |
returnAll | true/false, by default false |