/ocean-viking-messaging

"Safe and well" SMS service

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

ocean-viking-messaging

Help rescued people inform their loved ones that they're safe and well.

Developed for the rescue ship "Ocean Viking" in support of the HSP@Sea operation.

Description

Synopsis: a dockerized python app that connects Kobo (data collection tool) and Twilio (messaging service).

Worflow: a kobo form registers the name of the rescued person, the number that he/she wants to contact and his/her preferred language. When the kobo form is uploaded, an SMS is automatically sent through Twilio to the input number, in the preferred language, informing that the person has been rescued and is alive.

Setup

  1. Create an account on Kobo
  2. Set up the form in Kobo. It should contain the fields 'name', 'telephone' and 'language'. See an example here.
  3. Create an account on Twilio
  4. Set up a Twilio Messaging Service
  5. Add the Kobo and Twilio credentials in credentials/.env
  6. Deploy the docker image, e.g. using Azure Logic App

Optional: the message and the language can be customized in data/message-text.xlsx