Skip to navigation

Channel Resolvers

View as Markdown

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 resource wrapper. The item’s id goes 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 the num from 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.

MethodPathEndpoint reference
GET/assistant/channel-resolverList channel resolvers
POST/assistant/channel-resolverCreate channel resolver
GET/assistant/channel-resolver/{id}Get channel resolver
PATCH/assistant/channel-resolver/{id}Update channel resolver

Fields

FieldTypeRequiredNotes
idstringread-onlyUnique identifier of this configuration, assigned by the server.
slack_channel_namestring✅Display name of the Slack channel, without the leading #.
slack_channel_idstringID of the Slack channel this configuration applies to. Cannot be changed after creation.
domains_enabledarray<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_disabledarray<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_disabledarray<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_skillsarray<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_disabledbooleanIf 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_enabledbooleanIf true, the assistant also responds to IT agents in the channel. By default, agents are ignored.
handoff_when_no_response_enabledbooleanIf 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_resolutionstringEmoji 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_resolutionstringEmoji 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_filedstringEmoji 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_enabledbooleanIf true, the assistant reacts with emoji_for_no_response when it has no response to a post.
emoji_for_no_responsestringEmoji the assistant reacts with when it has no response to a post. Defaults to exclamation.
emoji_for_manual_creationstringEmoji that, when applied to a user’s post, creates a synced ticket in your ticketing system.
emoji_for_automatic_ticketstringEmoji the assistant applies to non-agent posts when it automatically creates a ticket. Defaults to ticket.
emoji_for_assign_ticketstringEmoji an IT agent applies to a post to assign its ticket to themselves.
ticket_syncing_enabledbooleanIf 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_criteriaenumWhen 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_reachoutbooleanIf 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.
workflowsarray<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_domainenumDefault 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_timestringWhen the configuration was last updated.
updated_bystringWho last updated the configuration.
versionVersion✅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"
}
}