Merge pull request #7982 from segmentio/twilio-messaging-pub-beta

[Twilio Messenger] - To Public Beta

Author: joe-ayoub-segment

src/connections/destinations/catalog/actions-twilio-messaging/index.md

@@ -1,7 +1,7 @@
 ---
 title: Twilio Messaging Destination
 id: 674f23ece330374dc1ecc874
-hidden: true
+hidden: false
 hide-dossier: true
 beta: true
 ---
@@ -12,10 +12,10 @@ The Twilio Messaging destination connects Segment to Twilio, letting you send me
 
 With the Twilio Messaging destination, you can:
 
-- Confirm orders or appointments
-- Send shipping updates or reminders
-- Deliver personalized marketing messages
-- Support onboarding and reactivation campaigns
+- Confirm orders or appointments.
+- Send shipping updates or reminders.
+- Deliver personalized marketing messages.
+- Support onboarding and reactivation campaigns.
 
 This destination supports two ways to send messages:
 
@@ -24,24 +24,24 @@ This destination supports two ways to send messages:
 
 Twilio Messaging works with Segment's data and audience tools to send timely, personalized messages without extra integration work.
 
-> info "Twilio Messaging Destination Private Beta"
-> The Twilio Messaging Destination is in Private Beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
+> info "Twilio Messaging destination public beta"
+> The Twilio Messaging destination is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available.
 
 ## Getting started
 
-To start sending messages through Twilio Messaging, you'll set up your Twilio account credentials and connect the destination in Segment.
+To start sending messages through Twilio Messaging, set up your Twilio account credentials and connect the destination in Segment.
 
-You'll set up the Twilio Messaging destination in three stages:
+There are three stages to setting up the Twilio Messaging destination:
 
 1. [Create a Twilio API Key and Secret](#authentication-and-setup).
 2. [Add the Twilio Messaging destination in Segment](#add-the-twilio-messaging-destination).
 3. [Configure message mappings](#configuring-message-mappings) to define what messages to send and when.
 
 The following sections walk through each step in detail.
 
-## Authentication and setup
+## 1. Authentication and setup
 
-Before you add the Twilio Messaging destination to Segment, you'll first need to create an API Key and Secret in your Twilio account.
+Before you add the Twilio Messaging destination to Segment, you first need to create an API Key and Secret in your Twilio account.
 
 To create your API Key and Secret:
 
@@ -55,7 +55,7 @@ To create your API Key and Secret:
 
 You now have your Account SID, API Key SID, and API Key Secret, which are required to connect Twilio Messaging in Segment.
 
-## Add the Twilio Messaging destination
+## 2. Add the Twilio Messaging destination
 
 After setting up your Twilio credentials, add the Twilio Messaging destination to your Segment workspace.
 
@@ -73,7 +73,7 @@ The destination is now connected and ready to configure message mappings.
 Users can only access the destination through the specific URL. I'll update these instructions once
 it's publicly available and searchable in the workspace catalog. -->
 
-## Configuring message mappings
+## 3. Configuring message mappings
 
 The Twilio Messaging destination supports one mapping action: **Send message**. Use this mapping to define when messages get sent and what content they include.
 
@@ -93,11 +93,13 @@ To configure the mapping:
 
 | Field                     | Description                                                                 | Notes                                                                                                                                                                   |
 | ------------------------- | --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Channel**               | Choose which channel to send the message on.                                | Options: SMS, MMS, WhatsApp, and RCS. If selecting RCS, ensure that RCS is enabled in your Twilio account.                                                               |
+| **Channel**               | Choose which channel to send the message on.                                | Options: SMS, MMS, WhatsApp, RCS, and Facebook Messenger. If selecting RCS, ensure that RCS is enabled in your Twilio account. Facebook Messenger is a Beta feature.     |
 | **Sender Type**           | Pick how you want to send the message.                                      | Options: Phone number or Messaging Service. Phone numbers must be approved in Twilio.                                                                                   |
 | **Content Template Type** | Select the type of content template.                                        | Options include Inline or templates you’ve built in Twilio. Segment only shows templates that match your selected Channel and Template Type.                            |
 | **To Phone Number**       | Enter the recipient’s phone number.                                         | Must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164){:target="_blank"}.                                                                            |
 | **From Phone Number**     | Choose the phone number to send from.                                       | Must be approved in Twilio and support the channel you’re using.                                                                                                        |
+| **To Messenger User ID**  | Enter the Facebook Messenger User ID to sent to.                            | Required if Sender Type is Facebook Messenger                                                                                                                           |
+| **From Facebook Page ID** | Enger your Facebook Page ID. Messages will be sent from this Page.          | Required if Sender Type is Facebook Messenger                                                                                                                           |
 | **Messaging Service SID** | Enter the messaging service SID if you’re using a messaging service.        | Required if Sender Type is Messaging Service.                                                                                                                           |
 | **Content Template SID**  | Choose which content template to use.                                       | Required unless you’re using Inline.                                                                                                                                    |
 | **Content Variables**     | Map variables used in your content template.                                | These variables need to be defined in Twilio first.                                                                                                                     |
@@ -111,7 +113,7 @@ To configure the mapping:
 
 The Twilio Messaging destination gives you two ways to create and send messages.
 
-**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.
+**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 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.
 
 **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.
 
@@ -121,7 +123,7 @@ Choose the option that fits what you’re trying to send. For most customer-faci
 
 ## Message setup options
 
-When you’re configuring your message mapping, there are a few key settings to choose from.
+There are a key settings to choose from when configuring message mappings.
 
 ### Content template types
 
@@ -137,11 +139,12 @@ If you’re sending messages on WhatsApp, all messages must use approved Content
 
 ### Sender types
 
-For the **Sender Type** field, you can choose either a phone number or a messaging service.
+The **Sender Type** field is used to specify if the message should be sent from a **phone number**, **messaging service** or **Facebook Page ID**. Available Sender Types depend on the selected Channel. 
 
-If you select **phone number**, Twilio sends the message from a specific number you own. The number must be approved in your Twilio account and support the channel you’re using.
+- For **phone number**, Twilio sends the message from a specific number you own. The number must be approved in your Twilio account and support the channel you’re using.
+- For **messaging service**, Twilio uses a Messaging Service SID to send the message. Messaging Services group multiple senders under one ID, and Twilio decides which sender to use based on your setup. This option is helpful if you’re sending high volumes or managing multiple numbers.
+- For **Facebook Page ID**, Twilio uses the Facebook Page ID to send the message. The [Facebook Page must first be authorized](https://www.twilio.com/docs/messaging/channels/facebook-messenger){:target="_blank"} to send messages in Twilio console.  
 
-If you select **messaging service**, Twilio uses a Messaging Service SID to send the message. Messaging Services group multiple senders under one ID, and Twilio decides which sender to use based on your setup. This option is helpful if you’re sending high volumes or managing multiple numbers.
 
 ### Using variables
 
@@ -165,7 +168,7 @@ Twilio Messaging also supports a few optional settings you can use in your mappi
 
 ### Validity period
 
-The **Validity Period** controls how long Twilio keeps trying to deliver your message. It’s set in seconds, with a minimum of 1 and a maximum of 14400 (4 hours). If the message isn’t delivered within this time, it won’t be sent. The default is 14400 seconds.
+The **Validity Period** controls how long Twilio keeps trying to deliver your message. It’s set in seconds, with a minimum of 1 and a maximum of 14400 seconds (4 hours). If the message isn’t delivered within this time, it won’t be sent. The default is 14400 seconds.
 
 ### Send At