Programmable Messaging for WhatsApp curl Quickstart

With just a few lines of code, your application can send and receive messages with WhatsApp using the Twilio API for WhatsApp and curl.

This WhatsApp Quickstart will teach you how to do this using the Twilio Sandbox for WhatsApp, curl, the Twilio API for WhatsApp, and a web framework of your choice.

In this Quickstart, you will learn how to:

1. Sign up for Twilio and activate the Sandbox.
2. Set up your development environment to send and receive messages
3. Opt-in to the Sandbox
4. Send your first WhatsApp message
5. Receive inbound WhatsApp messages
6. Reply to incoming WhatsApp messages

Prefer to watch a video? The video below shows you how to use the Sandbox to send and receive 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. It 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, select a number from the available sandbox numbers to activate your sandbox.

join <your sandbox keyword>" to your Sandbox number in WhatsApp to join your Sandbox, and we'll reply with a confirmation that you've joined. Your sandbox keyword can be found in the console.

Once you join, you will only receive messages from your specific Sandbox. 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>.

curl

_10

EXCLAMATION_MARK='!'

_10

curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages.json" \

_10

--data-urlencode "From=whatsapp:+14155238886" \

_10

--data-urlencode "Body=Hello there$EXCLAMATION_MARK" \

_10

--data-urlencode "To=whatsapp:+15005550006" \

_10

-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

_24

{

_24

"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",

_24

"api_version": "2010-04-01",

_24

"body": "Hello there!",

_24

"date_created": "Thu, 24 Aug 2023 05:01:45 +0000",

_24

"date_sent": "Thu, 24 Aug 2023 05:01:45 +0000",

_24

"date_updated": "Thu, 24 Aug 2023 05:01:45 +0000",

_24

"direction": "outbound-api",

_24

"error_code": null,

_24

"error_message": null,

_24

"from": "whatsapp:+14155238886",

_24

"num_media": "0",

_24

"num_segments": "1",

_24

"price": null,

_24

"price_unit": null,

_24

"messaging_service_sid": "MGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",

_24

"sid": "SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",

_24

"status": "queued",

_24

"subresource_uris": {

_24

"media": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Media.json"

_24

},

_24

"to": "whatsapp:+15005550006",

_24

"uri": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.json"

_24

}

---

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.

Rate this page:

12345