conversation.connected.backend_error

Backend error event

Triggered when a backend error occurs during connection setup or during an active session. Handle this event to log errors for debugging and show user-friendly error messages.

Event Properties

type · string

Event type. Always "conversation.connected.backend_error" for this event.

data · object

Event data object. May be empty or contain additional metadata.

message · string

Error message from the backend describing the issue.

Example: "Service temporarily unavailable. Please try again in a moment."

Example

{
  "type": "conversation.connected.backend_error",
  "data": {},
  "message": "Service temporarily unavailable. Please try again in a moment."
}

Usage Example

const NavTalkMessageType = Object.freeze({
    CONNECTED_BACKEND_ERROR: "conversation.connected.backend_error",
    // ... other event types
});

async function handleReceivedMessage(data) {
    switch (data.type) {
        case NavTalkMessageType.CONNECTED_BACKEND_ERROR:
            const errorMessage = data.message || "A backend error occurred";
            console.error("Backend error:", errorMessage);
            showError(errorMessage);
            // Log error for debugging
            stopRecording();
            break;
    }
}

When this event is received, a backend error has occurred. You should log the error for debugging purposes while showing user-friendly messages to end users.