Express.js application to log incoming SMS messages via the Vonage Messages API to an Airtable base.
- A Vonage account. If you're new to Vonage, you can sign up for a Vonage account and get some free credit to get you started.
- An Airtable account
- Node.js installed on your machine
- Ngrok to make the code on our local machine accessible to the outside world
- The [Vonage CLI]:
npm install @vonage/cli -g
Download and run ngrok from the terminal targetting port 3000 with ngrok http 3000
. Take note of the ngrok URL.
Copy this pre-made Airtable base into your account. Take note of the base ID (If 'https://airtable.com/tblAuZ8qFuP2I8mDh/viwVyLmBMW772S9sd' is the URL of your Airtable webpage then tblAuZ8qFuP2I8mDh
is the base ID).
# Search numbers that can send/receive SMS (replace GB for other regions)
$ vonage number:search GB
# Buy a number from the list
$ vonage numbers:buy NUMBER_FROM_LIST
# Create a new Vonage messages application
$ vonage apps:create "Application Name" --messages_inbound_url=https://7YOUR_NGROK_URL/inbound --messages_status_url=YOUR_NGROK_URL.ngrok.io/status
# Link your number to your application
$ vonage link:app --number=VONAGE_NUMBER APPLICATION_ID
- Rename
config.json.example
toconfig.json
and populate with appropriate keys - Install dependencies with
npm install
- Run the application uing
node index.js
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
- Check out the Developer Documentation at https://developer.vonage.com
In the interest of fostering an open and welcoming environment, we strive to make participation in our project and our community a harassment-free experience for everyone. Please check out our Code of Conduct in full.
We ❤️ contributions from everyone! Check out the Contributing Guidelines for more information.
This project is subject to the MIT License