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 मॉडल, और सुरक्षित फिर से प्रयास