nexmo-community / firebase-functions-sms-example

Send and Receive SMS Messages with Cloud Functions for Firebase

Vonage SMS with Firebase Functions

This example sends and receives Vonage SMS with Cloud Functions for Firebase. Inbound SMS messages use a webhook on Firebase to add the message to the Firebase Realtime Database. Upon creation, a triggered function will echo back the original text to the phone number.

Welcome to Vonage

If you're new to Vonage, you can sign up for a Vonage account and get some free credit to get you started.

Project Prerequisites

• Google Cloud account
• Vonage account
• SMS enabled phone

Install Example

1. Clone this repository and switch to the cloned directory

Setup Firebase

1. Setup Firebase Tools
   1. Run firebase init functions
   2. Create a new project
   3. Select JavaScript
   4. Add ESLint (optional)
   5. Do not overwrite any files
   6. Install all dependencies
2. Open Firebase console https://console.firebase.google.com/project/YOUR-PROJECT-ID/ overview . Go to ⚙️ -> Project Settings
   1. Update Google Cloud Platform (GCP) resource location to something near your location
   2. Go to ⚙️ -> Usage and Billing -> Details & Settings
   3. Update the plan to Blaze - Pay As You Go
3. Run firebase deploy --only functions
   1. Copy the function route - https://[LOCATION]-[YOUR-PROJECT-ID].cloudfunctions.net/inboundSMS

Setup Vonage

1. Setup the Vonage CLI
2. Create a new application vonage apps:create
3. Purchase a new phone number using. The example below will buy an available US phone number. For more information on SMS Countries and Features - visit the API Support Help Center vonage numbers:search US vonage numbers:buy [NUMBER] --country_code US
4. Link the number (for instance 15555555555) to the application vonage apps:link [APPID] --number=[NUMBER]
5. Add the function to the inbound SMS in the Vonage dashboard https://[LOCATION]-[YOU R-PROJECT-ID].cloudfunctions.net/inboundSMS
6. Add your Vonage keys to the Firebase environment variables firebase functions:config:set vonage.api_key="Your Key" vonage.api_secret="Your Secret"

Try It Out

Text anything you want to the purchased number, and it will echo back what you sent in.

To: 15555555555
Hello World!

From: 15555555555
You sent the following text: Hello World!

Getting Help

We love to hear from you so if you have questions, comments or find a bug in the project, let us know! You can either:

• Open an issue on this repository
• Tweet at us! We're @VonageDev on Twitter
• Or join the Vonage Community Slack

Further Reading

• Check out the Developer Documentation
• Details about Vonage SMS Functionality
• Getting started with Cloud Functions for Firebase