🎀Micdrop

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.