Programmable Messaging for WhatsApp and Go Quickstart

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.

Expand image

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>.

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.

Expand image

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:

Expand image

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):

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:

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.

Create a new Go project from your terminal using:

Once your project has been initialized, navigate into the newly created twilio-example directory and install the Twilio Go helper library module.

This will install the twilio-go module so that your Go code in the current directory can make use of it.

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.)

For params.SetFrom, be sure to include the whatsapp: channel identifier before the Sandbox number in E.164 format: whatsapp:+14155238886.

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.

Expand image

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 Programmable Messaging 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?

Because the Twilio WhatsApp API is essentially the same as the Twilio Programmable Messaging API, all of 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
• The Programmable Messaging API overview

We can't wait to see what kind of WhatsApp integration you build!