Servers:
production
Protocols:wss
messages:companies.{companyId}.conversations.{conversationId}
Real-time message channel for a specific conversation.
Clients subscribe to receive messages from the digital employee, agents, and system. Clients publish to send user messages.
History: 100 messages retained for 1 hour. See the Centrifugo history documentation for retrieval details.
- Address
messages:companies.{company Id} .conversations.{conversation Id}
Parameters
- companyType: string
Id requiredUUID of the company
- conversationType: string
Id requiredUUID of the conversation
Receive a message envelope from the server
Receive
The server sends MessageEnvelope objects containing the message state and an operation
that tells the client how to process it. Messages stream in via replace → … → complete.
Message example forreceivemessages:companies.{companyId}.conversations.{conversationId}
{
"proto": 1,
"kind": "message",
"operation": "replace",
"sequence": 1,
"message_snapshot": {
"message_id": "123e4567-e89b-12d3-a456-426614174000",
"participant_from": {
"role": "digital_employee",
"name": "string"
},
"interaction_id": "123e4567-e89b-12d3-a456-426614174000",
"channel_id_from": "string",
"sent_at": "2026-11-15T07:16:39.200Z",
"conversation_id": "123e4567-e89b-12d3-a456-426614174000",
"blocks": [
{
"id": "string",
"type": "text",
"text": "string",
"undefined": "TextBlock"
}
],
"status": "partial",
"trace_id": "string",
"request_user_feedback": true,
"user_feedback_value": "string",
"provenance": {
"manifest_id": "123e4567-e89b-12d3-a456-426614174000",
"manifest_url": "https://example.com",
"ai_origin": "ai_generated"
}
},
"timestamp": "2026-11-15T07:16:39.204Z",
"error": "string"
}
Messages
Send a user message
Send
Publish a user message via subscription.publish().
Message example forsendmessages:companies.{companyId}.conversations.{conversationId}
{
"message_id": "550e8400-e29b-41d4-a716-446655440000",
"participant_from": {
"role": "user",
"name": ""
},
"blocks": [
{
"id": "block-1",
"type": "text",
"text": "Hello, I need help with my booking"
}
],
"interaction_id": "660e8400-e29b-41d4-a716-446655440000",
"channel_id_from": "de-123",
"sent_at": "2025-01-15T10:30:00Z",
"conversation_id": "770e8400-e29b-41d4-a716-446655440000"
}
