You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/actions-twilio-messaging/index.md
+10-9Lines changed: 10 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -2,10 +2,11 @@
2
2
title: Twilio Messaging Destination
3
3
id: 674f23ece330374dc1ecc874
4
4
hidden: true
5
+
hide-dossier: true
5
6
beta: true
6
7
---
7
8
8
-
Twilio Messaging gives businesses a way to reach customers on SMS, MMS, and WhatsApp for transactional notifications and personalized campaigns.
9
+
[Twilio Messaging](https://www.twilio.com/en-us/messaging/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} gives businesses a way to reach customers on SMS, MMS, and WhatsApp for transactional notifications and personalized campaigns.
9
10
10
11
The Twilio Messaging destination connects Segment to Twilio, letting you send messages automatically based on real-time events, audience segments, or journeys without managing complex integrations.
11
12
@@ -32,9 +33,9 @@ To start sending messages through Twilio Messaging, you'll set up your Twilio ac
32
33
33
34
You'll set up the Twilio Messaging destination in three stages:
34
35
35
-
1. Create a Twilio API Key and Secret.
36
-
2. Add the Twilio Messaging destination in Segment.
37
-
3. Configure message mappings to define what messages to send and when.
36
+
1.[Create a Twilio API Key and Secret](#authentication-and-setup).
37
+
2.[Add the Twilio Messaging destination in Segment](#add-the-twilio-messaging-destination).
38
+
3.[Configure message mappings](#configuring-message-mappings) to define what messages to send and when.
38
39
39
40
The following sections walk through each step in detail.
40
41
@@ -110,9 +111,9 @@ To configure the mapping:
110
111
111
112
The Twilio Messaging destination gives you two ways to create and send messages.
112
113
113
-
**Content templates** are templates you’ve already set up in Twilio. They can include text, media, buttons, and other elements, depending on what you’ve built. When you choose a Channel and Content Template Type in Segment, you’ll only see templates that are compatible with those choices. If you’re sending messages to WhatsApp, you’ll need to use Content Templates, since WhatsApp requires pre-approved templates. For most use cases, templates are the way to go because they support richer formatting and keep you compliant.
114
+
**Content templates** are [templates you’ve already set up in Twilio](https://www.twilio.com/docs/content/create-templates-with-the-content-template-builder){:target="_blank”}. They can include text, media, buttons, and other elements, depending on what you’ve built. When you choose a Channel and Content Template Type in Segment, you’ll only see templates that are compatible with those choices. If you’re sending messages to WhatsApp, you’ll need to use Content Templates, since WhatsApp requires pre-approved templates. For most use cases, templates are the way to go because they support richer formatting and keep you compliant.
114
115
115
-
**Inline messages** let you write your message directly in Segment mappings. You can include dynamic variables like `Hello {{first_name}}` to personalize messages. Inline messages also support adding media URLs if you’re sending MMS or WhatsApp messages. They’re useful for quick tests or simple notifications, but they don’t support all the advanced features that Content Templates do.
116
+
**Inline messages** let you write your message directly in Segment mappings. You can include [dynamic variables](#using-variables) to personalize messages. Inline messages also support adding media URLs if you’re sending MMS or WhatsApp messages. They’re useful for quick tests or simple notifications, but they don’t support all the advanced features that Content Templates do.
116
117
117
118
In Segment, map each variable to the event property it should pull from. For example, if your template says {% raw %}`Hello {{first_name}}`{% endraw %}, map `first_name` to the user’s first name property.
118
119
@@ -148,10 +149,10 @@ Variables let you personalize messages with details from your event data or user
148
149
149
150
If you’re using a **Content Template**:
150
151
- Variables must be defined in Twilio when you create the template.
151
-
- In Segment, map each variable to the event property it should pull from. For example, if your template says `Hello {{first_name}}`, map `first_name` to the user’s first name property.
152
+
- In Segment, map each variable to the event property it should pull from. For example, if your template says {% raw %}`Hello {{first_name}}`{% endraw %}, map `first_name` to the user’s first name property.
152
153
153
154
If you’re writing an **inline message**:
154
-
- Add variables directly in your message body using Handlebars, like `Hello {{first_name}}`.
155
+
- Add variables directly in your message body using Handlebars.
155
156
- Define each variable in your mapping so Segment knows what value to insert.
156
157
157
158
You can also use variables in Inline Media URLs to dynamically include different media based on event data.
@@ -181,4 +182,4 @@ Here are a few things to keep in mind when using the Twilio Messaging destinatio
181
182
-**Phone numbers must be approved**. Any phone number you use to send messages must be approved in your Twilio account and support the channel you’re sending on.
182
183
-**Message logs and errors**. If a message fails to send, you can view details in your Twilio Console message logs. Common issues include invalid phone number formats or missing required template fields.
183
184
184
-
Understanding these details will help you set up your messaging flows smoothly and avoid unexpected errors.
185
+
Understanding these details will help you set up your messaging flows smoothly and avoid unexpected errors.
0 commit comments