https://github.com/jameskirkby/serverless-contact-form
Email contact form using the Serverless framework on AWS Lambda
https://github.com/jameskirkby/serverless-contact-form
lambda serverless
Last synced: 3 months ago
JSON representation
Email contact form using the Serverless framework on AWS Lambda
- Host: GitHub
- URL: https://github.com/jameskirkby/serverless-contact-form
- Owner: jameskirkby
- Created: 2016-11-17T15:57:51.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-05-11T09:58:25.000Z (about 7 years ago)
- Last Synced: 2024-11-08T22:36:50.047Z (8 months ago)
- Topics: lambda, serverless
- Language: JavaScript
- Size: 6.84 KB
- Stars: 38
- Watchers: 2
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Serverless Email Contact Form
Send contact form emails using Serverless with AWS Lambda and AWS SES
## Prerequisites
You will need:
* An AWS account
* An IAM account with privileges to send emails using SES
* An email address that's been [verified in SES](http://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-email-addresses.html). This is the email you'll be sending your emails to
* The [AWS CLI](https://aws.amazon.com/cli/) installed on your local machine, configured to your IAM credentials
* [serverless](https://serverless.com/) installed on your local machine
## Installation
1. Clone this repository to your local machine, and change to that directory
2. Change the values in `handler.js` in the `ses.sendEmail()` function, set the **ToAddresses** and **Source** to the email you've verified in SES. You can have multiple **ToAddresses**, as long as they're all verified in SES
3. You can test the function locally by running `serverless invoke local --function sendForm --path event.json`. This will run the function using the data in `event.json`
4. Run `serverless deploy` to upload to AWS Lambda
5. You can test the function through Lambda by running `serverless invoke --function sendForm --path event.json`. This will run the function using the data in `event.json`
6. A very basic contact form is included in the repository, `index.html`, replace `API_GATEWAY_URL` with the gateway URL that serverless displays in the console after you've deployed it. You can use this to test that the form works from a webpage. Uncomment the `redirectUrl` field if you want to redirect to another URL after a successful form submission.
7. You should be able to see the results of each form submission in **AWS CloudWatch > Log Groups > /aws/lambda/contact-form-prod-sendForm** (when you're in the AWS Console, make sure you're in the same region that you set in serverless.yml, otherwise the logs may not show up in CloudWatch)