Skip to main content

CreateEngagement creates a new customer engagement.

POST 
/api/v1/engagements

Creates an engagement for tracking a customer conversation. The engagement can be immediately assigned to an agent or left for routing.

Parameters​

  • type: Required, engagement channel type
  • channel_type: Required, specific channel (e.g., "whatsapp")
  • contact_id: Required, customer contact reference
  • source_id/source_type: Required, origin tracking

Errors​

  • INVALID_ARGUMENT: Missing required fields
  • NOT_FOUND: Contact or channel not found
  • PERMISSION_DENIED: Caller lacks engagement:write permission

Request​

Responses​

A successful response.