Pesan lokasi WhatsApp

Pesan lokasi mengirim pin: sebuah titik di peta, dengan nama dan alamat opsional di bawahnya. Halaman ini membahas sisi pengiriman; untuk meminta kontak membagikan lokasi mereka, lihat permintaan lokasi.

Kirim lokasi

Atur location.latitude dan location.longitude:

const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  location: { latitude: 37.7793, longitude: -122.4193 },
});
console.log(msg.id, msg.status);

msg = client.whatsapp.send(
    to="+16505551234",
    from_="+13124495648",
    location={"latitude": 37.7793, "longitude": -122.4193},
)
print(msg.id, msg.status)

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	bird "github.com/messagebird/bird-sdk-go"
	"github.com/messagebird/bird-sdk-go/option"
)

func main() {
	client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
	if err != nil {
		log.Fatal(err)
	}
	msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
		To:   "+16505551234",
		From: "+13124495648",
		Location: &bird.WhatsAppLocationSend{Latitude: 37.7793, Longitude: -122.4193},
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(msg.Id, *msg.Status)
}

$location = (new WhatsAppMessageSendRequestLocation())
    ->setLatitude(37.7793)
    ->setLongitude(-122.4193);
$message = $bird->whatsapp->send(
    to: '+16505551234',
    from: '+13124495648',
    location: $location,
);
echo $message->getId(), ' ', $message->getStatus();

bird whatsapp send \
  --from +13124495648 \
  --latitude 37.7793 \
  --longitude -122.4193 \
  --to +16505551234

{
  "name": "whatsapp_send",
  "arguments": {
    "from": "+13124495648",
    "location": {
      "latitude": 37.7793,
      "longitude": -122.4193
    },
    "to": "+16505551234"
  }
}

curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "to": "+16505551234",
      "from": "+13124495648",
      "location": {
        "latitude": 37.7793,
        "longitude": -122.4193
      }
    }'

Bentuk lengkapnya menambahkan name dan address:

Contoh kode

{
  "to": "+16505551234",
  "from": "+13124495648",
  "location": {
    "latitude": 37.7793,
    "longitude": -122.4193,
    "name": "Ferry Building Pickup",
    "address": "1 Market St, San Francisco, CA 94105"
  }
}

address hanya ditampilkan ke penerima jika name juga diisi. from wajib ada di setiap pesan layanan: nomor yang dimiliki workspace Anda, bukan nomor yang dikelola Bird.

Batas

Field	Batas	Diterapkan oleh
latitude	wajib, -90 sampai 90, derajat desimal	Bird, saat accept (422)
longitude	wajib, -180 sampai 180, derajat desimal	Bird, saat accept (422)
name	opsional, maksimal 1000 karakter	Bird, saat accept (422)
address	opsional, maksimal 1000 karakter, ditampilkan hanya jika name diisi	Bird, saat accept (422)

Dokumentasi WhatsApp sendiri mencantumkan latitude dan longitude sebagai wajib tanpa rentang numerik yang dinyatakan; pemeriksaan rentang ±90/±180 dan batas 1000 karakter pada name dan address adalah batasan milik Bird sendiri.

Membaca lokasi masuk

Kontak yang membagikan lokasinya, baik tanpa diminta maupun sebagai balasan atas permintaan lokasi, menghasilkan pesan location masuk biasa. Tidak ada yang dijamin: pin mentah bisa tiba tanpa name dan tanpa address sama sekali, dan lokasi masuk juga bisa membawa url yang menautkan ke tempat tersebut, yang tidak pernah muncul pada lokasi yang Anda kirim. Lokasi bukan tipe media, jadi tidak ada file yang perlu diambil. Lihat Menerima lokasi WhatsApp untuk pembacaan masuk secara lengkap, payload whatsapp.received, dan hal-hal yang perlu diperhatikan.

Batas dan kasus khusus

Jendela layanan pelanggan harus terbuka. Pengiriman lokasi adalah pesan layanan, hanya dapat dikirim di dalam jendela yang terbuka; lihat jendela layanan pelanggan di hub.
name dan address benar-benar opsional saat dibaca, bukan opsional-dengan-fallback. Pin mentah tidak memiliki keduanya, dan address tidak pernah muncul tanpa name. Jangan berasumsi bahwa alamat jalan selalu menyertai sepasang koordinat.
Ini bukan tipe yang sama dengan permintaan lokasi. Permintaan lokasi adalah tipe interaktif yang meminta lokasi penerima; halaman ini mengirim lokasi kepada mereka. Jangan mencampuradukkan dua bentuk pengiriman ini.
Ketukan pada permintaan lokasi kembali sebagai pesan location masuk biasa, bukan sebagai interactive_reply. Integrasi yang hanya memantau interactive_reply untuk ketukan akan melewatkan ini sepenuhnya; integrasi tersebut juga harus memantau location masuk.

Langkah selanjutnya

Pesan layanan WhatsApp: jendela layanan pelanggan dan model yang digunakan bersama oleh setiap pesan layanan
Permintaan lokasi: minta lokasi kontak alih-alih mengirim lokasi
Mengirim pesan WhatsApp: envelope permintaan, model 202, dan coba lagi yang aman

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Tonton panduannyaConnecting WhatsApp to Bird: from buying a number to a live channel Pahami konsepnyaWhat is the 24-hour customer service window on WhatsApp?Gunakan alatnyaWhatsApp message builder Jelajahi kemampuannyaWhatsApp

Coba praktiknya dan dapatkan ringkasan implementasi