WhatsApp लोकेशन मैसेज

लोकेशन मैसेज एक पिन भेजता है: मैप पर एक बिंदु, जिसके नीचे वैकल्पिक नाम और पता होता है। यह पेज भेजने के बारे में है। अगर आप किसी संपर्क से उसकी लोकेशन साझा करने को कहना चाहते हैं, तो लोकेशन अनुरोध देखें।

लोकेशन भेजें

location.latitude और 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

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
      }
    }'

पूरे स्वरूप में name और address भी जुड़ते हैं:

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

address प्राप्तकर्ता को तभी दिखता है जब name भी सेट हो। हर सर्विस मैसेज पर from ज़रूरी है: यह ऐसा नंबर होना चाहिए जो आपके वर्कस्पेस का हो, Bird द्वारा प्रबंधित नंबर नहीं।

सीमाएँ

WhatsApp के अपने दस्तावेज़ latitude और longitude को अनिवार्य बताते हैं, लेकिन कोई संख्यात्मक सीमा नहीं बताते। ±90/±180 की सीमा जाँच और name तथा address पर 1,000 अक्षरों की सीमा Bird की अपनी सीमाएँ हैं।

आने वाली लोकेशन पढ़ना

जब कोई संपर्क अपनी लोकेशन शेयर करता है, चाहे खुद से या लोकेशन अनुरोध के जवाब में, तो एक सामान्य आने वाला location संदेश बनता है। इसमें कुछ भी निश्चित नहीं होता: एक साधारण पिन बिना name और बिना address के भी आ सकता है। आने वाली लोकेशन में उस जगह से जुड़ा url भी हो सकता है, जो आपकी भेजी लोकेशन में कभी नहीं होता। लोकेशन कोई मीडिया प्रकार नहीं है, इसलिए कोई फ़ाइल डाउनलोड नहीं करनी होती। आने वाली लोकेशन को पूरी तरह पढ़ने, whatsapp.received पेलोड और ध्यान रखने वाली बातों के लिए WhatsApp लोकेशन प्राप्त करना देखें।

सीमाएँ और विशेष स्थितियाँ

• ग्राहक सेवा विंडो खुली होनी चाहिए। लोकेशन भेजना एक सेवा संदेश है, जो केवल खुली विंडो के भीतर डिलीवर हो सकता है; हब का ग्राहक सेवा विंडो पेज देखें।
• पढ़ते समय name और address सच में वैकल्पिक हैं, इनका कोई डिफ़ॉल्ट मान नहीं होता। साधारण पिन में दोनों में से कोई नहीं होता, और address कभी भी name के बिना नहीं आता। यह न मानें कि निर्देशांकों के साथ हमेशा सड़क का पता भी आएगा।
• यह लोकेशन अनुरोध वाला प्रकार नहीं है। लोकेशन अनुरोध एक इंटरैक्टिव प्रकार है, जो प्राप्तकर्ता से उसकी लोकेशन माँगता है; यह पेज उन्हें लोकेशन भेजता है। भेजने के इन दोनों रूपों को एक न समझें।
• लोकेशन अनुरोध पर टैप करने पर एक सामान्य आने वाला location संदेश लौटता है, interactive_reply नहीं। जो इंटीग्रेशन टैप के लिए केवल interactive_reply पर नज़र रखता है, उससे यह पूरी तरह छूट जाता है; उसे आने वाले location पर भी नज़र रखनी होगी।

अगले कदम

• WhatsApp सेवा संदेश: ग्राहक सेवा विंडो और वह मॉडल जो हर सेवा संदेश पर लागू होता है
• लोकेशन अनुरोध: लोकेशन भेजने के बजाय किसी संपर्क से उसकी लोकेशन माँगें
• WhatsApp संदेश भेजना: अनुरोध का ढांचा, 202 मॉडल, और सुरक्षित रूप से फिर से प्रयास करना