Loncat ke isi

Quickstart

Lima langkah ke pesan WhatsApp pertama lewat API resmi Meta.

1. Daftar tenant

Buat akun di dashboard (app.wapedia.id). Jika registrasi publik masih ditutup, minta early access. Mulai dari Sandbox untuk uji dengan nomor test Meta, atau pilih paket berbayar untuk produksi.

2. Hubungkan WhatsApp

Di dashboard → Settings → hubungkan WABA lewat Embedded Signup Meta. Simpan phone_number_id yang tampil setelah nomor aktif.

3. Ambil API key

Di Settings, salin API key tenant (ditampilkan sekali saat dibuat/rotate). Header:

Authorization: Bearer <API_KEY>

4. Kirim pesan teks

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",
});

Lihat TypeScript SDK untuk template, media, usage, dan helper webhook.

Respons sukses biasanya 202 Accepted dengan id outbound dan status: queued.

5. Webhook (opsional tapi disarankan)

Konfigurasi URL webhook Meta ke endpoint Wapedia (lihat Webhooks). Untuk forward ke sistem Anda, set webhook_forward_url (HTTPS publik saja) di settings tenant.

Tip billing

  • Wapedia menagih langganan paket (Midtrans). Percakapan WhatsApp ditagih Meta ke WABA Anda.
  • Kuota fair-use paket membatasi pengiriman lewat platform. Habis → naik paket (FAIR_USE_ENFORCE).
  • Debit messaging W-Coin tidak aktif di model Tech Provider saat ini (MESSAGING_WALLET_ENABLED=false).
  • Mulai 1 Okt 2026, Meta menagih pesan layanan Cloud API (tarif list sama utility, 1.000 gratis/nomor/bulan) dan template utility di jendela CS. Invoice di WhatsApp Manager.