Sign inGet Started

bird whatsapp conversations list-events

Usage

Code example
bird whatsapp conversations list-events <conversation-id> [flags]

Description

The activity history of one conversation as a cursor page, newest first: each move of control between the Meta Business Agent and your application, each assignment change, and each notification sent to the agent. Messages are not events; list them with the conversation's messages. Filter with type for one kind.

Returns a paginated JSON envelope; narrow with the filters below and page with --limit and --starting-after.

Examples

Code example
bird whatsapp conversations list-events <conversation-id>
bird whatsapp conversations list-events <conversation-id> | jq -r '.data[].id'
bird whatsapp conversations list-events <conversation-id> --limit 50 --starting-after <cursor>

Options

Pagination

NameDescription
--ending-beforeCursor from the prev_cursor or refresh_cursor field of a previous list response. Returns items immediately before the cursor position in the current sort order. prev_cursor returns the preceding page. refresh_cursor anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
--limit <n>Maximum number of items to return per page. Allowed range: 1 to 100.
--starting-afterCursor from the next_cursor field of a previous list response. Returns items immediately after the cursor position in the current sort order.

Filters

NameDescription
--response-schemaPrint the fields this command returns, then exit
--typeKeep only events of this exact type (for example whatsapp_conversation.control_changed). Omit for every type. Known values: whatsapp_conversation.control_changed, whatsapp_conversation.assigned, whatsapp_conversation.agent_notified (others may exist).
NameDescription
bird whatsapp conversations countsGet WhatsApp conversation counts
bird whatsapp conversations getGet a WhatsApp conversation
bird whatsapp conversations get-messageGet a message in a WhatsApp conversation
bird whatsapp conversations listList WhatsApp conversations
bird whatsapp conversations list-messagesList messages in a WhatsApp conversation
bird whatsapp conversations updateUpdate a WhatsApp conversation

Continue with the documentation, guides and examples for this topic.