Interakt to MCP: WhatsApp Customers, Templates and Events of Your Interakt Account in any AI Agent

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Interakt, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Interakt

Let your AI work with your Interakt WhatsApp Business account: list approved templates, look up and list customers with their traits and tags, add or update customers, record events and assign chats. Sending template and text messages is installed switched off.

Setup

Setting up takes about 2 minutes. You need an Interakt account on the Growth plan or higher: API access starts there.

1. In Interakt, open Settings → Developer Setting.
2. Copy the Secret Key into INTERAKT_API_KEY exactly as shown, without the word Basic in front. The key is already encoded, and the connector sends it only to api.interakt.ai.
3. Install the connector and run interakt_list_templates: it lists your WhatsApp templates and shows that the key and your plan work.

Phone numbers: most tools take the number without the country code plus the country code on its own, for example 9876543210 and +91 (India is the default). The free-text tool takes the full number without +, for example 919876543210.

What it reads: your WhatsApp templates with their code name, display name, language, category, approval status, header, body with its placeholders, footer and buttons; customers by phone number or Interakt id, with traits such as name, email, WhatsApp opt-in and your own custom traits, plus tags and when they were created and last changed; and customers created or updated in a time window, 100 at a time.

No message history: the Interakt API does not return past messages or delivery status, which only reach Interakt webhooks. The AI cannot tell you whether a customer read a message.

Asks before every change: interakt_upsert_customer creates a customer or updates the one with the same number (traits are merged, tags are added and never removed), interakt_track_event records an event such as Order Placed on a customer's timeline, which can start Interakt automations that message the customer, and interakt_assign_chat assigns a customer's chat in the shared inbox to a team member by email. The AI shows you the customer and the exact change and waits for your yes.

Switched off at install: interakt_send_template and interakt_send_text. They reach the customer at once, and Meta charges the conversation for templates. Free text only works within 24 hours of the customer's last message; outside that window Interakt refuses it and only an approved template works. A template needs exactly one value per placeholder ({{1}}, {{2}} and so on), in order, so the AI reads the template first and counts them; templates with an image or document header also need a public file link. An administrator turns these tools on deliberately, and even then the AI shows you the template or text, the number and the values and waits for your yes. A successful answer means Interakt accepted the message, not that it was delivered.

Limits: Interakt allows 300 requests a minute on Growth and 600 on Advanced, and a single request can be at most 32 KB. After a 429 the AI waits a minute before trying again.

Common errors: 401 means the key is wrong or your plan has no API access: copy the Secret Key again, without Basic, and check that you are on Growth or higher. 400 means a missing or wrong field, and Interakt's message says which, for example "Missing variable values for template's body" when a template value is missing. 429 means the rate limit was reached.

The connector does not create templates, run campaigns, upload media, fall back to RCS or SMS, or manage webhooks.

Prerequisites: INTERAKT_API_KEY

Install the connector locally

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Open http://localhost:3000/connectors/store, pick Interakt and paste in the env vars listed under Prerequisites.

Available tools

Example prompts

• "Look up the customer +91 98765 43210 and show me her name, tags and whether she opted in to WhatsApp."
• "Which of our approved templates are marketing templates, and how many placeholders does each one need?"
• "List the customers who were added or updated in Interakt yesterday."
• "Record an Order Placed event for +91 98765 43210 with order number 1042 and total Rs 1,499. Show me first."
• "Assign the chat of Rahul Sharma (+91 99887 76655) to [email protected]. Check with me before you do it."

Next steps

• Connect to Claude
• Connect to ChatGPT