Conversations

List external conversation messages

Use to read what the guest and assistant said, including message types and stored media context. Discover conversationId with list_conversations. Use each stored messageId for get_message_status, get_conversation_attachment or, for an AI assistant answer, get_conversation_answer_trace. Action results are separate: use list_action_executions filtered by conversationId. Requires conversations:read. Returns customer-facing user and assistant messages in newest-first order, including shared locations, contacts, reactions, media, rendered cards/actions, referrals and delivery details when present. Pass nextCursor as cursor for older messages with the same conversationId; stop when hasMore is false. Internal system/tool activity is excluded. Use conversation.needsReply from metadata as the operator-action signal. Unknown delivery status is not delivery proof.

get/conversations/{conversationId}/messages

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

Opaque, conversation-bound cursor from the previous response. Retrieves older messages.

Response

Newest-first page of external conversation messages

conversationIdstring required
nextCursorstring nullable required

Opaque cursor for the next older page, or null when hasMore is false.

hasMoreboolean required

True when older external messages remain.

Changes

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