Mengirim Pesan Lokasi (Location)

Endpoint ini digunakan untuk mengirimkan koordinat lokasi geografis berupa peta interaktif (Google Maps/Apple Maps preview) ke aplikasi WhatsApp pelanggan. Format pesan lokasi ini sangat berguna untuk membagikan alamat kantor/toko, titik pertemuan, atau memandu kurir dalam pengiriman barang.

🛜 1. HTTP Endpoint

• Opsi A (Default): POST /v1/messages (Routing otomatis menggunakan saluran aktif pertama)
• Opsi B (Spesifik): POST /v1/:phone_number_id/messages (Routing melalui nomor tertentu)

Headers:

• Authorization: Bearer <API_KEY>
• Content-Type: application/json

📦 2. Payload Request (JSON)

Sertakan objek location dengan menentukan koordinat garis bujur (longitude) dan garis lintang (latitude).

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "62812345678",
  "type": "location",
  "location": {
    "longitude": 106.827153,
    "latitude": -6.175392,
    "name": "Monumen Nasional",
    "address": "Gambir, Kota Jakarta Pusat, DKI Jakarta"
  }
}

Penjelasan Parameter:

• type (String - Wajib): Set nilai ke "location".
• location.longitude (Float - Wajib): Titik koordinat garis bujur lokasi (misal: 106.827153).
• location.latitude (Float - Wajib): Titik koordinat garis lintang lokasi (misal: -6.175392).
• location.name (String - Opsional): Nama tempat atau gedung lokasi yang akan ditebalkan (misal: "Monumen Nasional").
• location.address (String - Opsional): Keterangan alamat lengkap lokasi yang akan ditampilkan di bawah nama tempat (misal: "Gambir, Kota Jakarta Pusat, DKI Jakarta").

🚦 3. Format Respons API

Respons Sukses (201 Created)

{
  "status": 201,
  "message": "Message sent successfully",
  "data": {
    "messaging_product": "whatsapp",
    "contacts": [{"input": "62812345678", "wa_id": "62812345678"}],
    "messages": [{"id": "wamid.HBgLNjI4MTIzNDU2NzhGFgQ0NDMzMzc3RUQ1OEFG"}]
  }
}

• messages[0].id: ID pesan unik untuk memantau status pengantaran via webhook.
• Ketika pelanggan mengetuk balon pesan lokasi ini di ponsel mereka, aplikasi WhatsApp akan langsung membuka pratinjau peta terintegrasi dengan opsi navigasi petunjuk arah (GPS).