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/connections/sources/catalog/cloud-apps/zendesk/index.md
+17-12Lines changed: 17 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -53,19 +53,19 @@ Collections are the groupings of resources Segment pulls from your source.
53
53
|[users](#users)| object | Zendesk Support has three types of users: end-users (your customers), agents, and administrators. End-users request support through tickets. Agents work in Zendesk Support to solve tickets. Agents can be divided into multiple groups and can also belong to multiple groups. Agents don't have access to administrative configuration in Zendesk Support such as business rules or automation, but can configure their own macros and views. Administrators have all the abilities of agents, plus administrative abilities. |
54
54
|[groups](#groups)| object | When support requests arrive in Zendesk, they can be assigned to a Group. Groups serve as the core element of ticket workflow; support agents are organized into Groups and tickets can be assigned to a Group only, or to an assigned agent within a Group. A ticket can never be assigned to an agent without also being assigned to a Group. |
55
55
|[tickets](#tickets)| object | Tickets are the means through which your End-users (customers) communicate with Agents in Zendesk. **Note**: Segment pulls all tickets updated (or created) in the last year to start by default. If you need more, reach out to Segment support. Support can do a run to pull further back in history. |
56
-
|[ticket_fields](#ticketfields)| object | Customize fields on the ticket form. |
56
+
|[ticket_fields](#ticket_fields)| object | Customize fields on the ticket form. |
57
57
|[activities](#activities)| object | The activity stream is a per agent event stream. It will give access to the most recent events that relate to the agent polling the API. |
58
58
|[attachments](#activities)| object | This API is for attachments in tickets and forum posts in the Web portal. |
59
59
|[organizations](#organizations)| object | Just as agents can be segmented into groups in Zendesk, your customers (end-users) can be segmented into organizations. |
60
-
|[ticket_events](#ticketevents)| events | Returns a stream of changes that occurred on tickets. Each event is tied to an update on a ticket and contains all the fields that were updated in that change. **Note**: Segment pulls one year of ticket events to start by default. If you need more, reach out to [Segment support](https://segment.com/help/contact/). Support can do a run to pull further back in history. |
61
-
|[ticket_metrics](#ticketmetrics)| object | All kinds of aggregate metrics about a ticket |
62
-
|[satisfaction_ratings](#satisfactionratings)| object | If you have enabled satisfaction ratings for your account, this end point allows you to quickly retrieve all ratings. |
63
-
|[ticket_comments](#ticketcomments)| object | Ticket comments represent the conversation between requesters, collaborators, and agents. It includes the full body of each comment, public and private. **Note**: This collection is not included by default. To request it, [contact Segment support](https://segment.com/help/contact/). |
64
-
|[ticket_forms](#ticketforms)| object | Ticket comments represent the conversation between requesters, collaborators, and agents. It includes the full body of each comment, public and private. **Note**: This collection is not included by default. To request it, [contact Segment support](https://segment.com/help/contact/). |
65
-
|[ticket_skips](#ticketskips)| object | A skip is a record of when an agent skips over a ticket without responding to the end user. |
66
-
|[organization_memberships](#organizationmemberships)| object | A membership links a user to an organization. Organizations can have many users. Users can be in many organizations if the account supports multiple organizations. You can use the API to list users in an organization, and reassign organization members. |
67
-
|[group_memberships](#groupmemberships)| object | A membership links an agent to a group. Groups can have many agents, as agents can be in many groups. You can use the API to list what agents are in which groups, and reassign group members. |
68
-
|[audit_logs](#auditlogs)| object | The audit log shows various changes in your instance of Zendesk since the account was created. **Note**: This collection is not included by default. To request it, [contact Segment support](https://segment.com/help/contact/). |
60
+
|[ticket_events](#ticket_events)| events | Returns a stream of changes that occurred on tickets. Each event is tied to an update on a ticket and contains all the fields that were updated in that change. **Note**: Segment pulls one year of ticket events to start by default. If you need more, reach out to [Segment support](https://segment.com/help/contact/). Support can do a run to pull further back in history. |
61
+
|[ticket_metrics](#ticket_metrics)| object | All kinds of aggregate metrics about a ticket |
62
+
|[satisfaction_ratings](#satisfaction_ratings)| object | If you have enabled satisfaction ratings for your account, this end point allows you to quickly retrieve all ratings. |
63
+
|[ticket_comments](#ticket_comments)| object | Ticket comments represent the conversation between requesters, collaborators, and agents. It includes the full body of each comment, public and private. **Note**: This collection is not included by default. To request it, [contact Segment support](https://segment.com/help/contact/). |
64
+
|[ticket_forms](#ticket_forms)| object | Ticket comments represent the conversation between requesters, collaborators, and agents. It includes the full body of each comment, public and private. **Note**: This collection is not included by default. To request it, [contact Segment support](https://segment.com/help/contact/). |
65
+
|[ticket_skips](#ticket_skips)| object | A skip is a record of when an agent skips over a ticket without responding to the end user. |
66
+
|[organization_memberships](#organization_memberships)| object | A membership links a user to an organization. Organizations can have many users. Users can be in many organizations if the account supports multiple organizations. You can use the API to list users in an organization, and reassign organization members. |
67
+
|[group_memberships](#group_memberships)| object | A membership links an agent to a group. Groups can have many agents, as agents can be in many groups. You can use the API to list what agents are in which groups, and reassign group members. |
68
+
|[audit_logs](#audit_logs)| object | The audit log shows various changes in your instance of Zendesk since the account was created. **Note**: This collection is not included by default. To request it, [contact Segment support](https://segment.com/help/contact/). |
69
69
70
70
71
71
In your warehouse, each collection gets its own table. Find below a list of the properties Segment automatically fetches for each collection.
@@ -439,6 +439,7 @@ In your warehouse, each collection gets its own table. Find below a list of the
439
439
<td>removable</td>
440
440
<td> If this field is not a system basic field that must be present for all tickets on the account.</td>
441
441
</tr>
442
+
<tr>
442
443
<td>created_at</td>
443
444
<td> The time the ticket field was created.</td>
444
445
</tr>
@@ -538,6 +539,7 @@ In your warehouse, each collection gets its own table. Find below a list of the
538
539
<td>updated_at</td>
539
540
<td> When this record last got updated.</td>
540
541
</tr>
542
+
<tr>
541
543
<td>assignee_updated_at</td>
542
544
<td> When the assignee last updated the ticket.</td>
543
545
</tr>
@@ -554,10 +556,11 @@ In your warehouse, each collection gets its own table. Find below a list of the
554
556
<td> When the ticket was initially assigned.</td>
555
557
</tr>
556
558
<tr>
557
-
<td>assigned_at</td>
559
+
<td>assigned_at</td>
558
560
<td> When the ticket was last assigned.</td>
559
561
</tr>
560
-
<td>solved_at</td>
562
+
<tr>
563
+
<td>solved_at</td>
561
564
<td> When the ticket was solved.</td>
562
565
</tr>
563
566
<tr>
@@ -756,6 +759,7 @@ In your warehouse, each collection gets its own table. Find below a list of the
756
759
<td>id</td>
757
760
<td> Automatically assigned when the organization is created. </td>
758
761
</tr>
762
+
<tr>
759
763
<td>url</td>
760
764
<td> The API url of this rating.</td>
761
765
</tr>
@@ -803,6 +807,7 @@ In your warehouse, each collection gets its own table. Find below a list of the
803
807
<td>id</td>
804
808
<td> Automatically assigned when the comment is created. </td>
805
809
</tr>
810
+
<tr>
806
811
<td>ticket_event_id</td>
807
812
<td> Automatically assigned when the comment is created.</td>
0 commit comments