Omdaa AI + n8n in 10 Minutes — Free Forever Automation
November 3, 20263 min read26 views
Admin
Connect Omdaa AI auto-replies with n8n workflows in under 10 minutes. Everything runs on Omdaa API — Free Forever (no paid tier, no credit card).
Series: Free Forever WhatsApp Dev
What you'll build
``mermaid
flowchart LR
WA[WhatsApp Message] --> O[Omdaa API Webhook]
O --> N[n8n Workflow]
N --> AI[Omdaa AI Reply]
N --> S[Google Sheets / CRM]
`
- Incoming WhatsApp messages trigger n8n
- Omdaa AI handles smart replies (included free)
- Optional: log messages to Google Sheets or Slack
- Bonus: drive the same stack from Cursor MCP (109 tools, v2.3)
Prerequisites
- Omdaa account (free forever)
- WhatsApp session connected (Dashboard → Sessions)
- n8n instance — use omdaa.com/n8n or self-hosted
- API key from Dashboard → API Keys
Step 1: Import the n8n workflow (2 min)
Import integrations/n8n/omdaa-whatsapp-inbound.workflow.json from the omdaa-sdk repo.
Webhook path: omdaa-whatsapp
Production URL example:
`
https://omdaa.com/n8n/webhook/omdaa-whatsapp
`
Activate the workflow in n8n so the production webhook is live.
Step 2: Configure Omdaa webhook (2 min)
Install the official scoped client (v1.2+):
`bash
npm install @omdaafreeapi/omdaa-api-client
`
`javascript
const { OmdaaClient } = require('@omdaafreeapi/omdaa-api-client');
const client = new OmdaaClient({ apiKey: process.env.OMDAA_API_KEY });
await client.webhooks.set({
url: 'https://omdaa.com/n8n/webhook/omdaa-whatsapp',
enabled: true,
events: ['message', 'message.received', 'session'],
});
await client.webhooks.test();
`
TypeScript / ESM:
`typescript
import { OmdaaClient } from '@omdaafreeapi/omdaa-api-client';
const client = new OmdaaClient({ apiKey: process.env.OMDAA_API_KEY! });
await client.webhooks.set({
url: 'https://omdaa.com/n8n/webhook/omdaa-whatsapp',
enabled: true,
events: ['message.received'],
});
`
Or via CLI (from the Omdaa main repo):
`bash
N8N_WEBHOOK_URL=https://omdaa.com/n8n/webhook/omdaa-whatsapp \
OMDAA_API_KEY=your-key \
node backend/scripts/setup-n8n-webhook.js
`
Other SDKs (same Free Forever API):
Step 3: Enable Omdaa AI (3 min)
1. Open Dashboard → Omdaa AI
2. Select your WhatsApp session
3. Create a bot → enable Use Omdaa AI
4. Set a system prompt, e.g.:
`
You are a helpful support agent for Omdaa API. Reply in the user's language. Keep answers under 3 sentences.
`
Unlimited AI replies are included in Free Forever.
Step 4: Extend n8n (3 min)
After the Normalize Omdaa Payload node, add:
Zapier alternative: see integrations/zapier/omdaa-whatsapp-google-sheets.template.json or the Zapier MCP article.
Optional: Cursor MCP (same API, agent-native)
Prefer agents over dashboards? Install the free Cursor MCP WhatsApp plugin (v2.3.0 · 109 tools — sessions, inbox, groups, bulk, webhooks, Omdaa Mail, integrations):
1. Open Cursor Directory → omdaa-api → Add to Cursor
2. Set OMDAA_API_KEY (or Authorization: Bearer … in MCP headers)
3. Use tools like set_webhook, list_sessions, send_text_message, upsert_openai_bot
Catalog: MCP tools docs · Endpoint: https://omdaa.com/api/v1/mcp
Step 5: Test end-to-end
1. Send a WhatsApp message to your connected number
2. Check n8n execution history — webhook should fire
3. Verify Omdaa AI auto-reply in WhatsApp
4. Confirm Google Sheets row (if configured)
Troubleshooting
Next in this series
1. Build a WhatsApp Bot in 5 Minutes
2. Free Forever Migration Guide
3. Omdaa AI + n8n ← you are here
4. Zapier MCP + WhatsApp → Google Sheets
Resources
@omdaafreeapi/omdaa-api-client`
Omdaa API — Free Forever. Automate WhatsApp with AI, n8n, and Cursor MCP today.