Setting Up Voicemail (Node.js)

---title: Setting Up Voicemail (Node.js)sidebar_label: Setting Up Voicemailslug: /guides/voice/setting-up-voicemailsidebar_position: 2---# Setting Up VoicemailA popular and important use case is recording a voicemail from your callers when you are unable to speak with them. This guide will show how to do exactly that.In this guide we will see how to implement a voicemail using Node.js. This allows you the most flexibility in case you want to integrate voicemails with complex workflows.## Assigning a Phone Number to a Relay ContextTo handle calls using Node.js, you should first set up a phone number to handle incoming calls using a Relay application.Click the **Phone Numbers** tab on your lefthand side nav within your SignalWire space, and click the specific number you would like to set up call forwarding on. If you dont have a number yet, now is the time to [buy one](guides/numbers-api/getting-started/buying-a-phone-number/index.mdx)!

## Building the applicationOur phone number is now configured. Lets see how to build the voicemail with Node.js.### InstallationFirst, you need to obtain the Realtime SDK. From your terminal you can run:shell npm2yarnnpm install --save @signalwire/realtime-apiThis will install the Realtime SDK from npm into your project.### CodeThe first thing we need to do is to import the Realtime SDK and initialize a Voice client. We can do it like this:jsimport { Voice } from @signalwire/realtime-api;const client = new Voice.Client({ project: , token: , contexts: [office],});We want to execute our logic whenever a call is received. Lets attach anevent handler to the call.received event, from which we can answer the calland play a message:jsclient.on(call.received, async (call) => { console.log(Got call, call.from, call.to); await call.answer(); const tts = await call.playTTS({ text: Please leave a message with your name and number at the beep. Press the pound key when finished., }); await tts.waitForEnded();});Right after playing the introduction message, we need to start recording. Butbefore that, lets set up an event listener within the call.received handlerwhich will notify us when the recording has ended:js// inside the call.received event handlercall.on(recording.ended, async (rec) => { const tts = await call.playTTS({ text: Thank you for your message. A member of our team will contact you shortly. Goodbye!, }); await tts.waitForEnded(); console.log(Recording URL:, rec.url); await call.hangup();});We can finally start the recording. Since we also want the recording to be nomore than 15 seconds long, we will set a timeout which will stop it if it didntalready end.jsconst recording = await call.recordAudio({ endSilenceTimeout: 0, terminators: #,});// Stop the recording after 15 seconds.setTimeout(() => recording.stop(), 15000);Putting all of the parts together, here is the full code:

index.js

js title=index.jsimport { Voice } from @signalwire/realtime-api;const client = new Voice.Client({ project: , token: , contexts: [office],});client.on(call.received, async (call) => { console.log(Got call, call.from, call.to); await call.answer(); const tts = await call.playTTS({ text: Please leave a message with your name and number at the beep. Press the pound key when finished., }); await tts.waitForEnded(); // Callback to be executed when the recording ends. call.on(recording.ended, async (rec) => { const tts = await call.playTTS({ text: Thank you for your message. A member of our team will contact you shortly. Goodbye!, }); await tts.waitForEnded(); console.log(Recording URL:, rec.url); await call.hangup(); }); const recording = await call.recordAudio({ endSilenceTimeout: 0, terminators: #, }); // Stop the recording after 15 seconds. setTimeout(() => recording.stop(), 15000);});console.log(Started.);

## Wrapping upThe Realtime SDK allows you to build powerful applications with a simple API.You are not limited to phone calls: you can also control messaging, chat, video,and more. See all available options in the [Realtime SDK documentation](docs/sdks/reference/realtime-sdk/00-realtime-sdk-reference.mdx).