SendLocation#
השיטה מכוונת לשליחת הודעת מיקום. ההודעה תתווסף לתור השליחה. אין צורך במכשיר מקושר בעת השליחה. ההודעות יישמרו 24 שעות בתור עד לאישור המופע קצב שליחת ההודעות מהתור מנוהל על ידי עיכוב בשליחת הודעה פָּרָמֶטֶר.
בַּקָשָׁה#
כדי לשלוח הודעת מיקום, עליך לבצע בקשה בכתובת:
לפרמטרים של בקשת apiUrl
, idInstance
ו-apiTokenInstance
, עיין ב לפני שמתחילים סָעִיף.
בקש פרמטרים#
פָּרָמֶטֶר | סוּג | הֶכְרֵחִי | תֵאוּר |
---|---|---|---|
chatId | string | כֵּן | זיהוי צ'אט |
nameLocation | string | לֹא | שם המיקום |
address | string | לֹא | כתובת המיקום |
latitude | double | כֵּן | קו רוחב מיקום |
longitude | double | כֵּן | קו אורך מיקום |
quotedMessageId | string | לֹא | מזהה הודעה מצוטטת, אם קיימת ההודעה תישלח בציטוט הודעת הצ'אט שצוינה |
בקשת גוף לדוגמה#
שליחת הודעה לצ'אט אישי:
{
"chatId": "11001234567@c.us",
"nameLocation": "Restaurant",
"address": "123456, Perm",
"latitude": 12.3456789,
"longitude": 10.1112131
}
שליחת הודעה לצ'אט קבוצתי:
{
"chatId": "11001234567-1581234048@g.us",
"nameLocation": "Restaurant",
"address": "123456, Perm",
"latitude": 12.3456789,
"longitude": 10.1112131
}
שליחת הודעות מצוטטות:
{
"chatId": "11001234567@c.us",
"nameLocation": "Restaurant",
"address": "123456, Perm",
"latitude": 12.3456789,
"longitude": 10.1112131,
"quotedMessageId": "361B0E63F2FDF95903B6A9C9A102F34B"
}
תְגוּבָה#
פרמטרי תגובה#
פָּרָמֶטֶר | סוּג | תֵאוּר |
---|---|---|
idMessage | string | מזהה הודעה יוצאת |
גוף לדוגמא תגובה#
{
"idMessage": "3EB0C767D097B7C7C030"
}
SendLocation errors#
לרשימה של שגיאות משותפות לכל השיטות, עיין ב שגיאות נפוצות סָעִיף
בקש דוגמאות#
import requests
url = "{{apiUrl}}/waInstance{{idInstance}}/sendLocation/{{apiTokenInstance}}"
payload = {
"chatId": "11001234567@c.us",
"nameLocation": "I'm here",
"address": "613123, Perm",
"latitude": 44.9370129,
"longitude": 89.8728409
}
headers = {
'Content-Type': 'application/json'
}
response = requests.post(url, json=payload, headers=headers)
print(response.text.encode('utf8'))
curl --location '{{apiUrl}}/waInstance{{idInstance}}/sendLocation/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"chatId": "12345678910@c.us",
"nameLocation": "Я здесь, приезжай",
"address": "613123, Perm",
"latitude": 44.9370129,
"longitude": 89.8728409
}'
var restTemplate = new RestTemplate();
var requestUrl = new StringBuilder();
requestUrl
.append({{apiUrl}})
.append("/waInstance").append({{idInstance}})
.append("/sendLocation/")
.append({{apiTokenInstance}});
var headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
var jsonBody = "{\r\n \"chatId\": \"11001234567@c.us\",\r\n \"nameLocation\": \"Я здесь, приезжай\",\r\n \"address\": \"613123, Perm\",\r\n \t\"latitude\": 44.9370129,\r\n \"longitude\": 89.8728409\r\n}\r\n";
var requestEntity = new HttpEntity<>(jsonBody, headers);
var response = restTemplate.exchange(requestUrl.toString(), HttpMethod.POST, requestEntity, String.class);
System.out.println(response);
var requestUrl = new StringBuilder();
requestUrl
.append({{apiUrl}})
.append("/waInstance").append({{idInstance}})
.append("/sendLocation/")
.append({{apiTokenInstance}});
var response = Unirest.post(requestUrl.toString())
.header("Content-Type", "application/json")
.body("{\r\n \"chatId\": \"11001234567@c.us\",\r\n \"nameLocation\": \"Я здесь, приезжай\",\r\n \"address\": \"613123, Perm\",\r\n \t\"latitude\": 44.9370129,\r\n \"longitude\": 89.8728409\r\n}\r\n")
.asString();
System.out.println(response);
Sub SendLocation()
Dim url As String
Dim RequestBody As String
Dim http As Object
Dim response As String
' The apiUrl, idInstance and apiTokenInstance values are available in console, double brackets must be removed
url = "{{apiUrl}}/waInstance{{idInstance}}/sendLocation/{{apiTokenInstance}}"
' chatId - chat identifier, nameLocation - location name, address - location address, latitude - location latitude, longitude - location longitude
RequestBody = "{""chatId"":""71234567890@c.us"",""nameLocation"":""Restaurant"",""address"":""123456, Perm"",""latitude"":12.3456789,""longitude"": 10.1112131}"
Set http = CreateObject("MSXML2.XMLHTTP")
With http
.Open "POST", url, False
.setRequestHeader "Content-Type", "application/json"
.send RequestBody
End With
response = http.responseText
Debug.Print response
' Outputting the answer to the desired cell
Range("A1").Value = response
Set http = Nothing
End Sub