API ReferenceConversation
conversation.create
Type: Mutation · Auth: Workspace-aware
Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| workspaceId | string | Yes | — | ID of the associated workspace |
| provider | enum(telegram, whatsapp, discord, slack, microsoft_teams, ai_agent, email) | Yes | — | Provider |
| channelEndpointId | string | Yes | — | ID of the associated channel endpoint |
| subject | string | No | — | Subject |
| linkedRecordType | string | No | — | Linked record type |
| linkedRecordId | string | No | — | ID of the associated linked record |
| state | enum(open, waiting_on_customer, waiting_on_agent, escalated, resolved, closed) | Yes | "open" | State |
| ownerUserId | string | No | — | ID of the associated owner user |
| assignedAgentId | string | No | — | ID of the associated assigned agent |
| requireSessionVerification | boolean | Yes | false | Require session verification |
| visibilityMode | enum(global, workspace_local, shared) | Yes | "workspace_local" | Visibility mode |
| accountResolutionStatus | enum(auto_matched, confirmed, corrected) | No | — | Account resolution status |
| accountResolutionConfidence | number | No | — | Account resolution confidence |
Example
{
"workspaceId": "550e8400-e29b-41d4-a716-446655440000",
"provider": "telegram",
"channelEndpointId": "550e8400-e29b-41d4-a716-446655440000",
"subject": "example",
"linkedRecordType": "example",
"linkedRecordId": "550e8400-e29b-41d4-a716-446655440000",
"state": "open",
"requireSessionVerification": false,
"visibilityMode": "global"
}