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{
"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
}
}'पूर्ण संरचना 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-प्रबंधित नंबर नहीं।
सीमाएँ
| फ़ील्ड | सीमा | लागू करने वाला |
|---|---|---|
| latitude | आवश्यक, -90 से 90, दशमलव अंश | Bird, स्वीकृति पर (422) |
| longitude | आवश्यक, -180 से 180, दशमलव अंश | Bird, स्वीकृति पर (422) |
| name | वैकल्पिक, अधिकतम 1,000 अक्षर | Bird, स्वीकृति पर (422) |
| address | वैकल्पिक, अधिकतम 1,000 अक्षर, केवल name सेट होने पर दिखता है | Bird, स्वीकृति पर (422) |
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 मॉडल, और सुरक्षित फिर से प्रयास
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।
गाइड देखेंConnecting WhatsApp to Bird: from buying a number to a live channelकॉन्सेप्ट समझेंWhat is the 24-hour customer service window on WhatsApp?टूल का उपयोग करेंWhatsApp message builderक्षमता जानेंWhatsApp
अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ