Skip to content

Commit 57ca122

Browse files
authored
Merge pull request #4459 from segmentio/develop
WhatsApp in Engage Public Beta
2 parents 1afd008 + dbd7fb0 commit 57ca122

File tree

14 files changed

+254
-44
lines changed

14 files changed

+254
-44
lines changed

src/_data/sidenav/main.yml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -377,6 +377,10 @@ sections:
377377
title: Email Template Editor
378378
- path: '/engage/content/sms/template'
379379
title: SMS Template
380+
- path: '/engage/content/sms/template'
381+
title: SMS Template
382+
- path: '/engage/content/whatsapp'
383+
title: WhatsApp Template
380384
- section_title: Campaigns
381385
description: "Create multi-channel campaigns to get the right message to your users."
382386
section:
@@ -386,6 +390,8 @@ sections:
386390
title: Email Campaigns
387391
- path: '/engage/campaigns/sms-campaigns'
388392
title: SMS Campaigns
393+
- path: '/engage/campaigns/whatsapp-campaigns'
394+
title: WhatsApp Campaigns
389395
- path: '/engage/analytics'
390396
title: Analytics Overview
391397
- path: '/engage/settings'

src/engage/campaigns/email-campaigns.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ With Twilio Engage, you can send email and SMS campaigns to users who have opted
77

88
Some knowledge of the Journeys product will benefit you as you read through this guide. If you’re new to Journeys, the [Journeys documentation](/docs/personas/journeys/) will bring you up to speed.
99

10-
## How Engage campaign works
10+
## How Engage campaigns work
1111

1212
Twilio Engage uses Journeys to send email and SMS campaigns. With Journeys, you add conditions and steps that trigger actions like sending an email or an SMS.
1313

src/engage/campaigns/sms-campaigns.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ With Twilio Engage, you can send email and SMS campaigns to users who have opted
77

88
Some knowledge of the Journeys product will benefit you as you read through this guide. If you’re new to Journeys, the [Journeys documentation](/docs/personas/journeys/) will bring you up to speed.
99

10-
## How Engage campaign works
10+
## How Engage campaigns work
1111

1212
Twilio Engage uses Journeys to send email and SMS campaigns. With Journeys, you add conditions and steps that trigger actions like sending an email or an SMS.
1313

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
title: WhatsApp Campaigns
3+
plan: engage-premier
4+
---
5+
6+
> info "WhatsApp Public Beta"
7+
> WhatsApp as an Engage channel is in public beta.
8+
9+
## How Engage campaigns work
10+
11+
Twilio Engage uses Journeys to send WhatsApp, email, and SMS campaigns. With Journeys, you add conditions and steps that trigger actions like sending a WhatsApp message.
12+
13+
You’ll build and send your WhatsApp campaign in three stages:
14+
15+
1. Create a Journey.
16+
2. Add a Journey condition.
17+
3. Add a WhatsApp step and publish your campaign.
18+
19+
> warning "WhatsApp Templates"
20+
> To send a WhatsApp campaign, you'll first need an approved WhatsApp template. For instructions on building a template, view [WhatsApp Templates](/docs/engage/content/whatsapp).
21+
22+
### Create a Journey
23+
24+
Because Engage campaigns exist within Journeys, begin by creating a Journey:
25+
26+
1. In Engage, select **Journeys**, then click **Create journey**.
27+
2. Name your Journey and select its entry settings.
28+
3. Click **Build Journey** to create the Journey.
29+
30+
Segment then opens the Journey Builder.
31+
32+
### Add a Journey condition
33+
34+
With your Journey created, you’ll now set a condition to trigger your WhatsApp campaign:
35+
36+
1. Within the Journey builder, click **+ Add Entry Condition**.
37+
2. In the **Add entry condition** pane, give the step a name.
38+
3. Click **+ Add Condition**, select your desired condition, then click **Save**.
39+
40+
With your entry condition added, you’re ready to add an approved WhatsApp template to build a campaign.
41+
42+
### Add a WhatsApp step and publish your Journey
43+
44+
1. Within the Journey builder, click the **+** node below your new condition.
45+
2. From the **Add step** window, click **Send a WhatsApp**.
46+
3. Pick an approved template from the template list, then choose **Select**.
47+
4. Give the WhatsApp message step a name.
48+
5. In the **Sender** field, choose **WhatsApp**, then click **Save**.
49+
6. Segment returns you to the Journey builder. Select **Publish**, then select **Publish journey** in the popup.
50+
51+
Your Journey and WhatsApp campaign are now live. Users who trigger the WhatsApp step’s parent Journey condition will receive your SMS campaign.
52+
53+
## Messaging limits
54+
55+
WhatsApp limits the number of unique recipients that can receive your campaigns. If your Meta Business Account isn't verified, you'll begin with a messaging limit of 250 unique recipients every 24 hours.
56+
57+
Once your Meta Business Account is verified, the number of unique recipients increases, depending on your messaging limit tier. For more information, view Meta's [messaging limits documentation](https://developers.facebook.com/docs/whatsapp/messaging-limits/){:target="_blank"}.

src/engage/content/whatsapp.md

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
title: WhatsApp Template
3+
plan: engage-premier
4+
---
5+
6+
> info "WhatsApp Public Beta"
7+
> WhatsApp as an Engage channel is in public beta.
8+
9+
With Twilio Engage, you can build personalized WhatsApp templates to store and use throughout marketing campaigns.
10+
11+
This page explains how to create, build, and submit WhatsApp templates for approval.
12+
13+
> warning "WhatsApp Template Approval"
14+
> WhatsApp templates must be approved by Meta before you can use them in campaigns.
15+
16+
## WhatsApp template types
17+
18+
You can choose between three WhatsApp template types:
19+
20+
- **Media**, which contain media and text content
21+
- **Text**, which contain text content of up to 1600 characters
22+
- **Call to action**, which contain text content and phone or website buttons
23+
24+
## Build a WhatsApp message template
25+
26+
Follow these steps to build a WhatsApp template:
27+
28+
1. Navigate to **Engage > Content** and click **Create template**.
29+
2. Select **WhatsApp**, then click **Configure**.
30+
3. Enter a template name and select your template's language.
31+
4. Select your template's content type, then click **Next**.
32+
- For text templates, enter your message's text in the **Body** field and add any desired [merge tags](#personalize-with-merge-tags).
33+
- For media templates, enter your message's text in the **Body** field, add the media URL, then add any desired merge tags.
34+
- For call to action templates, enter your message's text in the **Body** field, then add buttons for a phone number or website.
35+
5. Once you've finished adding your template's content, click **Save and submit for WhatsApp approval** or **Save**.
36+
- If you choose to submit your template for approval, confirm by clicking **Submit**.
37+
6. Segment confirms that your template was saved **or** saved and submitted for approval.
38+
39+
## Submit a saved template for approval
40+
41+
If you saved your template without submitting it for approval, it won't be available for use in campaigns until you submit it for approval.
42+
43+
Follow these steps to submit saved templates for approval:
44+
45+
1. Navigate to **Engage > Content > WhatsApp**.
46+
2. In the WhatsApp Templates table, select the template you want to submit for approval.
47+
3. Review your template. If you're ready to submit it for approval, select **Save and submit for WhatsApp approval**.
48+
4. In the **Submit for WhatsApp review** overlay, select **Submit**.
49+
5. Segment then confirms that your template was saved and submitted for approval.
50+
51+
## Personalize with merge tags
52+
53+
You can personalize your WhatsApp templates with merge tags based on profile traits.
54+
55+
To include merge tags in your template, click **+ Add merge tag** in the template builder and select the profile trait(s) you want to include in your message.
56+
57+
Segment displays the merge tag in the body as a numerical value surrounded by curly braces, like `{% raw %}{{1}}{% endraw %}`. When a susbcriber triggers your WhatsApp campaign, Segment will replace the merge tag with the specific value associated with that subscriber's profile.
58+
59+
If a merge tag doesn't apply to a subscriber, Engage will use the content you enter into the **Default content** field.
60+
61+
![Using merge tags with a WhatsApp message](/docs/engage/images/merge_tag.png "Using merge tags with a WhatsApp message")
62+
63+
> info ""
64+
> To learn more about profile traits, visit Segment's [Computed Traits](/docs/engage/audiences/computed-traits/) and [SQL Traits](/docs/engage/audiences/sql-traits/) documentation.
65+
66+
67+
## Template approvals
68+
69+
Meta must first review and approve your WhatsApp template before you can use it in a campaign. Meta approves most templates in under an hour, but some approvals can take up to 48 hours. Keep this time frame in mind if you plan to send time-sensitive campaigns.
70+
71+
For more on the template approval process, view [recommendations and best practices for creating WhatsApp Message Templates](https://support.twilio.com/hc/en-us/articles/360039737753-Recommendations-and-best-practices-for-creating-WhatsApp-Message-Templates){:target="_blank"}.
72+
73+
## Next steps
74+
75+
Once your template has been approved, you can [create a Journey to send a WhatsApp campaign](/docs/engage/campaigns/whatsapp-campaigns).

src/engage/images/merge_tag.png

36.7 KB
Loading

src/engage/index.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ redirect_from:
55
- '/personas/'
66
---
77

8-
Powered by real-time data, Twilio Engage (formerly known as Personas) is a customizable personalization platform with which you can build, enrich, and activate Audiences.
8+
Powered by real-time data, Twilio Engage is a customizable personalization platform with which you can build, enrich, and activate Audiences.
99

10-
Engage Channels builds on top of these Audiences, helping you connect with and market to your customers through email and SMS campaigns.
10+
Engage Channels builds on top of these Audiences, helping you connect with and market to your customers through email, SMS, and WhatsApp campaigns.
1111

1212
## What can you do with Engage?
1313

@@ -23,32 +23,34 @@ Add detail to user profiles with new traits and use them to power personalized m
2323
- [**SQL Traits:**](/docs/engage/audiences/sql-traits/) Run custom queries on your data warehouse using the Engage SQL editor, and import the results into Segment. With SQL Traits, you can pull rich, uncaptured user data back into Segment.
2424

2525
#### Build Audiences
26-
Create lists of users or accounts that match specific criteria. For example, after creating an `inactive accounts` audience that lists paid accounts with no logins in 60 days, you can push the audience to your analytics tools or send an SMS or email campaign with Engage Channels. Learn more about [Engage audiences](/docs/engage/audiences/).
26+
Create lists of users or accounts that match specific criteria. For example, after creating an `inactive accounts` audience that lists paid accounts with no logins in 60 days, you can push the audience to your analytics tools or send an SMS, email, or WhatsApp campaign with Engage Channels. Learn more about [Engage audiences](/docs/engage/audiences/).
2727

2828
#### Sync audiences to downstream tools
2929
Once you create your Computed Traits and Audiences, Engage sends them to your Segment Destinations in just a few clicks. You can use these Traits and Audiences to personalize messages across channels, optimize ad spend, and improve targeting. You can also use the [Profile API](/docs/profiles/profile-api) to build in-app and onsite personalization. Learn more about [using Engage data](/docs/engage/using-engage-data/) and the [Profile API](/docs/profiles/profile-api).
3030

31-
{% include components/reference-button.html href="https://segment.com/customers/drift/" icon="personas.svg" title="Personalizing marketing campaigns" description="Marketing teams use Engage to run real-time multi-channel marketing campaigns, based off specific user attributes they've computed in Engage. Read about how Drift used Engage to increase prospect engagement by 150% in two months." %}
31+
{% include components/reference-button.html href="https://segment.com/customers/drift/" icon="personas.svg" title="Personalizing marketing campaigns" description="Marketing teams use Engage to run real-time multi-channel marketing campaigns based off specific user attributes they've computed in Engage. Read about how Drift used Engage to increase prospect engagement by 150% in two months." %}
3232

3333
## Market to customers with Engage Premier and Channels
3434

35-
To send email and SMS message campaigns with Engage Channels, you'll connect a [Twilio messaging service](https://support.twilio.com/hc/en-us/articles/223181308-Getting-started-with-Messaging-Services){:target="blank"} and [SendGrid subuser account](https://docs.sendgrid.com/ui/account-and-settings/subusers#create-a-subuser){:target="blank"} to your Segment Engage space. Use existing accounts, or create new ones.
35+
To send email, SMS, and WhatsApp campaigns with Engage Channels, you'll connect a [Twilio messaging service](https://support.twilio.com/hc/en-us/articles/223181308-Getting-started-with-Messaging-Services){:target="blank"}, [SendGrid subuser account](https://docs.sendgrid.com/ui/account-and-settings/subusers#create-a-subuser){:target="blank"}, and [WhatsApp messaging service](https://www.twilio.com/docs/whatsapp/self-sign-up){:target="blank"} to your Segment Engage space. Use existing accounts, or create new ones.
3636

3737
View the [onboarding steps](/docs/engage/onboarding/) for more on how to connect Twilio and SendGrid accounts.
3838

39-
#### Send email and SMS messages in Journeys
39+
#### Send email, SMS, and WhatsApp messages in Journeys
4040

41-
Use Engage to build email and SMS campaigns within [Journeys](/docs/engage/journeys/). Send email or SMS campaigns to [subscribed users](#user-subscriptions) based on event behavior and profile traits. With [message analytics](#message-analytics), you can track the performance of your campaigns.
41+
Use Engage to build email, SMS, and WhatsApp campaigns within [Journeys](/docs/engage/journeys/). Send campaigns to [subscribed users](#user-subscriptions) based on event behavior and profile traits. With [message analytics](#message-analytics), you can track the performance of your campaigns.
4242

4343
- **Send Email**: [Build email campaigns](/docs/engage/campaigns/email-campaigns/) with existing templates, or create a new email template within Journeys. Before you send the email, test the template and set [conversion goals](#conversion-goals).
4444

4545
- **Send SMS messages**: [Build SMS campaigns](/docs/engage/campaigns/sms-campaigns/) to message users in real-time as a step in a Journey. For example, create an abandoned cart campaign that texts users a reminder to complete their purchase, along with a promo code. Add [merge tags](#personalize-with-merge-tags) and set conversion goals.
4646

47+
- **Send WhatsApp messages**: [Build WhatsApp campaigns](/docs/engage/campaigns/whatsapp-campaigns) that deliver messages to your customers on the world's most used messaging app.
48+
4749
To learn more, visit the [CSV Uploader](/docs/engage/profiles/csv-upload/) documentation.
4850

49-
#### Build Email and SMS message templates
51+
#### Build Email, SMS, and WhatsApp message templates
5052

51-
Build personalized [email](/docs/engage/content/email/template/) and [SMS](/docs/engage/content/sms/template) templates in Twilio Engage to use in your campaigns. Design email templates with a WYSIWYG [visual editor](/docs/engage/content/email/editor/) or a code editor. Engage saves the templates for you to preview, edit, and reuse throughout Journeys.
53+
Build personalized [email](/docs/engage/content/email/template/), [SMS](/docs/engage/content/sms/template), and [WhatsApp](/docs/engage/content/whatsapp) templates in Twilio Engage for use in your campaigns. Design email templates with a WYSIWYG [visual editor](/docs/engage/content/email/editor/) or a code editor. Engage saves the templates for you to preview, edit, and reuse throughout Journeys.
5254

5355
#### Personalize with merge tags
5456
Insert real-time user profile traits from merge tags to personalize each message. For example, address recipients by name or highlight new products from a user's favorite brand.
@@ -59,10 +61,10 @@ Use the CSV uploader to add or update user profiles and [subscription states](/d
5961
#### User subscriptions
6062

6163
Set user subscription states in two ways:
62-
- [Upload a CSV file](/docs/engage/profiles/csv-upload/) with lists of users along with their phone and email subscription states.
63-
- Programmatically with Segment's [Public API](https://api.segmentapis.com/docs/spaces/#replace-messaging-subscriptions-in-spaces){:target="blank"}.
64+
- [Upload a CSV file](/docs/engage/profiles/csv-upload/) with lists of users along with their phone, email, and WhatsApp subscription states.
65+
- Programmatically with Segment's [Public API](https://api.segmentapis.com/docs/spaces/#replace-messaging-subscriptions-in-spaces){:target="blank"}
6466

65-
Use Engage to add subscription states to user email addresses and phone numbers. Subscription states help determine which users you can send campaigns to in Engage. You can set user subscription states with a [CSV file upload](/docs/engage/profiles/csv-upload/), or programmatically with Segment's [Public API](https://api.segmentapis.com/docs/spaces/#replace-messaging-subscriptions-in-spaces){:target="blank"}
67+
Use Engage to add subscription states to user email addresses and phone numbers. Subscription states help determine which users you can send campaigns to in Engage. You can set user subscription states with a [CSV file upload](/docs/engage/profiles/csv-upload/), or programmatically with Segment's [Public API](https://api.segmentapis.com/docs/spaces/#replace-messaging-subscriptions-in-spaces){:target="blank"}.
6668

6769
#### Message Analytics
6870
With analytics in Engage, you can monitor real-time conversion data. Track message performance and customer interaction beyond clicks and opens. Use campaign dashboards to view events such as `Email Delivered`, `Unsubscribed`, `Spam Reported`, and more.

src/engage/journeys/build-journey.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,7 @@ Journeys offers the following steps:
4545
- **Connect to existing steps**, which joins two separate branches.
4646
- **Send an email**, which sends a [Channels email](/docs/engage/campaigns/email-campaigns/) to a group of users
4747
- **Send an SMS**, which sends a [Channels SMS](/docs/engage/campaigns/sms-campaigns/) to a group of users
48+
- **Send a WhatsApp** (Beta), which sends a [Channels WhatsApp](/docs/engage/campaigns/whatsapp-campaigns/) to a group of users
4849
- **Send to Destinations**, which delivers information about the Journey to the selected Destination
4950

5051
For more details on each available Journey step, view the [Journey step types documentation](/docs/engage/journeys/step-types).

0 commit comments

Comments
 (0)