Integrate your web chat with a Zendesk service desk solution so that your assistant can handover to a human representative within your Zendesk account.

To integration Môveo.AI with Zendesk you would need a Zendesk Chat account. Zendesk Chat is an add-on to Zendesk Support. Zendesk Support puts all your customer support interactions in one place, so communication is seamless, personal, and efficient, which means more productive agents and satisfied customers.


To connect Zendesk with Môveo, you need to have the Zendesk Chat Enterprise version.

Get info from Môveo

  1. Log in to your Môveo.AI account and click to Connect a new Zendesk integration
  2. Note down the Client Name, Company and Callback URL.

Create Zendesk agent

  1. Go to your Zendesk Chat account
  2. Create a new Agent and set the role to Administrator.
  3. This new Agent is the virtual assistant, so you can give an appropriate name that suits your business needs.

Get the authorization details

  1. Log in to Zendesk Chat using the Agent you just created.
  2. Go to Settings > Account > API & SDKs > Add API client.
  3. Provide the Client Name, Company and Callback URL you got from the info from Môveo.
  4. Click Create API client.
  5. Note down the Client ID and Client Secret.
  6. Note down the Subdomain of your zendesk integration. You can find you domain by inspecting the Zendesk URL. For example if the URL your Zendesk chat is https://mycompany.zendesk.com/..., the subdomain is mycompany.

Pass details to Môveo

  1. Go back to the Môveo.AI Zendesk integration.
  2. Copy the Client ID, Client Secret and Subdomain from the authorization details into the Authorize Zendesk section
  3. Click connect and follow the authorization prompt.

Activate and select tags

  1. After connecting your integration, set the status to active to start receiving messages.
  2. Optional: Select the tags you want the virtual assistant to engage. If you select no tags, the assistant will respond to all messages.

Configuration in Zendesk

When integrating Môveo with Zendesk, it is important to note that Môveo's AI capabilities will operate through Zendesk's Web Widget Classic, where chat interactions take place. This is different from using Zendesk's native answer bot, which is considered messaging through the Web Widget.


This distinction is important because when the Zendesk answer bot is handling a conversation, no ticket has been created in Zendesk and no agents are engaged. However, when using Môveo's integration as an agent within Zendesk and through the API client established in chat, Môveo's AI capabilities will only be utilized when a ticket has already been created.

In order for the Zendesk chat to result in a conversation that includes one or more Môveo brains, and also creates a Zendesk ticket, you need to perform the following steps on the Zendesk side:

  • Go to Admin Center > Channels > Web Widget (Classic) and enable the Chat setting.

  • Go to Settings > Widget > Forms and turn on the Pre-chat form.

    You can also require the user to select a specific department in the pre-chat form, where they will still have the option to go straight to a human agent, if they choose a department that is not linked to Môveo. For example, if a user selects the Marketing department, Môveo handles the conversation, if they select the Customer Support EN one, the conversation goes to a human agent.

  • Always have at least one agent with Online status in Zendesk support. This agent can be either one of your human agents, or Môveo.

Last updated on