Skip to main content

Entries API Documentation

Overview​

An Entry in Unwrap represents an individual interaction with a customer. This could be a customer support conversation, a social media post, or a review on a public forum. The following documentation provides details on how to fetch and filter Entries using Unwrap's GraphQL API.

Fetching Entries​

To fetch Entries from Unwrap's API, use the following GraphQL query:

query Entries($teamId: Int!) {
  entries(teamId: $teamId) {
    id
    providerUniqueId
    feedbackEntryText {
      entryText
      conversationParts {
        fullText
        submitterType
      }
    }
  }
}

Example Variables​

{
  "teamId": <replace with your teamId>
}

Response​

This query will return the Entries in Unwrap's system along with all the textual conversation parts.

Fetching Group Memberships​

To fetch Entries along with all the Groups that an Entry belongs to, use the following query:

query Entries($teamId: Int!) {
  entries(teamId: $teamId) {
    id
    providerUniqueId
    groupMemberships {
      id
      title
    }
  }
}

Response​

This query returns a list of Entries and each Group that the Entry belongs to.

Filtering Entries​

To filter the Entries returned, use the filterInput variable in the query below:

query Entries($teamId: Int!, $filterInput: FilterInput) {
  entries(teamId: $teamId, filterInput: $filterInput) {
    id
    providerUniqueId
    groupMemberships {
      id
      title
    }
  }
}

Example Variables​

{
  "teamId": <replace with your teamId>,
  "filterInput": {
    "startDate": "2024-04-13T21:28:25Z",
    "endDate": "2024-06-13T21:28:25Z"
  }
}

Response​

The filter above restricts the results to Entries within the specified start and end date range.

Fetching Entries Modified Since a Given Date​

To fetch Entries that have been modified since a specified date, use the following query:

query Entries($teamId: Int!, $modifiedSince: Date) {
  entries(teamId: $teamId, modifiedSince: $modifiedSince) {
    id
    providerUniqueId
    groupMemberships {
      id
      title
    }
  }
}

Example Variables​

{
  "teamId": <replace with your teamId>,
  "modifiedSince": "2024-06-13T21:28:25Z"
}

Response​

This query will return only Entries that have been modified since the specified date. This is useful for retrieving changes since the last data export from Unwrap.