API ReferenceMessage
message.create
Type: Mutation · Auth: Workspace-aware
Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| conversationId | string | Yes | — | ID of the associated conversation |
| direction | enum(inbound, outbound, system) | Yes | — | Direction |
| provider | enum(telegram, whatsapp, discord, slack, microsoft_teams, ai_agent, email) | Yes | — | Provider |
| externalMessageId | string | No | — | ID of the associated external message |
| senderExternalId | string | No | — | ID of the associated sender external |
| senderDisplayName | string | No | — | Sender display name |
| bodyText | string | No | — | Body text |
| bodyRichJson | unknown | No | — | Body rich json |
| attachmentRefsJson | unknown | No | — | Attachment refs json |
| messageType | string | Yes | "text" | Message type |
| sentAt | string.date-time | No | — | Sent at |
| receivedAt | string.date-time | No | — | Received at |
| deliveryStatus | enum(pending, sent, delivered, read, failed) | Yes | "pending" | Delivery status |
| metadataJson | object | No | — | Metadata json |
| relevanceStatus | enum(auto_relevant, confirmed, excluded) | No | — | Relevance status |
| relevanceNote | string | No | — | Relevance note |
Example
{
"conversationId": "550e8400-e29b-41d4-a716-446655440000",
"direction": "inbound",
"provider": "telegram",
"externalMessageId": "550e8400-e29b-41d4-a716-446655440000",
"senderExternalId": "550e8400-e29b-41d4-a716-446655440000",
"senderDisplayName": "example",
"messageType": "text",
"deliveryStatus": "pending"
}