Lewati ke konten utama
Kembali ke topik

Panduan Developer

WhatsApp API MauKirim: OTP, Notifikasi, dan Pesan dari Aplikasi Anda

WhatsApp API MauKirim adalah REST API untuk mengirim kode OTP, notifikasi bertemplat, dan pesan dari nomor WhatsApp sewaan, tanpa menjalankan infrastruktur WhatsApp sendiri. Halaman ini menjelaskan cara kerjanya dari sisi developer.

01

Autentikasi dengan API key ber-scope

Semua permintaan dikirim ke https://app.maukirim.com/api/v1 dengan header Authorization: Bearer yang berisi API key. Key dibuat di dashboard, pada menu Developer lalu API keys, dan nilainya hanya ditampilkan satu kali.

Setiap key memiliki scope: read, otp, notification, send, device, dan webhook. Beri tiap layanan hanya scope yang dibutuhkannya.

02

Mengirim dan memverifikasi OTP

POST /otp/send meminta kode untuk satu nomor dan satu tujuan: login, pendaftaran, pembayaran, reset kata sandi, atau ganti nomor telepon. MauKirim membuat kode enam digit, hanya menyimpan hash-nya, dan mengirimkannya lewat WhatsApp. POST /otp/verify memeriksa kode yang diketik pengguna.

Kode berlaku lima menit dan bisa dicoba paling banyak lima kali. Kode yang salah bukan error: responsnya tetap 200 dengan verified bernilai false. Penerbitan kode dibatasi lima kali per jam untuk tiap nomor tujuan.

03

Notifikasi bertemplat

Notifikasi terikat pada template yang lebih dulu disetujui untuk akun Anda. Setiap pengiriman lewat POST /messages/send menyebut ID template dan mengisi variabelnya. Nama dan jumlah variabel harus sama persis dengan yang ada di template.

Template dengan blok berulang, misalnya daftar barang dalam pesanan, tetap menjadi satu pesan dan satu tagihan. Template yang disetujui membawa lampiran bisa menyertakan berkas pada tiap pengiriman, seperti faktur PDF. Berkas yang diunggah kedaluwarsa setelah tujuh hari.

04

Pesan bebas dan media dari nomor sewaan

Dari nomor yang Anda sewa, POST /devices/{id}/messages mengirim teks bebas, gambar dengan keterangan, atau dokumen. Dokumen tiba dengan nama berkas yang Anda kirim. Jalur ini dipakai ketika isi pesan bergantung pada apa yang ditulis pelanggan.

Sewa yang sudah dibayar belum berarti nomornya siap: nomor baru bisa mengirim setelah statusnya terhubung dan sudah login. Lewat API yang sama Anda juga bisa mengatur nama dan foto profil nomor.

05

Webhook untuk pesan masuk dan tanda terima

Atur satu URL untuk tiap nomor guna menerima peristiwa seperti pesan masuk (message) dan tanda terima pesan (message.ack). Setiap kiriman ditandatangani dengan HMAC-SHA256. Verifikasi tanda tangannya pada body mentah, sebelum JSON di-parse.

MauKirim mencoba ulang sampai lima kali dengan jeda, dan tiap percobaan menunggu paling lama 10 detik. Kiriman yang sama bisa tiba lebih dari sekali, jadi simpan delivery_id untuk membuang duplikat.

06

Idempotensi dan kode error

Setiap permintaan kirim wajib membawa kunci idempotensi. Mengulang permintaan yang sama dengan kunci yang sama tidak mengirim pesan kedua. Memakai kunci yang sama dengan isi berbeda ditolak dengan status 409.

Setiap error membawa kode yang bisa dibaca program, misalnya insufficient_credits (402) saat saldo kurang, device_not_connected (409) saat nomor belum siap, dan rate_limited (429) saat batas OTP terlampaui.

07

SDK resmi dan MCP

SDK berlisensi MIT tersedia untuk Node.js dan TypeScript (npm install maukirim), PHP (composer require maukirim/sdk), dan Go (go get github.com/MauKirim/sdk-go), ditambah community node untuk n8n. Semuanya mencakup OTP, notifikasi bertemplat, operasi nomor sewaan, dan verifikasi tanda tangan webhook.

Asisten AI yang mendukung MCP dapat terhubung ke akun Anda melalui server MCP MauKirim, dengan izin sesuai scope API key yang Anda berikan.

Siap Menerapkan WhatsApp Gateway untuk Bisnis Anda?

Mulai tanpa beban menyediakan kartu SIM sendiri. Tim MauKirim di bawah naungan PT Cipta Dua Saudara siap mendiskusikan integrasi sistem Anda.

Pertanyaan yang sering muncul

Bahasa pemrograman apa saja yang didukung?

API ini memakai HTTP dan JSON, jadi bisa dipanggil dari bahasa apa pun. SDK resmi tersedia untuk Node.js, PHP, dan Go, serta community node untuk n8n.

Bagaimana cara mulai mencoba API ini?

Buat akun di app.maukirim.com, buat API key pada menu Developer lalu API keys, kemudian ikuti dokumentasi API di dashboard.

Apakah pesan terkirim dua kali jika permintaan saya diulang?

Tidak, selama kunci idempotensinya sama. Permintaan ulang dengan kunci dan isi yang sama dianggap permintaan yang sama.

Apakah saya bisa menerima balasan pelanggan?

Ya. Pasang webhook pada nomor sewaan Anda untuk menerima pesan masuk dan tanda terima pesan di server Anda.

Topik terkait

api whatsappapi otp whatsappwebhook whatsappsdk whatsapp api
Lihat harga

Mulai dengan MauKirim

Chat masuk. Tim tinggal closing.

Buat akun untuk menyambungkan WhatsApp, Instagram, atau Facebook, lalu coba CRM dan API-nya.

Buat akun MauKirim