Skip to content

List a customer’s conversations

Tool name: list_customer_conversations

Returns the conversations with one customer as a single timeline, most recent first: meetings, emails and support tickets. Each has a title, a short summary and who took part. Use fromDate and toDate to reach older conversations, and get_conversation with the type and id for the full transcript, email or ticket. The emails are the ones synced from the customer’s mail or CRM, which can include emails sent from Hook; list_customer_sent_emails has those with their tracking.

Input schema

customerstring, non-emptyrequired

The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer

typesArray of strings, non-empty

Only return these types of conversation. Leave empty for all of them

Items Enum:"meeting""email""support_ticket"
fromDatestring
Any of:

Only conversations on or after this date, such as 2025-01-31

string (date)
toDatestring
Any of:

Only conversations on or before this date. A day, such as 2025-03-31, includes the whole day

string (date)
limitinteger, [ 1 .. 25 ]

How many to return, up to 25. Ask for more only if the first results were not enough

Default:10
offsetinteger, [ 0 .. 9007199254740991 ]

How many to skip from the start of the list. To continue a list, give how many have been returned so far

Default:0
Input example
{ "customer": "string", "types": [ "meeting" ], "fromDate": "2019-08-24", "toDate": "2019-08-24", "limit": 10, "offset": 0 }