Docs · AI assistants
Connect Claude or ChatGPT to Dokwise
The Dokwise connector lets your team ask Claude or ChatGPT about your WhatsApp conversations with your contacts. The assistant looks up your Dokwise data to answer. It can read your accounts, contacts, conversations, messages and ad leads. It cannot send messages or change anything.
Dokwise is a remote MCP server (Model Context Protocol). Each person signs in with their own Dokwise login, and an administrator decides which accounts allow it.
Connector URL
https://app.dokwise.io/mcpBefore you start
- A Dokwise account with your WhatsApp Business number connected.
- An administrator turns on AI assistants for the account in Settings › AI assistants. Until then, nobody can connect to that account.
- Claude on any plan, Free included, on the web, desktop or mobile app. Or ChatGPT on a Business or Enterprise plan.
Connect
Claude
- Open Settings › Connectors and choose Add custom connector.
- Name it Dokwise and paste the connector URL.
- Click Connect, sign in to Dokwise and choose your accounts.
On Claude Team or Enterprise, an owner adds the connector once. Everyone else only clicks Connect and signs in with their own Dokwise login.
ChatGPT
- Open Plugins, click + and choose Add custom MCP server.
- Paste the connector URL and choose OAuth.
- Sign in to Dokwise and choose your accounts.
On ChatGPT Business, an admin adds it once. Members connect with their own Dokwise login.
Choose your accounts
After you sign in, Dokwise asks which accounts the assistant may read. Each account is one business. Keep All my accounts ticked to include every account you belong to, and accounts you join later once their AI assistants are on. To pick specific accounts, untick All my accounts and tick the ones you want. The list shows only accounts where AI assistants are on.
Example prompts
Ask in your own words, in any language. These prompts show what the connector does.
“Which contacts are still waiting for a reply from us right now?”
Lists every conversation where the contact wrote last, with their name, phone number and how long they have waited.
Useslist_conversations
“How many WhatsApp messages did we receive this week, and what was our median reply time each day?”
Gives messages received and sent per day, the median minutes to a staff reply and how many conversations are awaiting a reply.
Usesmessage_statistics
“Find conversations from the last 30 days where people asked about our prices, and tell me what each one asked.”
Finds the matching conversations, then reads the threads that need more context.
Usessearch_messagesread_conversation
“Read my latest conversation with Sarah and tell me what she still needs from us.”
Finds the contact by name, reads the newest messages in her thread and lists what is still open.
Usesfind_contactsread_conversation
“Which people messaged us from our ads this month and never got a reply?”
Lists click-to-WhatsApp leads in the unanswered stage, with the ad they clicked and when.
Usesad_leads
What it can read
The connector has eight tools. Every tool is read-only and returns rows labelled by account. It gives raw WhatsApp data with no AI summaries, so the assistant answers from the messages themselves. The assistant learns from list_accounts whether each account is a clinic, real estate, insurance or another business, so it uses the right words for your contacts.
| Tool | What it returns |
|---|---|
List accountslist_accounts | The accounts you can read, your role in each and its timezone. It also says what kind of business each one is and what its contacts are, such as patients or buyers. |
Find contactsfind_contacts | Up to 20 contacts matching part of a name, phone number or email. |
List conversationslist_conversations | Recent conversations, newest first, with status and how long the contact has waited. Can list only the ones still waiting for a reply. |
Read a conversationread_conversation | One contact’s WhatsApp thread with who wrote each message and when. Images, voice notes and PDFs show as markers in the text. |
Search messagessearch_messages | A word or phrase of 3 characters or more across messages, voice note transcripts and image and PDF descriptions. |
Get an imageget_attachment | One image from a message, resized to fit 1024 pixels. |
Ad leadsad_leads | People who messaged after clicking a click-to-WhatsApp ad, with the ad, the first reply time and a stage: unanswered, answered or engaged. |
Message statisticsmessage_statistics | Messages received and sent, the median reply time and conversations awaiting a reply, per day or per hour. |
Images, voice notes and PDFs appear in message text as markers, such as [Image: description] (attachment 8812) or [Voice note: transcript]. The assistant can open an image with get_attachment. Long lists come in pages, and the assistant fetches the next page when it needs more.
The connector cannot send WhatsApp messages, change contacts or conversations, or read accounts where AI assistants are off.
Manage access
Administrators manage the connector in Settings › AI assistants:
- The switch turns AI assistants on or off for the account. Turning it off removes the account from everyone's access from their next request.
- Connected people shows who connected, with which app, their access, when they last used it and their lookups today. Disconnect removes this account from a person's access. Their other accounts keep working.
- Recent activity shows every lookup an assistant makes in the account, with who asked and what it opened.
To stop your own access, remove Dokwise in your assistant's connector settings.
Data and privacy
- Sign-in uses OAuth 2.0. The assistant never sees your Dokwise password. You stay connected until you or an administrator disconnect.
- When you ask a question, the data that answers it is sent to the AI provider you connected, and that provider's terms apply. Business plans such as Claude Team and ChatGPT Business do not train on your data by default.
- Dokwise receives only the lookups the assistant makes. It never receives your chat with the assistant.
- Dokwise logs each lookup so administrators can see activity and we can check answer quality. The results returned are deleted from the log after 30 days.
The full details are in section 14 of our Privacy Policy.
Limits
Fair-use limits apply. If you reach one, the assistant tells you when to try again.
Troubleshooting
- Sign-in says “AI assistants are off for your accounts”.
- An administrator of the account needs to turn on AI assistants in Settings › AI assistants. Then connect again from Claude or ChatGPT.
- An account is missing from the sign-in list.
- Only accounts with AI assistants turned on are listed. Ask that account’s administrator to turn it on.
- The assistant says “None of those accounts can be read with this connection”, or asks you to connect again.
- The account was switched off, you left it, or an administrator disconnected you. Ask the assistant to run list_accounts to see what it can still read. If nothing is left, connect again from your assistant’s connector settings.
- “This lookup took too long” or “The result is too large”.
- Ask for a shorter date range, one account or a specific contact.
- “Time ran out before these accounts were read”.
- The lookup covered several accounts and stopped before the last ones. The assistant asks again for the accounts it missed. You can also ask about fewer accounts at a time.
- “Dokwise is busy right now”.
- Try again in a few seconds.
- “Dokwise rate limit reached” or “Dokwise daily limit reached”.
- You reached a fair-use limit. The message says when you can try again.
- A message shows [Media not available].
- Meta did not send the file for that message. This happens mostly in chat history imported from before the account joined Dokwise.
Support
For help with the connector, email hello@dokwise.io. To report a security issue or a privacy concern, email our Data Protection Officer at dpo@health-ai-labs.com.
Dokwise is operated by Health AI Labs Pte. Ltd., Singapore.