Skip to content

Commit 24ed055

Browse files
authored
Merge pull request #328 from segmentio/repo-sync
repo sync
2 parents 8dee6fb + f244730 commit 24ed055

File tree

1 file changed

+8
-4
lines changed
  • src/connections/destinations/catalog/zendesk

1 file changed

+8
-4
lines changed

src/connections/destinations/catalog/zendesk/index.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -123,16 +123,18 @@ analytics.track('Article Completed', {
123123
```
124124

125125
> info ""
126-
> You must have a Zendesk [Sunshine plan](https://www.zendesk.com/pricing/?variant=a#platform) to make track calls.
126+
> You must have a Zendesk [Sunshine plan](https://www.zendesk.com/pricing/?variant=a#platform){:target="blank"} to make track calls.
127127
128128
When you make a Track call, Segment sends data about the user's activity to Zendesk.
129129

130-
Segment will only send `track` events when the following two conditions are met:
131-
132-
1. The call is listed in the "Events" setting.
130+
Segment only sends `track` events when the following two conditions are met:
131+
1. The call is listed in the **Events** setting.
133132
2. A `userId` is included.
134133
- **Note:** If the `userId` doesn't match any existing users in Zendesk, the destination returns an error.
135134

135+
> warning ""
136+
> The Zendesk destination Event Tester doesn't work for Track events and only sends the initial GET request. Even if the user ID doesn't match an existing user in Zendesk, it results in a 200 response.
137+
136138
**Mapping Users to an Email**: To map a Segment track event to a Zendesk Sunshine event by email, add the user's email address in the Track call as `properties.email`. This allows Zendesk to tie the event to the user. If there is no `properties.email`, Segment sends the `userId` as `external_id`. If the email is provided in the track call, a javascript call may look like the example below.
137139

138140
```js
@@ -144,8 +146,10 @@ analytics.track('Article Completed', {
144146
}
145147
});
146148
```
149+
147150
> warning "Zendesk API Limit"
148151
> Track calls to Zendesk must reference a user identifier of less than 61 characters. While you may create a user with an identifier of greater than 60 characters, track calls that reference that user return a 400 error. This is due to a limitation in the Zendesk Sunshine API.
152+
149153
## Group
150154

151155
If you're not familiar with the Segment Specs, take a look to understand what the [Group method](/docs/connections/spec/group/) does. An example call would look like:

0 commit comments

Comments
 (0)