List WhatsApp and SMS conversations in the workspace | Voicebip

Returns conversation summaries ordered by creation time, newest first. Use agent_id or channel to narrow. Paginated by opaque next_page_token. For per-conversation message history, follow up with GET /v1/conversations/{conversation_id}.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

agent_idstringOptional

channelenumOptional

Allowed values:

page_sizeintegerOptional

page_tokenstringOptional

Response

Paginated list of conversations

conversationslist of objects

next_page_tokenstring

1	{
2	"conversations": [
3	{
4	"conversation_id": "conversation_id",
5	"agent_id": "agent_id",
6	"channel": "sms",
7	"from_number": "from_number",
8	"to_number": "to_number",
9	"opt_out": true,
10	"created_at": "2024-01-15T09:30:00Z",
11	"updated_at": "2024-01-15T09:30:00Z",
12	"window_expires_at": "2024-01-15T09:30:00Z",
13	"last_message_at": "2024-01-15T09:30:00Z"
14	}
15	],
16	"next_page_token": "next_page_token"
17	}

$	curl https://api.voicebip.com/v1/conversations \
>	-H "Authorization: Bearer <token>"