Kirim Pesan WhatsApp

Kirim pesan teks, media, lokasi, audio, dan video lewat API whatsGo.

Endpoint ini memungkinkan kamu mengirim berbagai tipe pesan WhatsApp — teks, gambar, audio, video, dokumen, lokasi, template, dan pesan interaktif — dari sistem kamu ke nomor WhatsApp tujuan.

Endpoint

POST /external-api/inbox/send-messageCopy

Base URL: https://whats.sahabatmobile.com

Header yang dibutuhkan

Body Request — Field Umum

Setiap request harus mengirim JSON body. Berikut field yang berlaku untuk semua tipe pesan.

Tipe Pesan

Field tambahan di body request bergantung pada nilai type. Berikut masing-masing tipe beserta contohnya.

Teks

Mengirim pesan teks biasa. Bisa menyertakan link dan preview URL jika preview_url diaktifkan.

Contoh request:

curl -X POST "https://whats.sahabatmobile.com/external-api/inbox/send-message" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "6281234567890",
    "type": "text",
    "text": {
      "body": "Halo! Pesan ini dikirim lewat API whatsGo.",
      "preview_url": true
    }
  }'Copy

Gambar

Mengirim gambar (JPG, PNG) beserta caption opsional.

Contoh request:

curl -X POST "https://whats.sahabatmobile.com/external-api/inbox/send-message" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "6281234567890",
    "type": "image",
    "image": {
      "link": "https://example.com/images/promo.jpg",
      "caption": "Promo spesial hari ini!"
    }
  }'Copy

Audio

Mengirim file audio (MP3, OGG, AMR).

Contoh request:

curl -X POST "https://whats.sahabatmobile.com/external-api/inbox/send-message" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "6281234567890",
    "type": "audio",
    "audio": {
      "link": "https://example.com/audio/voice-note.mp3"
    }
  }'Copy

Video

Mengirim file video beserta caption opsional.

Contoh request:

curl -X POST "https://whats.sahabatmobile.com/external-api/inbox/send-message" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "6281234567890",
    "type": "video",
    "video": {
      "link": "https://example.com/video/product-demo.mp4",
      "caption": "Ini video demo produk kami."
    }
  }'Copy

Dokumen

Mengirim file dokumen beserta caption dan nama file.

Contoh request:

curl -X POST "https://whats.sahabatmobile.com/external-api/inbox/send-message" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "6281234567890",
    "type": "document",
    "document": {
      "link": "https://example.com/files/invoice-2026-06.pdf",
      "caption": "Invoice bulan Juni 2026.",
      "filename": "invoice-2026-06.pdf"
    }
  }'Copy

Lokasi

Mengirim koordinat lokasi beserta nama dan alamat opsional.

Contoh request:

curl -X POST "https://whats.sahabatmobile.com/external-api/inbox/send-message" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "6281234567890",
    "type": "location",
    "location": {
      "latitude": -6.2088,
      "longitude": 106.8456,
      "name": "Kantor Pusat Sahabat Mobile",
      "address": "Jl. Sudirman No. 123, Jakarta"
    }
  }'Copy

Multi-Channel

Jika workspace kamu memiliki lebih dari satu saluran WhatsApp terhubung, tentukan channel_id untuk memilih saluran pengirim. Jika hanya ada satu saluran, field ini bersifat opsional — sistem akan menggunakan saluran default secara otomatis.

Untuk mengetahui daftar saluran yang tersedia, gunakan endpoint List Kontak atau lihat di dashboard pada menu Pengaturan > Saluran.

{
  "to": "6281234567890",
  "type": "text",
  "channel_id": "ch_abc123def456",
  "text": {
    "body": "Pesan ini dikirim dari saluran tertentu."
  }
}Copy

Response

Semua response mengikuti format envelope standar whatsGo.

Response sukses

{
  "success": true,
  "message": "Pesan berhasil dikirim.",
  "data": {
    "messageId": "msg_7a8b9c0d1e2f",
    "whatsappMessageId": "wamid.HBgLMjgxMjM0NTY3ODkw",
    "to": "6281234567890",
    "type": "text",
    "channelId": "ch_abc123def456",
    "status": "sent",
    "createdAt": "2026-07-16T10:30:00.000000Z"
  }
}Copy

Field response

Response error

{
  "success": false,
  "error": {
    "code": "VALIDATION_INVALID_PHONE",
    "message": "Format nomor telepon tidak valid.",
    "details": {
      "field": "to",
      "hint": "Gunakan format kode negara + nomor tanpa tanda plus (contoh: 628123456789)."
    }
  }
}Copy

Pesan Error

Berikut daftar error yang mungkin terjadi saat mengirim pesan WhatsApp.