Agent/Get Conversation Activities
GET /v1/agent/conversations/{id}/activities

Get Conversation Activities

Returns activities for the conversation. When the agent **does not** have CRM contact access for the conversation’s contact, the list may be **filtered**: non-call channel activity can be omitted, and for **call** activities only those where the agent is assignee or a call participant may appear. Full history applies when contact access is granted.

Base URL https://api.{cluster}.{platform}.voiger.io
Request · cURL
curl https://api.{cluster}.{platform}.voiger.io/v1/agent/conversations/{id}/activities?_limit=&_skip= \
  -H "Cookie: sid=$VOIGER_SESSION" \
  -H "x-workspace-code: your-workspace-code"

Parameters

x-workspace-code string required in header
id string required in path
_limit number optional in query
_skip number optional in query

Response

activities▾
array
id
string
type
string What this activity IS -- the one field a renderer switches on. A message's own kind (`text`, `image`, ...), or `call`, `note`, `event`. Distinct from `channel`, which is the medium it rode: a call is `type: "call"`, `channel: "voice"`. A client must tolerate a value it does not know rather than failing to render the thread.
channel
string | null The medium. `null` for a lifecycle event, which rode none. Was called `type`; the database column has been `channel` since September and the value `call` became `voice` in October, and this finishes that rename.
created_at
string
event
string Which lifecycle event this is. Sent only when `type` is `event`.
direction
string A message or a call. Not sent on a note or a lifecycle event.
status
string Where this activity has got to. TWO vocabularies, told apart by `type`: a message's delivery state, or a call's state. They are disjoint, so a value is never ambiguous. A call's OUTCOME is `result`, inside `data` -- `status` says where the call is, `result` says how it ended. Not sent on a note or an event.
external_id
string The provider's own id for this activity -- a WhatsApp `wamid` today. Sent whenever we have one, so a client can reconcile with the provider. Was `provider_message_id`, stored inside `data` and never sent.
actor
any Who did this. On every activity, whatever its kind — the sender of a message, the customer who wrote in, the agent a call belongs to, whoever caused an event. `system` when routing, a timer or an auto-reply did it.
from
any The source party. The customer, on an inbound message; who lost the conversation, on an `assigned` or `queue_set` event. Not sent on an outbound message or a call — a call says `caller`/`callee` inside `data`.
to
any The target party. The customer, on an outbound message; who the conversation went to, on an `assigned` event. Not sent on an inbound message or a call.
cli
any Our own number. Sent on a message only.
data
any The body. `type` says which of these it is -- a message, the call object, a note, or whatever a lifecycle event carries beyond its header. `anyOf` rather than `oneOf` because the discriminator is a sibling of `data`, not a field inside it, so a validator cannot pick the branch on its own.