How to Send Free WhatsApp Messages Directly from GitHub Actions

Mark816P — Sun, 12 Jul 2026 15:38:37 +0000

Automating notifications is a great way to keep track of your CI/CD pipelines, daily scrapers, or cron jobs. But if you want to send those notifications to WhatsApp, you usually run into a wall: the official API is paid, and third-party APIs (like Twilio or Green API) require subscriptions and trust.

I wanted a solution that was 100% free, ran natively in GitHub Actions, and didn't rely on middlemen. So, I built a workaround using Go and SQLite.

The Problem with WhatsApp Automation

To automate WhatsApp, you have to link a device via a QR code. GitHub Actions runs in the background—there is no screen to scan a QR code every time a workflow runs.

The Solution: "Brain Transplanting" a Session

I used the open-source Go library whatsmeow, which reverse-engineers the WhatsApp Web protocol.

Here is how the automation works:

Local Authentication: You run a local Go script once. It shows a QR code in your terminal. When you scan it, it generates a whatsapp_session.db SQLite file containing your cryptographic keys.
Pruning & Bypassing Limits: GitHub Secrets have a strict 48KB limit. A Python script deletes unnecessary data, compresses it with gzip, and splits it into two Base64 strings.
The Cloud Workflow: You upload those strings as GitHub Secrets. Every time your Action runs, it stitches the secrets back together, reconstructs the database on the server, logs in as your linked device, and sends the message!

🔗 Repository: WhatsGo for GitHub Actions

DEV Community: Mark816P

How to Send Free WhatsApp Messages Directly from GitHub Actions

The Problem with WhatsApp Automation

The Solution: "Brain Transplanting" a Session