Skip to content
This repository has been archived by the owner on May 25, 2021. It is now read-only.

aditya-mitra/whatster

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 

Repository files navigation

WhatsTer - WhatsApp Bot

Actions Status

Live at https://whatster.web.app

Get Started

Send join decide-wish as text message to Twilio's number [+1 (415) 523-8886] or click here to start the bot.

About

WhatsTer is a User-Friendly WhatsApp Chat Bot created using Twilio's Whatsapp API. This bot enables you to do image-recognition, send emails with or without attachments to any receiver, sends you jokes, and most importantly, it saves any message or media that you send (or forward) to it, in a database which is accessible on the WhatsTer website.

How it works

When you send a message to the bot, it checks for a command.

The commands are as follows. Follow instructions received via WhatsApp text -

Type <login> 'to log into Whatster to read messages and media sent in this chat.'

Type <mail> 'to send an email to any email address of your choice with or without an attatchment.'

Type <clarifai> 'to use AI to recognize the contents of a sent image.'

Type <joke> 'to get a randomly generated joke.'

By default, any other message or media sent to the bot is saved in the user's specific account database.

If you login to the WhatsTer website, you can see yours saved messages and media from your chat with the bot. You can even delete the messages and media that you don't want in that website.

Works in quite a sync between your WhatsApp account and the WhatsTer account!

Features

  • Image Recognition
  • Email
  • Jokes
  • Messages and Media saved to your account
  • Built using React

How to use it

  1. Create a copy using GitHub's repository template functionality
  2. Update the README.md, package.json and app.json with the respective values.
  3. Build your app as necessary while making sure the tests pass.
  4. Publish your app to GitHub

Set up

Requirements

Twilio Account Settings

This application should give you a ready-made starting point for writing your own appointment reminder application. Before we begin, we need to collect all the config values we need to run the application:

Config Value Description
Account Sid Your primary Twilio account identifier - find this in the Console.
Auth Token Used to authenticate - just like the above, you'll find this here.
Phone number A Twilio phone number in E.164 format - you can get one here

Local development

There are 3 folders.

Each folder is an app on its own.

For each app, there are different setup instructions. Please refer to the specific folder for the specific app you want to set up.

Cloud deployment

I have deployed my webhooks and the server api for the webapp to heroku and client webapp to firebase (for the react app).

Service
Heroku Deploy

Resources

Learn to use Twilio's Whatsapp Sandbox

Learn React

Contributing

My project is open source and welcomes contributions.

Visit the project on GitHub

License

MIT

Disclaimer

No warranty expressed or implied. Software is as is.