Artisan IMG > Help Scout (help-scout) (6585928b-6e14-49c6-bae8-ffaf73fc6bce)

Help Scout
1.0

Directory as a service

Overview
Copy

Authentication
Copy

To create an authentication with Help Scout, click on the New Authentication button and enter the same username and password used to login to your Help Scout account.

Example 1 - List Customers
Copy

In this example we'll retrieve a list of customers, using some filters and also using the advance query field.

The List operations in the Help Scout connector limit results to 50 items. To retrieve more results, the Page property needs to be used to paginate through the result set if there are more than 50.

For more information on pagination, please refer to our pagination help page here.

Step 1 - Populate filters
Copy

There are a standard set of filters in the List customers operation, including a query option for more advanced querying.

For example, customers can be filtered by Mailbox by choosing the mailbox name from the drop down. We can also return all records that have been modified after a certain date. Results can then sorted by a different fields (we'll choose modified at in this example).

Step 2 - Populate advanced query
Copy

In addition to these filters, the Advance query property can also be used to apply more specific conditions. For example, if we wanted all customers where the email is demo@tray.io or demo1@tray.io, AND the phone number is 01234567890, our query input would look like the below.

Notice how the Conjunction is set to AND. This dictates how the field filters are logically combined. Options are AND or OR.

Step 3 - Results
Copy

Each result set will contain some properties that give information about how many items were returned, and if there are any more items to retrieve from Help Scout (see below).

You can see that the size property shows that 50 customers were returned, but the total number of customers is 110. Meaning we would need to make the request again and specify 2 in the Page property.

Example 2 - Create conversation
Copy

To create a conversation, at least one thread needs to be added. If only one thread is specified, this cannot be a note thread.

Step 1 - Populate required fields
Copy

Choose the type of conversation you want to create i.e. chat, email or phone. Then populate the required fields, including the customer ID associated with the conversation.

Step 2 - Add a thread
Copy

At least one thread is required, and there are different types of threads (having only one note thread is not allowed). Here we'll add a chat thread.

The Imported option is for those situations when the chat, phone call or email activity has already occurred, and you just want to make a record of it. Ticking the imported option allows you to set a historical Created at date of when the contact happened.

Attachments can also be uploaded, this requires a file object which has been generated by another connector step e.g. the Google Drive connector. This can be achieved by JSON pathing in the file object (shown below).

Please refer to our help pages on using the connector snake here, which will help create the JSON path for the file object.

Step 3 - Result
Copy

If successful, the result will be the ID of the created conversation.