VIvisitoai
Tickets

Initiate human takeover

Explicitly initiate an escalation for a source conversation. Acceptance durably creates the case, pauses AI, invalidates stale responses and uses existing handoff billing/notification rules. One unresolved escalation may own a conversation. General tickets stay open. Does not send a customer acknowledgement. Use assignment and Start work afterward; reconcile uncertain outcomes with get_ticket_request_status before retrying.

post/escalations

Request

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

Headers

Idempotency-Keystring required

Reuse only with the exact original request. If the outcome is uncertain, reconcile the returned requestId before retrying.

Request body

conversationIdstring required
titlestring required
descriptionstring
propertyIdstring

Response

Confirmed resource state.

ticketIdstring required
tenantIdstring required
conversationIdstring
type'ticket' | 'escalation' required
status'pending' | 'in_progress' | 'resolved' | 'cancelled' required
titlestring required
descriptionstring required
revisioninteger required
channelstring
contextStatus'available' | 'unavailable' required
createdAtstring required
updatedAtstring required
resolvedAtstring
permittedActionsstring[] required

Changes

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