📄 README.md

Thought of the Day Call-In Service

Set up a database with audio files and their associated dates. When users call a virtual phone number they will have today's audio file played to them.

This project was built to support those who can't make it to group faith gatherings and don't have the provision to join video calls.

Requirements

A GitHub account
A Netlify account
An Airtable account
A Vonage API Account

Set Up

Login to your Airtable account and copy this boilerplate base into your account.
Go to your Airtable account, generate a personal API key and take note of it. Do not share this key as it carries the same permissions as your entire Airtable account.
Go to the Airtable API dashboard, select your new base and take note of the Base ID (in the first section on the page).
Click this link and fill in your Airtable Base ID and API Key. Your Airtable Table should be Thoughts unless you've changed the table name in the new Airtable base. Also provide a fallback message which will be read to your users if there is no thought of the day.
Click save and deploy and wait for the Production deploy to complete successfully. Take note of the Netlify application URL.
Sign up for a Vonage API Account.
Buy a new Vonage virtual number.
Create a new Vonage API application:

Provide and name you want - it has no impact on this project.

Click Generate public and private key.

Turn on Voice under Capabilities.

Event URL: yournetlifyapp_url/.netlify/functions/event

Answer URL: yournetlifyapp_url/.netlify/functions/answer

Save changes and in the 'Linked numbers' section link your new virtual number

When users call the number they will now get a thought of the day, or a fallback message.

Adding thoughts

Add a new row in Airtable
Provide the thought date in the Date field
Upload a single MP3 file to the File field

Notes

If there is more than one thought for the day then this application will pick the first.
The 'Today' field is automatic and can be ignored, but must exist.