Conversations

List conversation handoffs

Use to investigate escalation reasons, captured/missing handoff fields, notification events and handoff/review resolutions for one conversation. Discover conversationId with list_conversations. Action execution receipts are separate in list_action_executions. Requires conversations:read. Returns a paginated combined window of handoff and review cases: default/max 30 total cases, ordered by creation time then stored identity, newest first. Follow nextCursor with the same conversation and limit until hasMore=false. Each case contains its latest five events in chronological order, eventsHasMore and eventsNextCursor for list_conversation_handoff_events. Resolution details are fetched independently of the preview. Captured/missing fields, property/working-hours context and resolution remain available. Cases/events can change during reads; deduplicate identities. Check current conversation handoffStatus/activeHandoffCaseId for current ownership, which may not be on a historical page. Reads never resolve a case or send a notification.

get/conversations/{conversationId}/handoffs

Request

  • Base URL
    https://platform-api.visitoai.com/m2m/v1
  • Auth
    HTTP bearer

Path parameters

conversationIdstring required

Stored conversationId from list_conversations; keep the connected business and conversation unchanged for continuation reads.

Query parameters

limitinteger
cursorstring

Response

Success

conversationIdstring
conversationKeystring
limitinteger required
hasMoreboolean required
nextCursorstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.