This page is for API Reference & Tools.
assistant.channel-resolver
Assistant on a Slack channel.
- Endpoint:
/assistant/channel-resolver| Methods: GET, PATCH, POST - Request shape: fields go at the top level of the JSON body, with no
resourcewrapper. The item’sidgoes in the URL for reads and updates, not in the body. - Updates: a JSON merge-patch. Send only the fields you change, plus
version: {num, change_description}with thenumfrom your last read. Lists and maps you send replace the stored ones whole.
Endpoints
All paths are relative to https://api.moveworks.ai/configurations/v1alpha1. Each endpoint page lists the request and response schema, an example, and the errors it can return.
| Method | Path | Endpoint reference |
|---|---|---|
GET | /assistant/channel-resolver | List channel resolvers |
POST | /assistant/channel-resolver | Create channel resolver |
GET | /assistant/channel-resolver/{id} | Get channel resolver |
PATCH | /assistant/channel-resolver/{id} | Update channel resolver |
Fields
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | read-only | Unique identifier of this configuration, assigned by the server. |
slack_channel_name | string | ✅ | Display name of the Slack channel, without the leading #. |
slack_channel_id | string | ID of the Slack channel this configuration applies to. Cannot be changed after creation. | |
domains_enabled | array<enum> | Domains the assistant responds to in this channel. If empty, it responds to all posts; otherwise only to posts classified into these domains. One of: UNKNOWN_DOMAIN, IT_DOMAIN, HR_DOMAIN, FACILITY_DOMAIN, FINANCE_DOMAIN, LEGAL_DOMAIN, PAYROLL_DOMAIN, PROCUREMENT_DOMAIN, … (14 values). | |
skills_disabled | array<enum> | Skills disabled in this channel. Any of ACCESS_SW, ACCESS_DL, ACCESS_ACCOUNT, ENTERPRISE_SEARCH, or FORM. One of: ACCESS_SW, ACCESS_DL, ACCESS_ACCOUNT, ENTERPRISE_SEARCH, FORM. | |
subskills_disabled | array<enum> | Account Access sub-skills disabled in this channel. Any of ACCOUNT_UNLOCK, MFA_RESET, or FORGOT_PASSWORD. Disabling ACCESS_ACCOUNT already disables all of them. One of: ACCOUNT_UNLOCK, MFA_RESET, FORGOT_PASSWORD. | |
feedback_enabled_skills | array<enum> | Skills that show feedback (post-back) buttons in the channel. Any of ACCESS_SW, ACCESS_DL, ACCESS_ACCOUNT, or FORM. One of: ACCESS_SW, ACCESS_DL, ACCESS_ACCOUNT, FORM. | |
ticket_filing_disabled | boolean | If true, no ticket is filed when a user does not get a correct response in the channel. Useful when channel questions do not belong in your ticketing system. | |
responding_to_agents_enabled | boolean | If true, the assistant also responds to IT agents in the channel. By default, agents are ignored. | |
handoff_when_no_response_enabled | boolean | If true, when the assistant has no answer it offers the user handoff options in a DM, such as filing a ticket or talking to an agent. The issue is not marked resolved if handoff is used. | |
emoji_for_no_resolution | string | Emoji the assistant reacts with when it cannot resolve a post. Defaults to exclamation. Must differ from emoji_for_resolution and emoji_for_ticket_filed. | |
emoji_for_resolution | string | Emoji the assistant reacts with when it provides a resolution. Defaults to white_check_mark. Must differ from emoji_for_no_resolution and emoji_for_ticket_filed. | |
emoji_for_ticket_filed | string | Emoji the assistant reacts with when a ticket is filed. Defaults to ticket. Must differ from emoji_for_no_resolution and emoji_for_resolution. | |
emoji_when_no_response_enabled | boolean | If true, the assistant reacts with emoji_for_no_response when it has no response to a post. | |
emoji_for_no_response | string | Emoji the assistant reacts with when it has no response to a post. Defaults to exclamation. | |
emoji_for_manual_creation | string | Emoji that, when applied to a user’s post, creates a synced ticket in your ticketing system. | |
emoji_for_automatic_ticket | string | Emoji the assistant applies to non-agent posts when it automatically creates a ticket. Defaults to ticket. | |
emoji_for_assign_ticket | string | Emoji an IT agent applies to a post to assign its ticket to themselves. | |
ticket_syncing_enabled | boolean | If true, Slack thread messages and user-facing ticket comments are synced in both directions. Requires webhooks to be configured in your ticketing system. | |
ticket_creation_criteria | enum | When synced tickets are created: MANUAL_ONLY when an agent applies the manual creation emoji, or FULLY_SYNCED for every non-agent post. One of: TICKET_CREATION_CRITERIA_MANUAL_ONLY, TICKET_CREATION_CRITERIA_FULLY_SYNCED. | |
assign_ticket_to_bot_upon_reachout | boolean | If true, tickets created from a channel reachout are assigned to the assistant’s service account, and unassigned if the user says the reachout was not helpful. | |
workflows | array<ChannelWorkflow> | Slack workflows that post in this channel, so the assistant can extract the requester and issue from their posts. The list is replaced as a whole on update. | |
default_domain | enum | Default domain used for ticket filing. One of: UNKNOWN_DOMAIN, IT_DOMAIN, HR_DOMAIN, FACILITY_DOMAIN, FINANCE_DOMAIN, LEGAL_DOMAIN, PAYROLL_DOMAIN, PROCUREMENT_DOMAIN, … (14 values). | |
updated_time | string | When the configuration was last updated. | |
updated_by | string | Who last updated the configuration. | |
version | Version | ✅ | Document version. On update, send back the num from your last read. |
Example create body
{"slack_channel_name": "example-name","slack_channel_id": "C0123456789","domains_enabled": [],"skills_disabled": [],"subskills_disabled": [],"feedback_enabled_skills": [],"ticket_filing_disabled": true,"responding_to_agents_enabled": true,"handoff_when_no_response_enabled": true,"version": {"change_description": "Create channel resolver"}}