Setting up Help Scout as a Source

Connecting Help Scout makes it easy to power Guru's AI with your customer support knowledge. Learn how to connect your Help Scout account and turn existing tickets into searchable resources.

๐Ÿ‘ฅ

Access Required

Guru Access: You need to be an Admin, Source Creator, or relevant custom role to set up Sources

Help Scout Access: You must be an Admin in Help Scout to connect as a Source.


Setting Up Help Scout as a Source

  1. In Guru, go to Manage.
  2. Select Sources, then click Add Source.
  3. Choose Help Scout from the list of integrations.
  4. Grant Guru permission to access your Help Scout data.
  5. Configure selective sync filters (optional):
    • Filter by Date Modified to sync tickets from a specific time period.
  6. Authenticate using your Help Scout account credentials.
  7. Grant Guru permission to access your Help Scout data.
  8. Add a display name for the Source (optional) and click Connect Source.
  9. Assign which Guru Groups should have access to this content.

Objects synced from Help Scout

Primary objects are the objects used to generate the search record.

Common Model / What You'll See During Setup

Objects/Data Brought In

Key Fields

Ticket

Primary Object: Help Scout support conversations

โ€ข Name โ€ข Description โ€ข Status (Enum) โ€ข Ticket type โ€ข Contact (UUID) โ€ข Creator (UUID) โ€ข Assignees (Array) โ€ข Assigned teams (Array) โ€ข Collections (Array) โ€ข Tags (Array) โ€ข Attachments (Array) โ€ข Ticket URL โ€ข Completed at โ€ข Remote created at โ€ข Remote updated at โ€ข Remote ID โ€ข Remote data

Comment

Conversation replies and notes

โ€ข HTML body โ€ข User (UUID) โ€ข Contact (UUID) โ€ข Is private (Boolean) โ€ข Remote created at โ€ข Remote ID โ€ข Remote data

Attachment

File attachments on conversations

โ€ข File name โ€ข File URL โ€ข Content type โ€ข Uploaded by (UUID) โ€ข Remote created at โ€ข Remote ID โ€ข Remote data

User

Help Scout team members

โ€ข Email address โ€ข Avatar โ€ข Remote ID โ€ข Remote data

Contact

Customer contacts

โ€ข Details โ€ข Remote ID โ€ข Remote data

Account

Customer companies/organizations

โ€ข Name โ€ข Domains (Array) โ€ข Remote ID โ€ข Remote data

Collection

Help Scout mailboxes/inboxes

โ€ข Name โ€ข Collection URL โ€ข Remote created at โ€ข Remote updated at โ€ข Remote ID โ€ข Remote data

Tag

Conversation tags/labels

โ€ข Name โ€ข Remote ID โ€ข Remote data

Team

Agent teams/groups

โ€ข Name โ€ข Remote ID โ€ข Remote data

Permissions

  • When you connect Help Scout as a source in Guru, you'll permission that content in Guru. Learn more here.
  • If someone is not provided with access in Guru to this source, they will not see Help Scout results in searches or when chatting with Guru.