Connect Grok Bot to Deskwoot
On this page
Grok Bot from xAI can join your support team in Deskwoot as an AI teammate. You connect it once, it gets its own name in your team, and it works the conversations you give it under the rules you set. Deskwoot wakes it the moment new work arrives. This guide covers what you need, the connection, the setup questions, the wake on new work and where your data goes.
What you need
- A Deskwoot workspace on Startup, Business or Enterprise, or in the 7 day trial. The free Hacker plan has no AI agents.
- A Deskwoot login of that workspace with a confirmed email address and a password. If you signed up with Google or Apple and use no second factor, a fresh sign in with Google or Apple just before you connect stands in for the password. If your workspace requires two factor sign in, set that up first too.
- The Data Processing Agreement for AI agents, accepted once by an administrator in the first step of Connect an AI agent under AI teammates.
- Grok Bot on an account that belongs to your company. What xAI charges for Grok Bot is between you and xAI.
Use a Grok Bot just for support, with as few other connectors as possible. Keep your support mailbox and your support accounts out of Grok's own connectors, so Grok answers customers only through Deskwoot.
How Grok Bot works in your team
Fynn, the AI agent built into Deskwoot, takes the first contact in your live chat and answers right away. Grok Bot works like a colleague: it gets its own name, marked as an AI agent, and works the conversations assigned or handed to it, the ones Fynn hands to it and the ones where someone mentions it. While Fynn is still in a conversation, Grok stays out, so 2 bots never answer at once. How it gets work is up to you: only where someone mentions it, also conversations someone assigns it, or also new conversations in turn with your team. Every message Grok writes to a customer is marked as written by AI, unless the workspace owner switches off its AI label.
Autonomy, held topics, approvals, pausing and everything else about AI teammates is in AI teammates: how connected AI agents work in your team.
Connect Grok Bot
- In Deskwoot, open AI teammates in the rail, choose Connect an AI agent and pick Grok Bot. The next step shows a sentence to copy.
- Write it to Grok Bot in its chat:
Add a custom MCP server called Deskwoot at https://deskwoot.com/api/mcp. Grok Bot repeats the name and the address and asks you to confirm. Confirm, then open the sign in for Deskwoot that it shows. - Sign in with the account of the workspace Grok should work in.
- On the consent page, choose how Grok works: As its own AI teammate (recommended) with a name of its own, or As your personal assistant. A Specialist for internal work only is under More options. Then choose what Grok may send to customers and which inboxes it works in. Leave Reads every conversation in its inboxes off unless Grok needs it.
- Tick the statement, enter your password (and the code from your authenticator app or your passkey, if you use two factor sign in), or leave the password empty right after a fresh sign in with Google or Apple, and choose Connect.
Grok starts working only once the workspace owner connects or approves it. Connected by the workspace owner, it works at once. When another administrator connects it, the last button on the consent page is Request approval, and Grok waits under Requests for AI agents on AI teammates until the workspace owner approves it. A member starts at step 2 in Grok Bot, and Grok waits there too. As a personal assistant, Grok connects at once while Members may connect personal assistants and the MCP server are on. Order lookups and refund proposals stay off unless the workspace owner switches on Look up orders and propose refunds on the consent page, or an administrator switches them on later on Grok's page.
The setup questions
Once Grok is connected, the last step of Connect an AI agent shows a sentence to copy. Write it to Grok: Use the Deskwoot connector: call onboarding_start and go through the onboarding with me. Grok then asks you up to 6 questions: its job, the topics that wait for a person, its tone, who takes over when it escalates, what it must never promise and, when its job includes drafts or answers, how it gets its work. From your answers it proposes its rules, and an administrator approves them on Grok's page under AI teammates. Until then Grok writes drafts only. You can also skip the questions there with Go live with these rules.
Wake Grok on new work
When the questions are done, write to Grok: Use the Deskwoot connector: call whoami and set up the Deskwoot routine with a webhook trigger. Grok sets up a routine that Deskwoot can wake. Then:
- Open Grok Bot on your computer (the phone app does not show the address).
- Click the bot's name at the top, then Details.
- Under Routines, right click your Deskwoot routine and choose Webhook.
- Copy "POST to" and "Key", not "Header", and paste both in the last step of Connect an AI agent, or on Grok's page under AI teammates at Wake address of Grok Bot.
From then on Deskwoot wakes Grok when a conversation is handed to it or its team, a customer writes in one of its conversations, someone mentions it, or one of its replies did not reach the customer. Grok's page shows whether the last wake worked. Without a wake address, Grok works only when its own schedule starts it.
Where your data goes
Deskwoot limits what Grok can do inside Deskwoot. Every text Grok reads there says where it comes from, so Grok can tell a customer's words from your team's notes, and risky replies wait for a person, whatever Grok was told. Deskwoot logs everything Grok does in Deskwoot, but it cannot see or stop what Grok does through its other connectors.
Everything Grok reads in Deskwoot leaves Deskwoot and goes to xAI, which runs Grok Bot, and to any service Grok passes it to. xAI is not Deskwoot's subprocessor and is not covered by Deskwoot's Data Processing Agreement, so your company needs its own agreement with xAI that covers this data. Deleting data in Deskwoot, or stopping Grok, does not delete what xAI already received.
What it costs
Deskwoot charges no fee for Grok Bot or any other agent. Grok counts toward the AI conversations of your plan, on top of Fynn and Copilot, together with your other agents, replies through the REST API and from Custom Webhook bots. A reply of Grok that reaches a customer counts as 1 AI conversation, however many of your agents reply in the same conversation, and a draft of Grok that your team approves and sends counts 0.5. Reading never counts. How this adds up with Fynn in the same conversation, what other work counts and when a conversation counts again is in AI conversations and billing.
Frequently asked questions
Does Grok Bot replace Fynn?
No. Fynn keeps answering your live chat right away. Grok Bot works the conversations assigned or handed to it once Deskwoot wakes it, and it never answers while Fynn is still in a conversation.
Can one Grok Bot work for two Deskwoot workspaces?
Each connection belongs to one workspace, which you pick when you sign in. Connect a separate Grok Bot in each workspace, so customer data never mixes.
Can Grok Bot approve its own drafts or refunds?
No. Only a person signed in to Deskwoot approves. Refunds, cancellations and shipments are always proposals that a person in your team makes with their own account.
What happens when the trial ends?
If the workspace moves to the free Hacker plan, Grok stops working in Deskwoot with its next call and shows Waits for a paid plan. Its settings stay, and once you choose a paid plan it works again without connecting anew.
Can I connect more than one Grok Bot?
Yes. Each one gets its own name, and no 2 agents or people in a workspace share a name.
Was this guide helpful?
Keep reading
- Plans and pricing: what each Deskwoot plan includesPrices, limits and features of the Hacker, Startup, Business and Enterprise plans, how AI conversations are counted, and what happens when a trial ends or you change your plan.Read guide
- Teams: route conversations by department, language, or skillGroup agents into teams so conversations land with the right people: how conversations get into a team, who in the team gets them, the team's folders, what members see and reports by team.Read guide
- What can the Deskwoot REST API do?Read and change conversations, messages, contacts and tickets from your own tools with the Deskwoot REST API. It is part of the Enterprise plan.Read guide
Ask Fynn about this guide
Get a short answer from this guide and the rest of the help center.