love-messenger

Send love messages to your dearly beloved via your favorite HTTP action.

This app retrieves the message of the day from a Google Spreadsheet and sends it via 46elks' messaging API to a specified number. The app is tailored for running on a free Heroku dyno and to be called daily via a free cron service (e g Crondash).

Send message

Call the /message endpoint with POST, the query var key set to the API_KEY defined in the env vars and the receiver_number body var set to the international format of the receiving number.

$ curl -X POST http://localhost:8080/message?key=abc123 -d "receiver_number=+46701231231"

Running in production on Heroku

1. Set the env vars in the Heroku app panel
2. $ npm install
3. $ heroku local

Env vars

The following env vars are required

• API_KEY: The API key for the application
• ELKS_API_PASSWORD: Your 46elks password
• ELKS_API_USERNAME: Your 46elks username
• GOOGLE_SPREADSHEET_ID: The ID of the message spreadsheet
• MESSAGE_SENDER_NAME: Name of the sender

Slack

It's possible to log everything at a certain log level to Slack. In order to achieve that, set the following env vars:

• SLACK_API_TOKEN: API token
• SLACK_CHANNEL: Name of channel to post to
• SLACK_DOMAIN: Sub domain for the slack organization
• SLACK_LOG_LEVEL: Log level, default is info
• SLACK_USERNAME: Username of integration

Running locally

1. Define the env vars for production in .env
2. $ npm install
3. $ heroku local

Develop

Run tests with $ npm run test

Watch tests with $ npm run test:watch

Run test coverage report with $ npm run test:coverage

Message spreadsheet

The messages to be sent are retrieved from a Google Spreadsheet. This sample sheet has ID 1WQNN7rUDkpccCtDu6QDQUu2z1wE8msOZS8QWcFw5kvQ, which is what is supposed to be the value of the env var GOOGLE_SPREADSHEET_ID.