DEV Community

Cover image for Omdaa AI + n8n in 10 Minutes — Free Forever Automation
Omdaa API
Omdaa API

Posted on Edited on Originally published at omdaa.com

Omdaa AI + n8n in 10 Minutes — Free Forever Automation

#ai #n8n #whatsapp #tutorial

Omdaa AI + n8n in 10 Minutes — Free Forever Automation

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 

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

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
Enter fullscreen mode Exit fullscreen mode

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+):

npm install @omdaafreeapi/omdaa-api-client
Enter fullscreen mode Exit fullscreen mode 
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();
Enter fullscreen mode Exit fullscreen mode

TypeScript / ESM:

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'],
});
Enter fullscreen mode Exit fullscreen mode

Or via CLI (from the Omdaa main repo):

N8N_WEBHOOK_URL=https://omdaa.com/n8n/webhook/omdaa-whatsapp \
OMDAA_API_KEY=your-key \
node backend/scripts/setup-n8n-webhook.js
Enter fullscreen mode Exit fullscreen mode

Other SDKs (same Free Forever API):

Language Install
Python pip install omdaa
PHP composer require omdaapi/omdaa-php
Laravel composer require omdaapi/omdaa-laravel

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.
Enter fullscreen mode Exit fullscreen mode

Unlimited AI replies are included in Free Forever.

Step 4: Extend n8n (3 min)

After the Normalize Omdaa Payload node, add:

Node Purpose
IF Filter event contains message
Google Sheets Log from, text, timestamp
HTTP Request Forward to your CRM
Slack Notify your team

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

Issue Fix
Webhook 404 Ensure n8n workflow is active
No AI reply Check Omdaa AI bot is enabled for session
Empty payload Use events: ['message.received']
Cannot find module 'omdaa-api-client' Use scoped package @omdaafreeapi/omdaa-api-client
Signature verify fails Check X-Webhook-Signature: sha256=<hmac> over raw body

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

Omdaa API — Free Forever. Automate WhatsApp with AI, n8n, and Cursor MCP today.

Top comments (0)