Set the First Message of a Voice Call
Configure the initial message that greets users when they start a voice conversation.
Static First Message
Set a fixed greeting message with firstMessage option:
new MicdropServer(socket, { firstMessage: 'Hello! How can I help you today?', agent, stt, tts,})Dynamic First Message Generation
Use generateFirstMessage: true to let the AI agent create personalized greetings with systemPrompt:
new MicdropServer(socket, { generateFirstMessage: true, // Agent will generate the first message agent: new OpenaiAgent({ apiKey: process.env.OPENAI_API_KEY, systemPrompt: 'You are a helpful assistant. Start with a warm, personalized greeting.', }), stt, tts,})Let the user speak first
Donβt set a first message to let the user speak first:
new MicdropServer(socket, { agent, stt, tts,})Wake word
If you want the assistant to speak only after the user has spoken specific word(s), you can use the onBeforeAnswer hook in your agent configuration.
const WAKE_WORD = /Hello|Bonjour/const FIRST_MESSAGE = 'Hello! How can I help you today?'
new OpenaiAgent({ apiKey: process.env.OPENAI_API_KEY, systemPrompt: 'You are a helpful assistant.', onBeforeAnswer(stream) { // Process only first message const isFirstAnswer = !this.conversation.some( (message) => message.role === 'assistant' ) if (!isFirstAnswer) return
// Get last user message const lastUserMessage = this.conversation.findLast( (message) => message.role === 'user' ) as MicdropConversationMessage if (!lastUserMessage) return
// Check for wake word(s) if (!WAKE_WORD.test(lastUserMessage.content)) { // Remove message without answering this.cancelLastUserMessage() // Skip normal answer generation return true }
// Send first assistant message this.addAssistantMessage(FIRST_MESSAGE) stream.write(FIRST_MESSAGE) // Skip normal answer generation return true },})With this rule, every sentence spoken before the wake word goes to your speech to text provider. To keep the audio on the device until the word is heard, detect the wake word in the browser and start the call from there.