Skip to main content

Forwarding Texts to Email

  • Updated

repo: https://github.com/signalwire/guides/tree/main/Messaging/Forward%20Messages%20to%20Email%20-%20NodeJS - language:nodejs - sdk:relayrealtime3 - sdk:relayrealtime4 - product:messaging # Forwarding Texts to Email import LangSwitchMessage from @site/docs/guides/_common/languageSwitcher.mdx; This guide will show you how to write a webhook to handle incoming text messages to a SignalWire phone number and forward them to an email address. We will write a simple server that listens for a message event from SignalWire when an SMS is received, then uses Mailgun.js to send an email. ## What You Need to Run This Code - You can find the full code for this application on [GitHub](https://github.com/signalwire/guides/tree/main/Messaging/Forward%20Messages%20to%20Email%20-%20NodeJS). - You will need a [Mailgun](https://www.mailgun.com/) API key and Domain. - You will need your SignalWire credentials (i.e., Space URL, Project ID, and API token). If you need help finding these, please see [Navigating your SignalWire Space](docs/guides/administration/guides/signalwire-space/navigating-your-space/index.mdx). - You will also need to visit your SignalWire Space to set up your SignalWire phone number message handler. 1. Within the **Phone Numbers** tab of your Space, click on a number you wish to forward texts for and **Edit Settings**. 2. Scroll down to **Message Settings** and choose the **Relay Application** option to Handle Messages. 3. Set any Relay **context** you like. This just has to match your webhook code. Our example will use **office**. 4. Remember to **save** your settings! - You can find the full code for this application on [GitHub](https://github.com/signalwire/guides/tree/main/Messaging/Forward%20Messages%20to%20Email%20-%20NodeJS). - You will need a [Mailgun](https://www.mailgun.com/) API key and Domain. - You will need your SignalWire credentials (i.e., Space URL, Project ID, and API token). If you need help finding these, please see [Navigating your SignalWire Space](docs/guides/administration/guides/signalwire-space/navigating-your-space/index.mdx). - You will also need to visit your SignalWire Space to set up your SignalWire phone number message handler. 1. Within the **Phone Numbers** tab of your Space, click on a number you wish to forward texts for and **Edit Settings**. 2. Scroll down to **Message Settings** and choose the **Relay Application** option to Handle Messages. 3. Set any Relay **topic** you like. This just has to match your webhook code. Our example will use **office**. 4. Remember to **save** your settings!

A
Phone number configuration page.
:::info Note on Email Delivery Service Feel free to use the email delivery service of your choice. Our example will use Mailgun, but this implementation works just as well with other services. Just check their documentation for how to call their API. ::: ## How to Run the Application ### Build and Run on Docker Start by building the image with docker build -t smstoemail . Then run the container with the command docker run -it --rm -p 3000:3000 --name smstoemail --env-file .env smstoemail. ### Build and Run Natively If you would like to run it natively, clone the [GitHub repo](https://github.com/signalwire/guides/tree/main/Messaging/Forward%20Messages%20to%20Email%20-%20NodeJS) and run it with npm start in your terminal. ## Code Walkthrough Within the repo, we will work with two files: - .env.sample which will serve as a template for your .env file - index.js where you will find the main application code. ### Set Your Environment Variables 1. Copy from .env.sample and fill in your values. You will need a SignalWire phone number as well as your API Credentials (API Token, Space URL, and Project ID) from within the API tab of your SignalWire Space. If you need help finding these values, please see the [Navigating your SignalWire Space](/guides/navigating-your-space) guide. You will also need your Credentials from the MailGun API. 2. Save the filled-in file as .env. ### The Application This code is quite simple. We will create a Node.js script, listen for incoming SMS messages with the [SignalWires RELAY Realtime API](docs/sdks/reference/realtime-sdk/relay-v3/00-realtime-sdk-reference.mdx), and send an email in response to each message event with Mailgun.js. Then we connect to the SignalWire RELAY Realtime API: javascript require(dotenv).config(); let { Messaging } = require(@signalwire/realtime-api); const swClient = new Messaging.Client({ project: process.env.PROJECT_ID, token: process.env.API_TOKEN, contexts: [office], }); javascript import dotenv/config; import { SignalWire } from @signalwire/realtime-api; const swClient = await SignalWire({ project: process.env.PROJECT_ID, token: process.env.API_TOKEN, topics: [office], }); let messageClient = swClient.messaging; Finally, we set an event listener for incoming SMS messages which will trigger a network call to Mailgun to send an email with the SMS message and details: javascript swClient.on(message.received, (message) => { let date = new Date().toISOString(); let body = message.body; let from = message.from; let to = message.to; let media = message.media; let data = { from: process.env.EMAIL_FROM, to: process.env.EMAIL_TO, subject: Incoming Message to + to, text: At ${date} you received a message from ${from} to ${to}. The message body was: ${body}. The included media was: ${media}, }; mgClient.messages .create(process.env.MAILGUN_DOMAIN, data) .then((res) => { console.log(data); console.log(res); }) .catch((err) => { console.error(err); }); }); js await messageClient.listen({ topics: [office], onMessageReceived: async (message) => { let date = new Date().toISOString(); let body = message.body; let from = message.from; let to = message.to; let media = message.media; let data = { from: process.env.EMAIL_FROM, to: process.env.EMAIL_TO, subject: Incoming Message to + to, text: At ${date} you received a message from ${from} to ${to}. The message body was: ${body}. The included media was: ${media}, }; mgClient.messages .create(process.env.MAILGUN_DOMAIN, data) .then((res) => { console.log(data); console.log(res); }) .catch((err) => { console.error(err); }); }, }); ## Wrap Up When dealing with SMS messages on a large scale, you may want to convert them into a more manageable format. This guide has demonstrated one possibility by converting them to emails using a remarkable short script of code. ### Resources - [GitHub Repo](https://github.com/signalwire/guides/tree/main/Messaging/Forward%20Messages%20to%20Email%20-%20NodeJS) - [Mailgun API](https://www.mailgun.com/) - [RELAY Realtime SDK](docs/sdks/reference/realtime-sdk/relay-v3/00-realtime-sdk-reference.mdx) - [GitHub Repo](https://github.com/signalwire/guides/tree/main/Messaging/Forward%20Messages%20to%20Email%20-%20NodeJS%20Relay%20V4) - [Mailgun API](https://www.mailgun.com/) - [RELAY Realtime SDK](docs/sdks/reference/realtime-sdk/relay-v3/00-realtime-sdk-reference.mdx)