Hiver in Gmail

Find conversations in Hiver in Gmail by status, assignee, tags, dates, free text, with sorting and paging. `inbox_id` comes from `list_inboxes`, `assignee_id` from `list_inbox_users`, `tag_ids` from `list_tags`. Pass the user's `timezone` and resolve relative dates like 'yesterday' in it. Returns one page; follow `next_page_token`. Use `get_conversation` to open one result and `list_messages` to read its emails.

find_conversations

Get an app's card settings in Hiver in Gmail (administrators only): for each card Hiver shows beside conversations, who sees it (`visible_to`), in which inboxes, and which fields it shows, each with a `field_id`. `app` is a name or connector id from `list_apps`; pass `card_id` for one card, which adds the custom fields the app offers. Use before `update_app_card_settings`.

get_app_card_settings

Get the app cards Hiver shows beside a conversation in Hiver in Gmail (a Salesforce contact, a HubSpot deal, a Jira issue, ...) as short `label: value` lines, plus the app records linked to the conversation (`linked_records`). Use it for "what does our CRM say about this customer". `inbox_id` comes from `list_inboxes` and `conversation_id` from `find_conversations`; pass `app` (a name or connector id from `list_apps`) for one app only. A card that needs the user's own sign-in carries `connect_url`: relay it, never ask for a password, API key or token.

get_app_cards

Get one automation rule in Hiver in Gmail with its trigger, conditions and actions (administrators only). `inbox_id` comes from `list_inboxes` and `automation_id` from `list_automations`.

get_automation

Get the triggers, conditions and actions the automations of a shared inbox in Hiver in Gmail can use (administrators only). `inbox_id` comes from `list_inboxes`. To build a rule, use `draft_automation`.

get_automation_schema

Get a customer company in Hiver in Gmail: name, description, email domains and custom fields. `inbox_id` comes from `list_inboxes` and `company_id` from `get_contact` (its `company`). Use `get_contact` for the person on a conversation.

get_company

Get the customer contact of a conversation in Hiver in Gmail, or a contact by id: name, email, phone, custom fields, company and how many conversations they have had. Returns `contact: null` when the conversation has no identified contact. `inbox_id` comes from `list_inboxes` and `conversation_id` from `find_conversations`; pass `contact_id` instead to look one up again. Use `get_company` for the contact's company.

get_contact

Get one conversation in Hiver in Gmail: subject, status, assignee and tags, and with `include` its custom fields (with sentiment) and shared draft. `inbox_id` comes from `list_inboxes` and `conversation_id` from `find_conversations`. Use `list_messages` to read the emails and notes.

get_conversation

Get whether a conversation's emails in Hiver in Gmail are logged to a CRM (Salesforce, HubSpot, ...): the app, the records logged to, the app's recommended records, and each email's status. `inbox_id` comes from `list_inboxes` and `conversation_id` from `find_conversations`. When logging is available it also returns a `preview` of what would be logged (the recommendations, or the `entities` you pass) and a `confirmation_token`: show the preview and ask before calling `start_email_logging`.

get_email_logging

Get one shared inbox in Hiver in Gmail: its details, SLA policies where it has them, and its custom field definitions (id, name, type, options). `inbox_id` comes from `list_inboxes`; field ids from here are the `field_id` of `save_custom_field`. Use `list_inbox_users` for its members and `list_tags` for its tags.

get_inbox

Add a link from a conversation in Hiver in Gmail to an app record (a Salesforce case, a HubSpot deal, ...), as the Link control on its card does. `inbox_id` comes from `list_inboxes`, `conversation_id` from `find_conversations`, `app` (connector id) and `record_id` (with `form_id`, when there is more than one kind) from `search_app_records`. Linking a record that is already linked changes nothing.

link_app_record

List the sections of Hiver's help center for Hiver in Gmail with their article counts and URLs, to browse a topic when `find_help_articles` finds nothing.

list_help_categories

List the apps (Salesforce, HubSpot, monday, Jira, ...) installed in this Hiver in Gmail account and whether each is connected for the user: `connected`, or what is needed (`action_needed`) and where (`connect_url`, a page in Hiver; give the user that link in full, never a shortened id or URL pattern). Pass `inbox_id` (from `list_inboxes`) to see whether each app is on in that inbox. Apps turned off are left out unless `status` asks for them; `name` narrows the list, 50 per page by default (pass `next_cursor` as `cursor` for more). Use `connect_app` to connect one.

list_apps

List the automation rules of a shared inbox in Hiver in Gmail (administrators only): id, name, whether it is on, and its trigger, 50 per page by default; pass `next_cursor` as `cursor` for the next page. `inbox_id` comes from `list_inboxes`. Pass a rule's id as `automation_id` to `get_automation` for its steps.

list_automations

List the activity history of a conversation in Hiver in Gmail (assignments, status and tag changes, plus custom field and SLA events where the product records them), oldest first. Notes, drafts and merges are not in the history: `unsupported_event_types` names the types the product does not return. `inbox_id` comes from `list_inboxes` and `conversation_id` from `find_conversations`. Use `list_messages` for the emails and notes themselves.

list_conversation_activity

List the members of a shared inbox in Hiver in Gmail, with ids and emails. `inbox_id` comes from `list_inboxes`; use the returned user ids as `assignee_id` in `update_conversation` or `mention_user_ids` in `add_note`.

list_inbox_users

List the shared inboxes the user can access in Hiver in Gmail, with their ids. Call this first to get the `inbox_id` every other tool needs; use `get_inbox` for one inbox's details and SLA policies.

list_inboxes

List or search the tags of a shared inbox in Hiver in Gmail, with ids. `inbox_id` comes from `list_inboxes`; use the returned ids as `tag_ids` in `find_conversations` or `add_tag_ids` in `update_conversation`.

list_tags

Change whether a conversation's emails in Hiver in Gmail keep being logged to the CRM: `auto_log` false pauses logging new emails and true resumes it; `entities` pauses or resumes single records (`record_id` from `get_email_logging`). Emails already logged stay in the CRM. `inbox_id` comes from `list_inboxes` and `conversation_id` from `find_conversations`.

set_email_logging

Get support workload or performance per customer company for an inbox in Hiver in Gmail (administrators only). `inbox_id` comes from `list_inboxes`. Use `get_conversation_metrics` for the whole inbox.

get_company_support_report

Read one Hiver help article for Hiver in Gmail as markdown, with its URL to cite. Pass `focus` with the user's question to get only the sections that answer it. `slug` comes from `find_help_articles`.

get_help_article

Read the message thread of a conversation in Hiver in Gmail: emails with bodies and attachment names, and internal notes in time order. `inbox_id` comes from `list_inboxes` and `conversation_id` from `find_conversations`. Long threads are cut at a size limit; follow `continue_with`. Email rows carry `gmail_message_id`, `gmail_thread_id` and `message_id_header` (the RFC Message-ID). Use `get_conversation` for state only.

list_messages

Report that the user asked for something none of the available tools can do. Call this ONLY after you have looked at the other tools and concluded that none of them can answer the request, even partially. It records the gap so Hiver can build the missing capability. Do NOT call this when: - another tool can answer the request, even if it takes several calls - a tool failed, returned an error, or timed out (that is a fault, not a gap; retry or tell the user it failed) - you are missing an argument you could ask the user for - the request is outside Hiver entirely (weather, general knowledge, other apps) Call it at most once per distinct unmet request. Calling it does not perform the user's request and returns no data, so never call it hoping to retry, and do not tell the user their request has been actioned or queued. Describe the missing CAPABILITY, not the user's request and not the contents of their mailbox. Good: "no way to filter conversations by SLA breach". Bad: "user asked about Acme Corp's refund complaint". Never copy email bodies, subjects, customer names or email addresses into the field.

report_unmet_need

List the conversations behind a report in Hiver in Gmail, with any of the columns its export has (administrators only): first responder, resolution time, CSAT comment, SLA breach times, contact company, custom field values and more, a page at a time. `inbox_id` comes from `list_inboxes`; up to five inboxes can be read together with `inbox_ids`. Narrow with `assignee_ids` from `list_inbox_users` and `tag_ids` or `without_tag_ids` from `list_tags`. Use `get_conversation_metrics` for totals and trends, and `find_conversations` to search the inbox.

get_report_rows

Get SLA violations or compliance for an inbox in Hiver in Gmail (administrators only), as the breaching conversations or a trend. `inbox_id` comes from `list_inboxes`. Use `get_conversation_metrics` for response times and `find_conversations` to open a breaching conversation.

get_sla_report

Create a custom field in a shared inbox in Hiver in Gmail (`name` required), or rename it or add options by its `field_id` (the name stays as it is when omitted). `inbox_id` comes from `list_inboxes` and `field_id` from `get_inbox`. Use `update_conversation` to set a field's value on a conversation.

save_custom_field

Create a tag in a shared inbox in Hiver in Gmail, or rename or recolour one by its `tag_id`. `inbox_id` comes from `list_inboxes` and `tag_id` from `list_tags`. Use `update_conversation` to apply a tag.

save_tag

Find records in a connected app (Salesforce, HubSpot, ...) from Hiver in Gmail, to link one to a conversation with `link_app_record`. `inbox_id` comes from `list_inboxes`; `app` is the app's `connector_id` from `list_apps` or `get_app_cards`. Omit `form_id` unless the app links more than one kind of record: the error then lists the choices.

search_app_records

Get positive, neutral and negative conversation counts for an inbox in Hiver in Gmail over a date range (administrators only). `inbox_id` comes from `list_inboxes`. Call once per period to compare. Use `get_csat_report` for customer-rated satisfaction.

get_sentiment_summary

Start logging a conversation's emails in Hiver in Gmail to a CRM, only after the person has seen the `preview` from `get_email_logging` and agreed. The emails are copied into the CRM and cannot be taken back from Hiver. `inbox_id` comes from `list_inboxes`, `conversation_id` from `find_conversations`; `connector_id`, `entities` (the `proposed` list, unchanged) and `confirmation_token` from `get_email_logging`. To pause, use `set_email_logging`.

start_email_logging

Change whether an installed app (Salesforce, HubSpot, monday, ...) is on for one shared inbox in Hiver in Gmail (administrators only), for everyone in the account: `enabled` true turns it on, false off. Without `confirmation_token` it changes nothing and returns a `preview` and a token: show the preview, confirm with the person first, then call again with the same arguments and the token. `app` comes from `list_apps` and `inbox_id` from `list_inboxes`. Use `update_app_card_settings` for one card.

set_app_inbox_enabled

Change whether an automation rule in Hiver in Gmail is on or off (administrators only). `inbox_id` comes from `list_inboxes` and `automation_id` from `list_automations`. Turning it off stops it acting on new conversations; nothing else about the rule changes.

set_automation_enabled

Delete the link between a conversation in Hiver in Gmail and an app record; the record itself stays in the app. `inbox_id` comes from `list_inboxes`, `conversation_id` from `find_conversations`, and `card_id` and `record_id` from `get_app_cards` (`linked_records`). Confirm with the person first.

unlink_app_record

Change one app card's settings in Hiver in Gmail (administrators only), for everyone in the account: who sees it (`visible_to`, or "nobody" to hide it), its inboxes (`inbox_ids`), and the fields it shows in order (`shown_field_ids`). `card_id`, roles and field ids come from `get_app_card_settings`. Without `confirmation_token` it changes nothing and returns a `preview` and a token: confirm with the person first, then call again with the same arguments and the token.

update_app_card_settings

Change a conversation in Hiver in Gmail: add or remove tags, set or clear its custom field values, assign it, or set its status. `inbox_id` comes from `list_inboxes`, `conversation_id` from `find_conversations`, `assignee_id` from `list_inbox_users`, `add_tag_ids` and `remove_tag_ids` from `list_tags`, custom field ids from `get_inbox`. Changes only what is named. Use `add_note` to leave a comment instead.

update_conversation

Update the text of an internal note in Hiver in Gmail that the signed-in user wrote; the old text is replaced and not kept. `inbox_id` comes from `list_inboxes`, `conversation_id` from `find_conversations` and `note_id` from the note rows of `list_messages`. Only the author can edit a note, and only within 4 hours of adding it. Use `add_note` to add a new note instead.

update_note

Get the signed-in user's id, email, role and accessible inbox ids in Hiver in Gmail. Use it to learn who is asking and whether admin-only reports are available; use `list_inboxes` for inbox names.

whoami