Dashboard Utama

Create Template (Official WABA)

Gunakan endpoint ini untuk mendaftarkan template pesan baru langsung ke Meta WhatsApp Business API (Official WABA). Setelah berhasil dibuat, template akan masuk ke proses peninjauan oleh Meta sebelum dapat digunakan.

Endpoint API

hljs http
POST https://api.bablast.id/waba/templates

Headers

HeaderValueDeskripsi
AuthorizationBearer bk_live_...Global API Key Anda (wajib untuk nomor bertipe WABA)
Content-Typeapplication/jsonFormat payload request

Payload Parameter (JSON)

FieldTipeWajibDeskripsi
nameStringYaNama template (hanya huruf kecil, angka, dan underscore. Contoh: order_status_update).
categoryStringYaKategori template: MARKETING, UTILITY, atau AUTHENTICATION.
languageStringYaKode bahasa template (contoh: id untuk Indonesia, en untuk Inggris).
parameter_formatStringTidakFormat variabel: POSITIONAL (menggunakan {{1}}, {{2}}) atau NAMED (menggunakan {{name}}, {{code}}). Default: POSITIONAL.
componentsArrayYaDaftar komponen template seperti HEADER, BODY, FOOTER, dan BUTTONS.

Detail Struktur components

Meta membagi template menjadi beberapa blok komponen:

1. Komponen BODY (Teks Utama)

Komponen wajib yang berisi teks utama pesan Anda beserta variabelnya.

hljs json
{
  "type": "BODY",
  "text": "Halo {{1}}, terima kasih telah berbelanja. Nomor pesanan Anda adalah {{2}}."
}

2. Komponen HEADER (Opsional)

Dapat berupa Teks Utama tebal di bagian atas, atau Media (Gambar, Video, Dokumen).

  • Contoh Header Teks:
    hljs json
    {
  "type": "HEADER",
  "format": "TEXT",
  "text": "Konfirmasi Pembayaran"
}
  • Contoh Header Media (Gambar): Sertakan URL contoh gambar pada field header_handle untuk memandu proses peninjauan Meta.
    hljs json
    {
  "type": "HEADER",
  "format": "IMAGE",
  "example": {
    "header_handle": ["https://example.com/sample-image.jpg"]
  }
}

3. Komponen FOOTER (Opsional)

Teks kecil berwarna abu-abu di bagian bawah pesan.

hljs json
{
  "type": "FOOTER",
  "text": "Pesan ini dikirim otomatis oleh BaBlast."
}

4. Komponen BUTTONS (Opsional)

Tombol interaktif seperti Quick Reply (balasan cepat) atau Call to Action (link website/telepon).

hljs json
{
  "type": "BUTTONS",
  "buttons": [
    {
      "type": "QUICK_REPLY",
      "text": "Hubungi CS"
    },
    {
      "type": "URL",
      "text": "Buka Website",
      "url": "https://bablast.id"
    }
  ]
}

Contoh Request Pembuatan Template

Berikut adalah contoh lengkap pembuatan template transaksi sederhana dengan variabel POSITIONAL:

hljs bash
curl -X POST https://api.bablast.id/waba/templates \
  -H "Authorization: Bearer bk_live_YOUR_GLOBAL_WABA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "payment_invoice_utility",
    "category": "UTILITY",
    "language": "id",
    "parameter_format": "POSITIONAL",
    "components": [
      {
        "type": "HEADER",
        "format": "TEXT",
        "text": "Tagihan Pembayaran"
      },
      {
        "type": "BODY",
        "text": "Halo {{1}}, tagihan sebesar {{2}} telah terbit. Silakan bayar sebelum tanggal {{3}}."
      },
      {
        "type": "FOOTER",
        "text": "Terima kasih atas kepercayaan Anda."
      },
      {
        "type": "BUTTONS",
        "buttons": [
          {
            "type": "URL",
            "text": "Bayar Sekarang",
            "url": "https://bablast.id/pay"
          }
        ]
      }
    ]
  }'

Struktur Respons (201 Created)

hljs json
{
  "status": true,
  "message": "Developer WABA template created successfully",
  "data": {
    "id": "1049283402834012",
    "status": "PENDING",
    "category": "UTILITY"
  }
}

Setelah berhasil dibuat, status template akan berupa PENDING. Meta membutuhkan waktu sekitar 1 menit hingga beberapa jam untuk menyetujui template tersebut. Anda dapat memantau status persetujuannya di Meta Business Manager.