Multichat WhatsApp HTTP API

Pengenalan

Multichat API memungkinkan Anda mengirim & menerima pesan WhatsApp secara otomatis. Cocok untuk notifikasi OTP, customer support, marketing blast, integrasi CRM/CMS, dan chatbot.

Autentikasi

Setiap request membutuhkan token dan instance_id yang Anda peroleh dari dashboard Multichat setelah scan QR.

Contoh Header / Query

GET /api/v1/send-text?token=YOUR_TOKEN&instance_id=YOUR_INSTANCE_ID&jid=[email protected]&msg=Halo
Host: app.multichat.id

Base URL

Semua endpoint relative terhadap base URL di atas. JID format WhatsApp: [email protected] untuk personal, [email protected] untuk grup.

Format Response

Semua endpoint mengembalikan JSON dengan struktur konsisten:

{
  "success": true,
  "message": "Message sent successfully!",
  "response": "<DATA>"
}

{
  "success": false,
  "message": "<REASON>"
}

Kode Error Umum

Kirim Pesan Teks

Mengirim pesan teks biasa ke nomor atau grup WhatsApp.

Parameter

Contoh Request

curl -G "https://app.multichat.id/api/v1/send-text" \
  --data-urlencode "token=YOUR_TOKEN" \
  --data-urlencode "instance_id=YOUR_ID" \
  --data-urlencode "[email protected]" \
  --data-urlencode "msg=Halo dari Multichat 👋"

const res = await fetch("https://app.multichat.id/api/v1/send-text?" +
  new URLSearchParams({
    token: "YOUR_TOKEN",
    instance_id: "YOUR_ID",
    jid: "[email protected]",
    msg: "Halo dari Multichat 👋"
  }));
const data = await res.json();
console.log(data);

<?php
$params = http_build_query([
  'token'       => 'YOUR_TOKEN',
  'instance_id' => 'YOUR_ID',
  'jid'         => '[email protected]',
  'msg'         => 'Halo dari Multichat',
]);
$response = file_get_contents("https://app.multichat.id/api/v1/send-text?$params");
echo $response;

import requests
r = requests.get("https://app.multichat.id/api/v1/send-text", params={
    "token": "YOUR_TOKEN",
    "instance_id": "YOUR_ID",
    "jid": "[email protected]",
    "msg": "Halo dari Multichat"
})
print(r.json())

Kirim Gambar

Mengirim gambar dari URL dengan caption opsional. Format: jpg, png, webp. Max 16 MB.

Parameter

GET https://app.multichat.id/api/v1/send-image?token=TOKEN&instance_id=ID&jid=[email protected]&imageurl=https://example.com/foto.jpg&caption=Promo!

Kirim Video

Mengirim video dari URL. Format: mp4, 3gp. Max 16 MB. Caption opsional.

GET https://app.multichat.id/api/v1/send-video?token=TOKEN&instance_id=ID&jid=JID&videourl=https://example.com/video.mp4&caption=Demo

Kirim Dokumen

Mengirim file dokumen (PDF, DOCX, XLSX, ZIP, dll). Max 100 MB.

GET https://app.multichat.id/api/v1/send-doc?token=TOKEN&instance_id=ID&jid=JID&docurl=https://example.com/file.pdf&caption=Invoice.pdf

Kirim Audio / Voice Note

Mengirim audio dari URL. Format: mp3, ogg, wav. Set ptt=true untuk voice note.

Kirim Sticker

Format: webp 512×512. Max 500 KB.

Kirim Lokasi

Kirim Kontak (vCard)

Pesan Tombol Interaktif

Pesan dengan tombol balasan cepat. Max 3 tombol per pesan.

Body (JSON)

{
  "token": "YOUR_TOKEN",
  "instance_id": "YOUR_ID",
  "jid": "[email protected]",
  "text": "Pilih layanan kami:",
  "footer": "Multichat.id",
  "buttons": [
    {"id":"1", "text":"Beli Sekarang"},
    {"id":"2", "text":"Tanya Admin"},
    {"id":"3", "text":"Lihat Katalog"}
  ]
}

Pesan List

Menu list berstruktur dengan section & rows.

{
  "token": "YOUR_TOKEN",
  "instance_id": "YOUR_ID",
  "jid": "[email protected]",
  "title": "Menu Hari Ini",
  "text": "Silakan pilih:",
  "buttonText": "Lihat Menu",
  "sections": [
    {
      "title": "Makanan",
      "rows": [
        {"title":"Nasi Goreng", "description":"Spesial", "rowId":"m1"},
        {"title":"Mie Ayam", "rowId":"m2"}
      ]
    }
  ]
}

Pesan Polling

Buat polling dengan beberapa pilihan jawaban.

{
  "token": "YOUR_TOKEN",
  "instance_id": "YOUR_ID",
  "jid": "[email protected]",
  "name": "Tempat meeting?",
  "options": ["Kantor", "Cafe", "Online"],
  "selectableCount": 1
}

Link dengan Preview

Buat Grup

{
  "token": "YOUR_TOKEN",
  "instance_id": "YOUR_ID",
  "name": "Tim Marketing",
  "participants": ["[email protected]", "[email protected]"]
}

Info Grup

Tambah Anggota Grup

{
  "token": "YOUR_TOKEN",
  "instance_id": "YOUR_ID",
  "group_id": "[email protected]",
  "participants": ["[email protected]"]
}

Keluar Grup

Cek Nomor WhatsApp

Validasi apakah suatu nomor terdaftar di WhatsApp.

{
  "success": true,
  "exists": true,
  "jid": "[email protected]"
}

Status Instance

Get QR Code

Mendapatkan QR Code base64 untuk pairing instance baru.

Logout Instance

Reboot Instance

Setting Webhook

Atur URL webhook untuk menerima pesan masuk & event status secara real-time.

{
  "token": "YOUR_TOKEN",
  "instance_id": "YOUR_ID",
  "webhook_url": "https://yourapp.com/webhook",
  "events": ["message", "status", "presence"]
}

Payload Webhook

{
  "event": "message",
  "instance_id": "YOUR_ID",
  "data": {
    "from": "[email protected]",
    "type": "text",
    "body": "Halo admin",
    "timestamp": 1735689600
  }
}

Postman Collection

Import koleksi Postman lengkap kami untuk mencoba semua endpoint dengan satu klik.

Quick Start — 3 Langkah

• 1. Daftar di order.multichat.id — dapatkan token & instance_id.
• 2. Scan QR di dashboard untuk koneksikan WhatsApp Anda.
• 3. Kirim request pertama Anda ke endpoint /send-text 🎉