Programmable Messaging for WhatsApp and Go Quickstart
With just a few lines of code, your application can send and receive messages with WhatsApp using the Twilio API for WhatsApp.
This WhatsApp Quickstart will teach you how to do this using the Twilio Sandbox for WhatsApp, Go, the Twilio Go helper library, and the Gin web framework. In this Quickstart, you will learn how to:
- Sign up for Twilio and activate the Sandbox
- Set up your development environment to send and receive messages
- Opt-in to the Sandbox
- Send your first WhatsApp message
- Receive inbound WhatsApp messages
- Reply to incoming WhatsApp messages
Sign up for Twilio and activate the Sandbox
Before you can send a WhatsApp message from your web language, you'll need to sign up for a Twilio account or sign into your existing account and activate the Twilio Sandbox for WhatsApp. The sandbox allows you to prototype with WhatsApp immediately using a shared phone number, without waiting for a dedicated number to be approved by WhatsApp.
To get started, navigate to the Twilio Sandbox for WhatsApp. Look for your unique sandbox keyword listed as "join <your sandbox keyword>" as shown in the image below.
Send this join message to the pre-provisioned Twilio WhatsApp phone number (+1-415-523-8886). For example, if your code is
cheese-bags, you would send the message "join cheese-bags". You'll then receive a confirmation message from Twilio that your sandbox can now be used to send and receive messages!
To disconnect from the sandbox, you can reply to the message from WhatsApp with
sandbox stop, or switch to a different sandbox by messaging
join <other sandbox keyword>.
Inviting other users to your sandbox (OPTIONAL)
To invite someone else to your sandbox, create a link with the following format containing the opt-in message and send it to them:
whatsapp://send?phone=<Your Sandbox Number>&text=<your URL-encoded sandbox keyword>
You can also create a QR code with the link format above that users can scan on their phone to opt in to your sandbox.
Please be aware that the Twilio Sandbox for WhatsApp is meant for testing and discovery purposes only. It should not be used for production.
Gather your Twilio account information
Before you can send any messages, you'll need to gather your Twilio account credentials. You can find these in the Twilio Console.
- Account SID - A unique identifier for your account that is used to authenticate REST API requests
- Auth Token - Essentially the password for your account, used with the Account SID to authenticate REST API requests
You can reveal your Auth Token by clicking Show:
Set your credentials as environment variables
You'll notice that this code's
main function creates a new Twilio client using the
twilio.NewRestClient method, but no credentials are passed to it directly. The Twilio Go helper checks to see if your credentials are available as environment variables, and automatically consumes them for you.
Copy the values from the previous step, and set them as environment variables in your terminal with the following commands (replacing the placeholders with your own values):
export TWILIO_ACCOUNT_SID=<your-account-sid> export TWILIO_AUTH_TOKEN=<your-auth-token>
Check out how to set environment variables for more information or other platform-specific syntax.
If you’ve gone through one of our other Go Quickstarts already and have Go and the Twilio Go helper library installed, you can skip this step and get to the rest of the tutorial.
Before you can follow the rest of this tutorial, you’ll need to have Go and the Twilio Go module installed.
You can check if you already have Go installed on your machine by opening up a terminal and running the following command:
You should see something like:
$ go version go version go1.19 darwin/amd64
If you don't have Go installed, head over to go.dev and download the appropriate installer for your system. Once you've installed Go, return to your terminal, and run the command above once again. If you don't see the installed Go version, you may need to relaunch your terminal.
Initialize your project and install the Twilio Go Helper Library
Create a new Go project from your terminal using:
go mod init twilio-example
Once your project has been initialized, navigate into the newly created
twilio-example directory and install the Twilio Go helper library module.
go get github.com/twilio/twilio-go
This will install the
twilio-go module so that your Go code in the current directory can make use of it.
Send a message with WhatsApp in Go
To send a message, use the following code and replace the input to
params.SetTo with the phone number for your personal WhatsApp account in the E.164 format. (If you haven't already, install WhatsApp on your device and register for an account.)
params.SetFrom, be sure to include the
whatsapp: channel identifier before the Sandbox number in E.164 format:
Receive and reply to messages from WhatsApp
When someone replies to one of your messages, you will receive a webhook request from Twilio.
You can configure webhooks by connecting your Sandbox to an app you've already built for handling incoming messages, or build a new one for WhatsApp messages.
This webhook request also supports TwiML (the Twilio Markup Language) just like a regular Twilio SMS request.
To handle this request, you need to set up a web application and expose it to the internet. The Go SMS Quickstart shows you how to respond to a message and generate TwiML in Go with Gin.
And—that's all there is to it; receiving and responding is exactly the same as you would do in any SMS app with our Messaging API. Cool, right?
Although these Quickstarts show you how to receive an SMS message, the webhook that Twilio will send will include the same parameters as an incoming SMS message, with the exception that To and From addresses will be set to the WhatsApp number receiving the message (
whatsapp:<E.164 formatted Twilio phone number associated with your business>) and the WhatsApp number sending the message (
whatsapp:<User’s E.164 phone number>), respectively.
WhatsNext for WhatsApp and Go?
Because the Twilio WhatsApp API is essentially the same as the Twilio Programmable SMS API, all the documentation for that API applies to your apps sending and receiving messages with WhatsApp. To dive deeper with a WhatsApp integration, see the WhatsApp documentation overview as well as the API Reference.
Here are some areas you might like to explore next.
- Send appointment reminders
- Create SMS conversations
- Messaging API overview
- Browse other SMS tutorials
We can't wait to see what kind of WhatsApp integration you build!
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.