Skip to content

Commit 40b8273

Browse files
committed
DOC 668 updates [netlify-build]
1 parent 6447166 commit 40b8273

File tree

4 files changed

+26
-8
lines changed

4 files changed

+26
-8
lines changed

src/engage/profiles/csv-upload.md

Lines changed: 15 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Navigate to **Profiles > Profiles settings** and select the **Identity resolutio
2626

2727
### 2. Fill out your CSV file
2828

29-
Enter values for the identifiers in your CSV file. You can also [set email and phone subscriptions](#set-user-subscriptions) using the `email_subscription_status` and `sms_subscription_status` columns.
29+
Enter values for the identifiers in your CSV file. You can also [set email, phone, and WhatsApp subscriptions](#set-user-subscriptions) using the `email_subscription_status`, `sms_subscription_status`, and `whatsapp_subscription_status` columns.
3030

3131
A few best practices to keep in mind as you fill out your CSV:
3232

@@ -73,6 +73,18 @@ From the Update History page:
7373
3. Remove any extra columns such as `row_number`, `error_message`, and `error_code`.
7474
3. Click **Update subscription statuses**, and select **Upload a CSV** to re-upload the file.
7575

76+
Engage uses the following error codes on the report:
77+
78+
|Error code | Description |
79+
|----------------------------------|-----------------------------------------------------|
80+
|INVALID_EMAIL | The email address isn't formatted correctly. |
81+
|INVALID_PHONE | The phone number is invalid. |
82+
|INVALID_SUBSCRIPTION_STATUS | The subscription status is invalid. Check the status or leave it blank. |
83+
|CONFIGURATION_ERROR | Your SendGrid settings are not configured correctly. [Contact Segment support](https://app.segment.com/workspaces?contact=1){:target="_blank"} for help. |
84+
|SYSTEM_ERROR | Something went wrong. Please try again. |
85+
|UNABLE_TO_SUBSCRIBE | You can't update the subscription status for this phone number because the user unsubscribed by replying `STOP`. The user must reply `START` to resubscribe. |
86+
87+
7688
## Set user subscriptions
7789

7890
Use the CSV Uploader to set subscription states for user email addresses and phone numbers.
@@ -82,9 +94,9 @@ Use the CSV Uploader to set subscription states for user email addresses and pho
8294
8395
For each CSV file, Engage adds:
8496
- An `email_subscription_status` column next to the **Email** column.
85-
- An `sms_subscription_status` column next to the **Phone** column.
97+
- `whatsapp_subscription_status` and `sms_subscription_status` columns next to the **Phone** column.
8698

87-
In the `email_subscription_status` and `sms_subscription_status` columns, set subscription states for email and phone numbers with the following values:
99+
In the `email_subscription_status`, `sms_subscription_status`, and `whatsapp_subscription_status` columns, set subscription states for email and phone numbers with the following values:
88100

89101
- `subscribed`: The user has actively subscribed.
90102
- `unsubscribed`: The user has actively unsubscribed.

src/engage/user-subscriptions/engage-source.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,16 @@ Use the Engage Events Source to sync Engage subscription states to downstream De
99

1010
With Twilio Engage, you can [set and update user subscription states](/docs/engage/user-subscriptions/set-user-subscriptions/) with a [CSV file upload](/docs/engage/profiles/csv-upload/) or, programmatically, [using Segment APIs](/docs/engage/user-subscriptions/set-user-subscriptions/#manage-user-subscriptions-with-segment-apis).
1111

12-
As part of Engage, Segment creates an Engage Events Source that lets you sync subscription states [to connected Destinations](/docs/connections/destinations/). When a subscription state changes, Segment sends an update to the Destination. As a result, the subscription states stored in your Destination(s) can serve as a single source of truth for managing user consent in other tools that you may have connected to the Destination.
12+
As part of Engage, Segment creates an Engage Events Source that lets you sync subscription states and marketing analytics events [to connected Destinations](/docs/connections/destinations/). When a subscription state changes, Segment sends an update to the Destination. As a result, the subscription states stored in your Destination(s) can serve as a single source of truth for managing user consent in other tools that you may have connected to the Destination.
1313

1414
## Working with Engage Events Sources
1515

16-
Segment generates Engage Sources automatically. If you're using Engage, you can find the Source in your Segment space by navigating to **Connections > Sources**. Segment sets a `Generated` status to Engage Sources in the **Statuses** column of the **My Sources** table.
16+
Segment generates Engage Sources automatically. To find your Engage Events Sources in your workspace navigate to **Connections > Sources** and select **Engage Events**.
1717

18-
From the **My Sources** table, you can select the Engage Source to add a Destination and configure the Source's settings. If you have more than one Engage space, Segment creates a separate Source for each space.
18+
If you have Engage messaging services set up, you can also find Engage sources in two ways:
19+
20+
- Navigate to **Engage > Audiences** and click **Add a destination** from the Audiences overview page.
21+
- Navigate to **Engage > Channels Settings** and add your Engage source from the **Engage Events source** section.
22+
23+
24+
Segment sets a `Generated` status to Engage Sources in the **Statuses** column of the **My Sources** table. <br />From the **My Sources** table, you can select the Engage Source to add a Destination and configure the Source's settings. If you have more than one Engage space, Segment creates a separate Source for each space.
190 KB
Loading

src/profiles/profile-api.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,8 +52,8 @@ Your access token enables you to call the Profile API and access customer data.
5252
### Find a user's external id
5353

5454
1. Navigate to **Profiles > Profiles Explorer** and select the user you want to query through the API.
55-
2. Take note of the user's available identifiers. For example, this user has a `user_id` with the value `9800664881`. The Profile API requires both the type of ID and the value separated by a colon. For example, `user_id:9800664881`.
56-
![Retrieving a user's identifiers with the Profiles Explorer](images/profile_api_user_id.png)
55+
2. Take note of the user's available identifiers. For example, this user has an `anonymous_id` with the value `eml_3bca54b7fe7491add4c8d5d4d9bf6b3e085c6092`. The Profile API requires both the type of ID and the value separated by a colon. For example, `anonymous_id:eml_3bca54b7fe7491add4c8d5d4d9bf6b3e085c6092`. Click the duplicate icon to copy the identifier to your clipboard.
56+
![Retrieving a user's identifiers with the Profiles Explorer](images/profile_api_anonymous_id.png)
5757

5858
> warning ""
5959
> To query phone numbers that contain a plus sign (`+`), insert the escape characters `%2B` in place of the plus sign.

0 commit comments

Comments
 (0)