lambda-catfacts

TODO:

• make a better example webpage
• make this readme more clear
• support more than 100 users in unsubscribe

A "Cat Facts" clone made using AWS services and node.js. Sends texts to a group on a schedule. Use the code in this repo and these steps to create your own:

Step 1 - Create SNS Topics

• Create a new sns topic. Note its ARN, you will be using this topic to subscribe endpoints and publish topics to.
• Create another sns topic. We will use this one to send welcome messages.

Step 2 - Create IAM Role

Create an IAM role with the permissions seen in iam.json. We will assign all of the lambda scripts to this role.

step 3 - Create Node.js Lambda functions

• Create the unsubscribe, subscribe and main lambda functions, see unsubscribe.js susbscribe.js and catfacts.js.
• add your topic ARN in each file. Put the main topic and welcome ARNs in the desiginated places in Subscribe.js
• Give them all the role created in step 2.
• Create a "cloudwatch events - schedule" trigger for your main file. Don't worry about adding a trigger for subscribe and unsubscribe, we will trigger them with the API gateway.
• Modify the main js file to contain your facts

Step 4 - Create Application Gateway

• Create a new API with two resources "subscribe" and "unsubscribe"
• Create GET endpoints on both.
• Add the query property "number" to both.
• Use the apigateway-mapping file for both, copy/paste exactly.
• Set them to trigger the corrosponding functions in step 3

After theses steps, you now have the subscribe/unsubscribe api and texting set up. You now need to host a static file that makes requests to your API endpoints with the query string ?number=. You can do this a million ways, below is how to do it with AWS:

step 5 - Add Static page

• Create a s3 bucket with the same name as your subscribe / unsubscribe website
• Upload a index.html from above
• Enable webpage serving on the bucket
• point your DNS to your S3 bucket