I Wrote a Script to WhatsApp My Parents Every Morning in Just 20 Lines of Python Code

Step-by-step guide with walkthrough code

Kartik Nighania
Aug 4, 2019 · 7 min read
Image for post
Image for post
Photo by Brittany Simuangco on Unsplash

In our busy work lives, we often forget to WhatsApp our loved ones. Looking at how regular my parents are in messaging me with inspirational quotes and health tips first thing in the morning, it was time to reciprocate.

Image for post
Image for post

In this tutorial, we will write a simple Python script to send a WhatsApp message. Twilio is the Python package we will use. To run it every day at a certain time, we will put our code on the AWS (Amazon Web Services) cloud.

So let’s get started!

One solution is to use Python’s Selenium package and go to WhatsApp web rather than using Twilio, which is subscription-based after the free tier is over. But as WhatsApp requires QR-code scanning through mobile from time to time, automation wasn’t possible.

We will do it in a three-step process:

Step 1: Twilio Initial Setup

Create a free Twilio account and confirm your email and mobile number.

Image for post
Image for post

Also, a free tier Twilio account requires using Twilio Sandbox for WhatsApp, which means you can’t use your number and have to go through one-time permission to receive WhatsApp messages.

Both can be solved when you get your own number, which is done after WhatsApp approves Twilio to use your number. There is a form to fill out and a wait time too.

Image for post
Image for post

All of this is discouraging, but our free tier solution does the job fine. Also, for now, this is the only available way.

Now you have to connect the receiver’s phone to the WhatsApp Sandbox to start receiving messages.

Go to WhatsApp beta in the learn section of the console.

Image for post
Image for post
Image for post
Image for post

Save the WhatsApp number assigned to you in your contacts. You can give it any name you want. For simplicity, I saved it as Twilio Sandbox, then sent it a message from my dad’s phone, as seen above. This has to be done once and only once.

Now go to Twilio Console and get your account SSID and authentication token. This will help Twilio know it’s you when the code is executed.

Step 2: Understanding and Modifying the Code

Download the GitHub repository and extract it.

Image for post
Image for post
inside the zip file

Inside this, you’ll find our code file and deployment package.

  • whatsapp_messaging.py
  • aws_lambda_deploy.zip
Image for post
Image for post
whatsapp_messaging code file
  • line 1 imports the Twilio package and uses its REST client to hit the Twilio API.
  • line 3: We create a function, msg_mom_and_dad, which will be given to AWS to run every day at a certain time.
  • line 6–7: Replace the sid and auth_token of your account as discussed in step 1.
  • line 9: Twilio client object is created with our credentials.
  • line 13: A Python dictionary is created with name as key and mobile number as value. You can keep adding to this Python dictionary to send messages to more people as well.
  • line 15: A for loop that runs through all the key and value pairs (currently we just have one). In body, mention your message. I have created a simple one, which says good morning, followed by the key value. In the above code, it is “good morning daddy!” We then mention the from number, which is the Twilio WhatsApp number you got earlier, and the to number, from which you previously sent the WhatsApp sandbox confirmation.
  • line 23: A line to check message status by printing the SID. We won’t use this anyway.

We have five things to change:

  • twilio_sid
  • auth_token
  • contact_directory
  • from_
  • body (optional)

After you have changed these, save it. Then extract the aws_lambda_deploy.zip and replace the whatsapp_messaging.py inside it with your newly created one. Zip the package again. We just wanted to change the code with your credentials and contact details. Your deployment package is now ready.

Step 3: Put Our Package on AWS Lambda With Triggers

Our code is ready to run and send WhatsApp messages. If you’re wondering what the other files in our deployment package are, they’re the Twilio package and all its other dependencies. This is because we’ll use an AWS Lambda function in a Python environment that doesn’t have the Twilio package. But why not just run pip install twilio to install it? This is because we don’t have a server here.

Image for post
Image for post

AWS Lambda is a serverless computing service where you have a piece of code that you want to run based on different AWS events and triggers, according to the users’ needs. Therefore, it’s a waste of computing resources and money to run a server (EC2 instance in AWS) 24/7 to do our small cute task. Here our Lambda function will only run for a very short time every day on our mentioned time trigger.

The Lambda service is very cheap and gives you a million requests per month for free.

Image for post
Image for post

Log in to https://aws.amazon.com. Then click on Services -> Compute -> Lambda -> create a function

Image for post
Image for post

Give your function a name.

We selected Python 3.6 as our environment of choice.

As we don’t need to connect to other services in AWS, the option of basic permission is fine.

Click on create function and you’ll be taken to the main dashboard.

Image for post
Image for post

In the function code block, specify to the Lambda Function Handler that we want to run our whatsapp_messaging Python file and the msg_mom_and_dad function inside it each time the Lambda function is called. Change the handler value as above.

At the code entry point, select upload a .zip file, upload the deployment package you created in step 2, and save it.

Our code is ready to run. You can click on test and check that the function successfully sends a message to the specified WhatsApp number.

Our last step is to trigger it every day at a given time. For this, click add trigger -> CloudWatch Events in the designer box.

Image for post
Image for post

We’ll have to create a new rule. You can give it any name and description if you want.

Set the rule type as schedule expression.

We specified the time using cron(). 30 1 refers to 1:30 am, UTC (equivalent to my 7 AM, IST time).

The next two,* *, are for the day of the month and the month.

The next two, ? *, are for the day of the week and year. We set * and ? to specify every day, month, and year. You can refer to the example below to create your own cron parameters. Otherwise, you can refer to the cron guide on aws_cron_docs to learn it in depth.

Image for post
Image for post

After you’re done, make sure the Enable trigger checkbox is checked. Finally, click the add button.

Image for post
Image for post
Image for post
Image for post

On the Lambda function dashboard, you can now see your CloudWatch Event attached to your Lambda function. Upon scrolling down, you can see the CloudWatch event enabled to trigger your function.

That’s it! You can change the Twilio Sandbox name to your name and can even respond to replies from the Twilio dashboard.

Image for post
Image for post

Better Programming

Advice for programmers.

Kartik Nighania

Written by

find me on LinkedIn @ linkedin.com/in/kartik-nighania-765227145 articles also published in HackerNoon, Better Programming, Towards Data Science and TheNextWeb

Better Programming

Advice for programmers.

Kartik Nighania

Written by

find me on LinkedIn @ linkedin.com/in/kartik-nighania-765227145 articles also published in HackerNoon, Better Programming, Towards Data Science and TheNextWeb

Better Programming

Advice for programmers.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store