Quickstart

Send your first WhatsApp message with Msgera in under five minutes.

This guide walks you through getting an API key, picking a connected device, sending a text message, and configuring inbound webhooks.

Prerequisites

A Msgera account with at least one connected WhatsApp device. New here? Connect a device from the dashboard first — the device's deviceUidis what you'll send messages through.

1. Get your API key

Open the dashboard, go to Settings → API keys, and create a new key. Keys start with the wak_ prefix. Store it as an environment variable.

export MSGERA_KEY="wak_••••••••••••••••••••••••••••••••"

2. Pick a device

List your connected devices and copy a deviceUid.

curl https://api.msgera.com/v1/developer/devices \
  -H "X-API-Key: $MSGERA_KEY"

3. Send your first message

Make a POST request to /v1/developer/messages/send with the device, recipient, and message text.

curl -X POST https://api.msgera.com/v1/developer/messages/send \
  -H "X-API-Key: $MSGERA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deviceUid": "dev_4f8c2a1e",
    "to": "+201001234567",
    "text": "Hello from Msgera"
  }'

Request body

Field	Type	Description
`deviceUid`required	`string`	UID of the device that should send the message.
`to`required	`string`	Recipient phone number, matching ^\+?[0-9]{7,15}$.
`text`required	`string`	Message body (min 1 character). Supports spintax.

Plan limits apply

Each plan has its own daily send and rate limits. See Messaging limits for the details.

4. Listen for inbound webhooks

Configure personal and group webhook URLs via the dashboard or PUT /v1/developer/webhooks. Msgera will POST the inbound message payload to your endpoint every time a customer replies. See Webhooks and Webhook events for the payload shape.