Referensi API

Base path: /v1. Spesifikasi mesin: OpenAPI 3 (juga GET https://api.wapedia.id/v1/openapi.json).

Versi spek: 1.0.0.

Messages

POST /v1/messages

Kirim teks, template, atau media (setelah upload).

Header: Authorization: Bearer <API_KEY>

Body contoh (teks):

{
  "to": "6281234567890",
  "type": "text",
  "body": "Halo",
  "phone_number_id": "1234567890"
}

GET /v1/messages/:id

Status outbound (queued / sending / sent / failed + delivery).

GET /v1/messages/inbound · GET /v1/messages/outbound

List pesan dengan pagination limit / offset.

Media

POST /v1/media

Upload multipart (file + mime_type). Maksimal 16 MB.

POST /v1/media/resumable

Upload resumable (Meta handle) untuk file yang didukung.

Langganan & usage

• GET /v1/subscription · GET /v1/usage — status paket dan fair-use
• Endpoint GET /v1/wallet* / top-up Midtrans untuk messaging tidak dipakai di model Tech Provider saat ini (MESSAGING_WALLET_ENABLED=false). Schema tetap ada untuk era nanti; jangan andalkan untuk billing pesan.

Lainnya (ringkas)

Inbox: conversations, agents, contacts, chatbot rules, templates, analytics — lihat OpenAPI lengkap dan README backend untuk daftar penuh.

Idempotensi & antrian

Outbound masuk antrian worker; cek status dengan GET /v1/messages/:id. Jangan asumsikan kirim sinkron ke Meta selesai pada respons 202.