WhatsApp is where your customers already are. In this tutorial you will send your first message and set up webhooks using Omdaa API — a developer-friendly WhatsApp Business platform that is free forever.

Also on DEV Community.

Why Omdaa?

Free Forever — Pro Max, unlimited sessions & messages, no credit card
Official SDKs: Node.js, Python, PHP, Go, Laravel
Instant Webhooks
Omdaa AI auto-replies built-in
n8n & Zapier integration

Step 1: Create an account

Step 2: Install the SDK

npm install omdaa-api-client

Step 3: Get your API key

From the dashboard: Settings → API Keys → Create key. Copy it to your environment:

export OMDAA_API_KEY=your-api-key-here

Step 4: Connect a WhatsApp session

Open Dashboard → Sessions, create a session, and scan the QR code with WhatsApp on your phone. Note the sessionId (e.g. default).

Step 5: Send your first message

const { OmdaaClient } = require('omdaa-api-client');

const client = new OmdaaClient({
  apiKey: process.env.OMDAA_API_KEY,
});

async function main() {
  const res = await client.messages.sendText({
    sessionId: 'default',
    to: '201234567890', // country code + number, no +
    message: 'Hello from Omdaa API! 🚀',
  });
  console.log('Sent:', res.data?.messageId);
}

main().catch(console.error);

Step 6: Set up a webhook

await client.webhooks.set({
  url: 'https://yoursite.com/api/whatsapp-webhook',
  enabled: true,
});

const test = await client.webhooks.test();
console.log('Webhook test:', test);

Your endpoint receives JSON payloads for incoming messages, delivery status, and session events — build your bot logic there or use Omdaa AI for automatic replies without an external LLM key.

Step 7 (optional): Omdaa AI bot

Go to Dashboard → Omdaa AI, pick your session, create a bot, and enable Use Omdaa AI. Unlimited AI replies are included in Free Forever.

Next steps

Omdaa API — Free Forever. No paid plans. Start building today.

Build a WhatsApp Bot in 5 Minutes with Omdaa API