Skip to content

Commit 8681227

Browse files
committed
More fixes [netlify-build]
1 parent 90cfab2 commit 8681227

File tree

1 file changed

+50
-71
lines changed

1 file changed

+50
-71
lines changed

src/unified-profiles/connect-a-workspace.md

Lines changed: 50 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,9 @@ If you already have a Segment workspace, you can use a new or pre-existing [Segm
2020
## Step 1: Set up your Unify space
2121

2222
> 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).
2424
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.
2626

2727
To create a Unify space:
2828

@@ -37,15 +37,18 @@ To create a Unify space:
3737
9. Copy your Profile API token to a safe location and click the "I have written down this access token" checkbox, then click **Done**.
3838

3939
## 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).
4144
4245
### Set up Salesforce
4346
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**.
4447
2. Enter a name for your Salesforce source and click **Authenticate**.
4548
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.
4649
4. You are redirected to the Permissions Verified page in Segment. Click **Next**.
4750
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).
4952

5053
### Connect a data warehouse
5154
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
5760
> Segment's initial sync with your data warehouse might take up to 24 hours to complete.
5861
5962
### 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.
64+
65+
Unified Profiles supports Postgres, Snowflake, Redshift, and BigQuery Reverse ETL sources.
66+
6067
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**.
6168
2. Give your source a name and enter the credentials for a user with read and write access to your database.
6269
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
8996
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.**
9097
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.
9198

92-
## Step 3: Connect Flex to your Unify space
99+
## Step 3: Connect your Unify space to Flex
93100

94101
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.
95102

@@ -111,84 +118,69 @@ After linking your customer data to Flex through a Unify space, you can set up [
111118
### Computed traits
112119
[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.
113120

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+
114134
Segment recommends that you configure the following computed traits for Unified Profiles:
115135
- [Total inbounds](#total-inbounds): Number of inbound attempts resulting in customer engagement
116136
- [Frequent inbound channel](#frequent-inbound-channel): Identifies the user's most frequently used channel of communication
117137

118138
Other computed traits that might be helpful include:
119139
- [Total outbounds](#total-outbounds): Number of outbound attempts resulting in customer engagement
120140
- [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
125143

126144
#### 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:
132146
- **Event property**: direction
133147
- **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
139149

140150
#### 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:
146152
- **Event property**: direction
147153
- **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.
154161

155162
#### 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:
161164
- **Event property**: direction
162165
- **Operator**: equals
163166
- **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**.
168167

169168
#### 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
179172

180173
#### 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)
190177

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
192184
#### Common request
193185
1. Navigate to the Unify space you linked to Flex and click **Traits**.
194186
2. Click **Create computed trait**.
@@ -200,20 +192,7 @@ Other computed traits that might be helpful include:
200192
7. When you've verified that your trait contains at least one member, click **Next**.
201193
8. On the Select Destinations page, don't add a destination. Instead, click **Next**.
202194
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**.
215195
216-
<!--- As of 2/28/24 - this trait is not supported for Q1 release
217196
#### Last interaction topic
218197
1. Navigate to the Unify space you linked to Flex and click **Traits**.
219198
3. Select **Last** and click **Next**.

0 commit comments

Comments
 (0)