Workspaces & VIP
Group channels into workspaces and unlock conversation analytics.
Workspaces
A workspace groups a subset of an organization's channels. Use
GET /workspaces to list them, then pass a
workspaceId to GET /channels to see which
channels belong to it.
VIP workspaces
A VIP workspace additionally exposes conversation analytics — AI-labeled insight into the DMs and comments your audience sends. The endpoints below are workspace- and channel-scoped; they reject channels not connected to the workspace.
| Endpoint | Use it for |
|---|---|
| Label overview | Aggregates — per-label counts and trends against a total-activity baseline. Use for "how many / compare / trend" questions. |
| VIP messages | Drill-down — individual messages with their full text. Use to read what people wrote, not to compute counts. |
| VIP users | People — the VIP users themselves, with a limited profile field set. |
Both VIP messages and VIP users have CSV export variants: exportVipMessages and exportVipUsers.
Broadcasts, ads & campaigns
Workspaces also surface outbound and paid-media analytics:
| Endpoint | Use it for |
|---|---|
| Broadcasts | Sent broadcast messages; fetch one with getBroadcast. |
| Ad accounts | Connected ad accounts and their campaigns. |
| Campaign insights | Aggregate or daily campaign performance. |
VIP analytics live only in VIP-type workspaces. Discover channels with the
workspaceId filter first, then call the per-channel VIP endpoints.