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/unified-profiles/connect-a-workspace.md
+50-71Lines changed: 50 additions & 71 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,9 +20,9 @@ If you already have a Segment workspace, you can use a new or pre-existing [Segm
20
20
## Step 1: Set up your Unify space
21
21
22
22
> success ""
23
-
> This section is about setting up a new Segment Unify space to link to Twilio Flex. If you have an existing Segment Unify space you'd like to use, proceed directly to [Step 2: Connect your data to Unify](#step-2-connect-your-data-to-unify).
23
+
> This section is about setting up a new Segment Unify space to link to Twilio Flex. If you have an existing Segment Unify space you'd like to use, proceed directly to [Step 2: Connect your data to Unify](#step-2-connect-your-data-to-unify). If your Unify space includes a Salesforce source, RETL source, and a Segment Profiles destination already configured, proceed directly to [Step 3: Connect Flex to your Unify space](#step-3-connect-flex-to-your-unify-space).
24
24
25
-
Segment recommends creating a development or sandbox space, verifying that your profiles appear as you would expect, and then creating a production space.
25
+
Segment recommends creating a development or sandbox Unify space, verifying that your profiles appear as you would expect, and then creating a production Unify space.
26
26
27
27
To create a Unify space:
28
28
@@ -37,15 +37,18 @@ To create a Unify space:
37
37
9. Copy your Profile API token to a safe location and click the "I have written down this access token" checkbox, then click **Done**.
38
38
39
39
## Step 2: Connect your data to Unify
40
-
After you've created a Unify space, you must also connect a Salesforce CRM source and a data warehouse to your Unify space to link your customers' data to Unified Profiles.
40
+
After you've created a Unify space, you must also connect a Salesforce CRM source, a data warehouse, and a Segment Profiles destination to your Unify space to link your customers' data to Unified Profiles.
41
+
42
+
> success ""
43
+
> This section is about setting up a Salesforce source, RETL source, and a Segment Profiles destination to link to your Unify space. If you have an existing Segment Unify space with these connections that you'd like to use, proceed directly to [Step 3: Connect Flex to your Unify space](#step-3-connect-flex-to-your-unify-space).
41
44
42
45
### Set up Salesforce
43
46
1. From the [catalog page in your workspace](https://app.segment.com/goto-my-workspace/sources/catalog/salesforce){:target="_blank"}, select the Salesforce source and click **Add Source**.
44
47
2. Enter a name for your Salesforce source and click **Authenticate**.
45
48
3. You are redirected to the Salesforce login page. Sign in with a username and password of a user that has _View all Permissions_ access.
46
49
4. You are redirected to the Permissions Verified page in Segment. Click **Next**.
47
50
5. On the SQL Schema name page, review the schema name and SQL query used to create the schema, then click **Next**.
48
-
6. You've connected Salesforce. Click the **Do it later** button and continue to [Connect a data warehouse destination](#connect-a-data-warehouse-destination).
51
+
6. You've connected Salesforce. Click the **Do it later** button and continue to [Connect a data warehouse ](#connect-a-data-warehouse).
49
52
50
53
### Connect a data warehouse
51
54
1. From the [catalog page in your workspace](https://app.segment.com/goto-my-workspace/destinations/catalog?category=Storage){:target="_blank"}, search for and select a BigQuery, Postgres, Redshift, or Snowflake destination.
@@ -57,6 +60,10 @@ After you've created a Unify space, you must also connect a Salesforce CRM sourc
57
60
> Segment's initial sync with your data warehouse might take up to 24 hours to complete.
58
61
59
62
### Add a Reverse ETL source
63
+
Reverse ETL (Extract, Transform, Load) sources extract object and event data from a data warehouse using a query you provide and sync the data to your third party destinations. For example, with Reverse ETL, you can sync records from Snowflake, a data warehouse, to Flex, a digital engagement center solution. Reverse ETL supports customer profile data, subscriptions, product tables, shopping cart tables, and more.
1. In the [Reverse ETL section of the Sources catalog](https://app.segment.com/goto-my-workspace/sources/catalog?category=Reverse%20ETL){:target="_blank"}, select the warehouse you previously connected to Salesforce and click **Add Source**.
61
68
2. Give your source a name and enter the credentials for a user with read and write access to your database.
62
69
3. Click **Test Connection**. If Segment can successfully connect to your warehouse, click **Add Source**.
@@ -89,7 +96,7 @@ Create a Segment Profiles destination to add a mapping to your Reverse ETL sourc
89
96
7. When you've finished mapping all relevant event fields and verified that your test record contains all of the relevant user information, click **Save Mapping.**
90
97
8. You're returned to the Mappings page for your Segment Profiles destination. Under the Mapping status column, enable the mapping you created in the previous step.
91
98
92
-
## Step 3: Connect Flex to your Unify space
99
+
## Step 3: Connect your Unify space to Flex
93
100
94
101
To connect your Unify space to Flex, follow the [Connect an existing Segment Unify space](https://www.twilio.com/docs/flex/admin-guide/setup/unified-profiles/setup/unify-space){:target="_blank"} instructions in the Flex documentation.
95
102
@@ -111,84 +118,69 @@ After linking your customer data to Flex through a Unify space, you can set up [
111
118
### Computed traits
112
119
[Computed traits](/docs/unify/traits/computed-traits) allow you to quickly create user or account-level calculations that Segment keeps up-to-date over time. These computations are based on the events and event properties that you are sending through Segment.
113
120
121
+
To create a computed trait:
122
+
1. Navigate to the Unify space you linked to Flex and click **Traits**.
123
+
2. Click **Create computed trait**.
124
+
3. Select the type of event you'd like to create and click **Next**.
125
+
4. Select an event to be the base of your computed trait.
126
+
5. Add conditions and an optionally, an event property.
127
+
-**Conditions**: These restrict the messages considered when calculating the final value of a computed trait. For more information, see the [Conditions](/docs/unify/traits/computed-traits/#conditions) documentation.
128
+
-**Event properties**: These refine the computed traits to include only the specified properties.
129
+
6. Verify that your trait contains at least one member by clicking the **Preview Trait** button.
130
+
7. When you've verified that your trait contains at least one member, click **Next**.
131
+
8. On the Select Destinations page, don't add a destination. Instead, click **Next**.
132
+
9. Enter a name for your trait and click **Create Trait**.
133
+
114
134
Segment recommends that you configure the following computed traits for Unified Profiles:
115
135
-[Total inbounds](#total-inbounds): Number of inbound attempts resulting in customer engagement
116
136
-[Frequent inbound channel](#frequent-inbound-channel): Identifies the user's most frequently used channel of communication
117
137
118
138
Other computed traits that might be helpful include:
119
139
-[Total outbounds](#total-outbounds): Number of outbound attempts resulting in customer engagement
120
140
-[Last known service agent](#last-known-service-agent): Identifies the last agent to allow connecting to the same agent
121
-
-[Last interaction duration](#last-interaction-duration): The duration (in seconds) of the customer's last interaction with agent(s)
122
-
-[Common request](#common-request): Most frequent topic of inbound or outbound engagement
123
-
-[Sentiment in last interaction](#sentiment-in-last-interaction): Gen-AI inferred sentiment in last interaction
124
-
-[Last interaction topic](#last-interaction-topic): Topic of the last interaction
141
+
-[Last interaction duration](#last-interaction-duration): The duration (in seconds) of the customer's last interaction with an agent
142
+
-[Sentiment in last interaction](#sentiment-in-last-interaction): AI-inferred sentiment in last interaction
125
143
126
144
#### Total inbounds
127
-
1. Navigate to the Unify space you linked to Flex and click **Traits**.
128
-
2. Click **Create computed trait**.
129
-
3. Select **Event counter** and click **Next**.
130
-
4. Select the "Flex - Engagement Initiated" event.
131
-
5. Add the following conditions:
145
+
Create an Event counter trait based on the "Flex - Engagement Initiated" event and add the following:
132
146
-**Event property**: direction
133
147
-**Operator**: equals
134
-
-**Value**: Inbound
135
-
6. Verify that your trait contains at least one member by clicking the **Preview Trait** button.
136
-
7. When you've verified that your trait contains at least one member, click **Next**.
137
-
8. On the Select Destinations page, don't add a destination. Instead, click **Next**.
138
-
9. Enter a name for your trait and click **Create Trait**.
148
+
-**Value**: Inbound
139
149
140
150
#### Frequent inbound channel
141
-
1. Navigate to the Unify space you linked to Flex and click **Traits**.
142
-
2. Click **Create computed trait**.
143
-
3. Select **Most frequent** and click **Next**.
144
-
4. Select the "Flex - Engagement Initiated" event.
145
-
5. Add the following conditions:
151
+
Create a Most frequent trait based on the "Flex - Engagement Initiated" event and add the following:
146
152
-**Event property**: direction
147
153
-**Operator**: equals
148
-
-**Value**: Inbound
149
-
6. Add an additional event property "channelType" with a value "Text".
150
-
6. Verify that your trait contains at least one member by clicking the **Preview Trait** button.
151
-
7. When you've verified that your trait contains at least one member, click **Next**.
152
-
8. On the Select Destinations page, don't add a destination. Instead, click **Next**.
153
-
9. Enter a name for your trait and click **Create Trait**.
154
+
-**Value**: Inbound
155
+
156
+
Add the following event property:
157
+
-**Event property**: channelType
158
+
-**Value**: Text
159
+
160
+
And add a Minimum frequency of 2.
154
161
155
162
#### Total outbounds
156
-
1. Navigate to the Unify space you linked to Flex and click **Traits**.
157
-
2. Click **Create computed trait**.
158
-
3. Select **Event counter** and click **Next**.
159
-
4. Select the "Flex - Engagement Completed" event.
160
-
5. Add the following conditions:
163
+
Create an Event counter trait based on the "Flex - Engagement Initiated" event and add the following:
161
164
-**Event property**: direction
162
165
-**Operator**: equals
163
166
-**Value**: Outbound
164
-
6. Verify that your trait contains at least one member by clicking the **Preview Trait** button.
165
-
7. When you've verified that your trait contains at least one member, click **Next**.
166
-
8. On the Select Destinations page, don't add a destination. Instead, click **Next**.
167
-
9. Enter a name for your trait and click **Create Trait**.
168
167
169
168
#### Last known service agent
170
-
1. Navigate to the Unify space you linked to Flex and click **Traits**.
171
-
2. Click **Create computed trait**.
172
-
3. Select **Last** and click **Next**.
173
-
4. Select the "Flex - Engagement Initiated" event.
174
-
6. Add an event property "lastKnownAgentWorkerSid" with a value "Text".
175
-
6. Verify that your trait contains at least one member by clicking the **Preview Trait** button.
176
-
7. When you've verified that your trait contains at least one member, click **Next**.
177
-
8. On the Select Destinations page, don't add a destination. Instead, click **Next**.
178
-
9. Enter a name for your trait and click **Create Trait**.
169
+
Create a Last trait based on the "Flex - Engagement Initiated" event and add the following:
170
+
-**Event property**: lastKnownAgentWorkerSid
171
+
-**Value**: Text
179
172
180
173
#### Last interaction duration
181
-
1. Navigate to the Unify space you linked to Flex and click **Traits**.
182
-
2. Click **Create computed trait**.
183
-
3. Select **Last** and click **Next**.
184
-
4. Select the "Flex - Engagement Initiated" event.
185
-
6. Add an event property "duration" with a value "Number(100)".
186
-
6. Verify that your trait contains at least one member by clicking the **Preview Trait** button.
187
-
7. When you've verified that your trait contains at least one member, click **Next**.
188
-
8. On the Select Destinations page, don't add a destination. Instead, click **Next**.
189
-
9. Enter a name for your trait and click **Create Trait**.
174
+
Create a Last trait based on the "Flex - Engagement Initiated" event and add the following:
175
+
-**Event property**: duration
176
+
-**Value**: Number(100)
190
177
191
-
<!--- As of 2/28/24 - this trait is not supported for Q1 release
178
+
##### Sentiment in last interaction
179
+
Create a Last trait based on the "Flex - Engagement Completed" event and add the following:
180
+
-**Event property**: sentiment
181
+
-**Value**: Text
182
+
183
+
<!--- As of 2/28/24 - these traits are not supported for Q1 release
192
184
#### Common request
193
185
1. Navigate to the Unify space you linked to Flex and click **Traits**.
194
186
2. Click **Create computed trait**.
@@ -200,20 +192,7 @@ Other computed traits that might be helpful include:
200
192
7. When you've verified that your trait contains at least one member, click **Next**.
201
193
8. On the Select Destinations page, don't add a destination. Instead, click **Next**.
202
194
9. Enter a name for your trait and click **Create Trait**.
203
-
--->
204
-
205
-
#### Sentiment in last interaction
206
-
1. Navigate to the Unify space you linked to Flex and click **Traits**.
207
-
3. Select **Last** and click **Next**.
208
-
4. Select the "Flex - Engagement Completed" event.
209
-
5. Add an additional event property "sentiment" with a value "Text".
210
-
6. Add a minimum frequency of "2".
211
-
6. Verify that your trait contains at least one member by clicking the **Preview Trait** button.
212
-
7. When you've verified that your trait contains at least one member, click **Next**.
213
-
8. On the Select Destinations page, don't add a destination. Instead, click **Next**.
214
-
9. Enter a name for your trait and click **Create Trait**.
215
195
216
-
<!--- As of 2/28/24 - this trait is not supported for Q1 release
217
196
#### Last interaction topic
218
197
1. Navigate to the Unify space you linked to Flex and click **Traits**.
0 commit comments