receive-sms

Receive and reply to SMS with Twilio and TypeScript

This is an example project showing how to receive and reply to SMS messages with the Twilio Programmable Messaging API and TypeScript.

You can read about how to receive and reply to SMS message with TypeScript and Twilio on the Twilio blog.

Running this project

Things you will need

• Node.js
• A Twilio account (if you don't have one yet, sign up for a free Twilio account here and receive $10 credit when you upgrade)
• A Twilio phone number that can receive SMS messages
• ngrok so that you can respond to webhooks in your local development environment

Get the code

Clone the repo and change into the receive-sms directory:

git clone https://github.com/philnash/twilio-typescript-examples.git
cd twilio-typescript-examples/receive-sms

Dependencies

Install the dependencies:

npm install

Compile the TypeScript to JavaScript

Compile the project:

npm run build

Note that this runs the TypeScript compiler, tsc, you could also run npx tsc to get the same output.

The TypeScript project will be compiled into the dist directory.

You can also continuously compile the project as it changes with

npm run watch

Run the project

Start the web server with:

npm start

Expose the local server with ngrok

To respond to an incoming webhook you will need a publicly available URL. ngrok is a tool that can tunnel through from a public URL to your machine. Once you've downloaded and installed ngrok you can run it like so:

ngrok http 3000

The ngrok terminal will show you a URL, like https://RANDOM_STRING.ngrok.io.

Connect your phone number to your app

Using the ngrok URL from the last part, you can set up your Twilio phone number with your application. Edit your phone number and in the Messaging section, next to when "A message comes in" enter your ngrok URL with the path /messages.

https://RANDOM_STRING.ngrok.io/messages

Save the phone number and you are ready.

Send your number a message and you should receive a message in reply 🎉