Conversation Starters Settings

conversationStarters

Defines the set of conversation starter prompts displayed to the user. This property is an object containing two arrays — KNOWLEDGE and ACTION — each representing a distinct type of starter.

KNOWLEDGE: Used for informational or contextual questions based on existing knowledge.

ACTION: Used for task-oriented starters that trigger specific actions.

Each item in either array must follow the format { title: "" }.

Type: object
Default Value: { "KNOWLEDGE": [], "ACTION": [] }

defaultConversationStarter

Specifies which conversation starter group (KNOWLEDGE or ACTION) is shown by default when the chat loads.

Type: string
Default Value: "KNOWLEDGE"
Accepted Values: "KNOWLEDGE" | "ACTION"

startNewConversationOnStarterClick

Determines whether clicking a conversation starter automatically initiates a new conversation instead of continuing the current one.

Type: boolean
Default Value: false

Example

foldspace.agent('API-KEY').setConfiguration({
  conversationStartersSettings: {
    defaultConversationStarter: "KNOWLEDGE",
    startNewConversationOnStarterClick: true,
    conversationStarters: {
      KNOWLEDGE: [
        { title: "What is your return policy?" },
        { title: "How do I track my order?" },
        { title: "Show me product specifications" }
      ],
      ACTION: [
        { title: "Schedule a demo" },
        { title: "Check my order status" },
        { title: "Contact support" }
      ]
    }
  }
});