To set up tap-liveperson
in Stitch, you need:
- A LivePerson Account ID: Find this ID in the URL after authenticating with LivePerson. It should be a 7-digit number.
- LivePerson API Keys: For information on creating API Keys, consult the LivePerson docs. You will need to record your
app_key
,app_secret
,access_token
, andaccess_token
.
The following endpoints are replicated incrementally:
- Engagement History
- Messaging Interactions
- Agent Activity
- Queue Health
The following endpoints do not support incremental querying, and are refreshed completely on every sync
- Agent Groups
- Agent Status
- Skills
- Users
The incrementally-synced endpoints represent potentially large activity streams. The full-refreshed endpoints are smaller in nature, and map one-to-one with administrative resources created in the LivePerson user interface.
The Queue Health endpoint does not support historical querying and is real-time in nature. The Queue Health endpoint only returns data about queue health in LivePerson for the last 24 hours. In order to build a complete Queue Health dataset, this endpoint must be replicated no less than every 24 hours.
Table name: Engagement History
- Description: This stream contains data about chats in the LivePerson app
- Primary key column(s): id
- Replicated fully or incrementally (uses a bookmark to maintain state): Incrementally
- Bookmark column(s):
updated_at
- Link to API endpoint documentation: https://developers.liveperson.com/engagement-history-api-overview.html
Table name: Messaging Interactions
- Description: This stream contains data about conversations in the LivePerson app
- Primary key column(s): id
- Replicated fully or incrementally (uses a bookmark to maintain state): Incrementally
- Bookmark column(s):
updated_at
- Link to API endpoint documentation: https://developers.liveperson.com/messaging-interactions-api-overview.html
Table name: Agent Activity
- Description: This stream contains data about agent activity within the LivePerson app
- Primary key column(s): id
- Replicated fully or incrementally (uses a bookmark to maintain state): Incrementally
- Bookmark column(s):
updated_at
- Link to API endpoint documentation: https://developers.liveperson.com/data-access-api-methods-agent-activity.html
Table name: Queue Health
- Description: This stream contains data about Queue Health metrics, including requested and missed conversations
- Primary key column(s): id
- Replicated fully or incrementally (uses a bookmark to maintain state): Incrementally
- Bookmark column(s): N/A, always requests the last 24 hours of activity
- Link to API endpoint documentation: https://developers.liveperson.com/messaging-operations-api-methods-messaging-queue-health.html
Table name: Agent Groups
- Description: This stream contains a list of Agent Groups configured in the LivePerson app
- Primary key column(s): id
- Replicated fully or incrementally (uses a bookmark to maintain state): Fully
- Link to API endpoint documentation: https://developers.liveperson.com/agent-groups-api-methods-get-all-agent-groups.html
Table name: Agent Status
- Description: This stream lists all status reasons of an account, for all statuses in the LivePerson app
- Primary key column(s): id
- Replicated fully or incrementally (uses a bookmark to maintain state): Fully
- Link to API endpoint documentation: https://developers.liveperson.com/agent-status-reason-api-methods-agent-status-list.html
Table name: Skills
- Description: This stream lists all skills configured in the LivePerson app
- Primary key column(s): id
- Replicated fully or incrementally (uses a bookmark to maintain state): Fully
- Link to API endpoint documentation: https://developers.liveperson.com/skills-api-methods-get-all-skills.html
Table name: Users
- Description: This stream lists all users configured in the LivePerson app
- Primary key column(s): id
- Replicated fully or incrementally (uses a bookmark to maintain state): Fully
- Link to API endpoint documentation: https://developers.liveperson.com/users-api-methods-get-all-users.html