Quickstart

Five steps to your first WhatsApp message via the official Meta API.

1. Register a tenant

Create an account in the dashboard (app.wapedia.id). If public signup is still closed, request early access. Start with Sandbox to test with a Meta test number, or choose a paid plan for production.

2. Connect WhatsApp

In the dashboard → Settings → connect your WABA via Meta Embedded Signup. Save the phone_number_id shown after the number is active.

3. Get an API key

In Settings, copy your tenant API key (shown once when created/rotated). Header:

Authorization: Bearer <API_KEY>

4. Send a text message

curl

curl -X POST "https://api.wapedia.id/v1/messages" \
  -H "Authorization: Bearer $WAPEDIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "6281234567890",
    "type": "text",
    "body": "Halo dari Wapedia",
    "phone_number_id": "YOUR_PHONE_NUMBER_ID"
  }'

TypeScript SDK

import { Wapedia } from "@wapedia/sdk";

const client = new Wapedia({ apiKey: process.env.WAPEDIA_API_KEY! });
await client.messages.sendText({
  to: "6281234567890",
  body: "Halo dari Wapedia",
  phoneNumberId: "YOUR_PHONE_NUMBER_ID",
});

See the TypeScript SDK for templates, media, usage, and webhook helpers.

A successful response is usually 202 Accepted with an outbound id and status: queued.

5. Webhook (optional but recommended)

Point Meta's webhook URL to the Wapedia endpoint (see Webhooks). To forward events to your system, set webhook_forward_url (public HTTPS only) in tenant settings.

Billing tips

• Wapedia bills the plan subscription (Midtrans). WhatsApp conversations are billed by Meta to your WABA.
• Plan fair-use caps sending through the platform. Used up → upgrade (FAIR_USE_ENFORCE).
• Messaging W-Coin debit is off in the current Tech Provider model (MESSAGING_WALLET_ENABLED=false).
• From 1 Oct 2026, Meta bills Cloud API service messages (utility list rate, 1,000 free/number/month) and in-window utility templates. Invoice is in WhatsApp Manager.