GetContactInfo#
השיטה מכוונת לקבלת מידע על איש קשר.
בַּקָשָׁה#
כדי לקבל מידע ליצירת קשר, עליך לבצע בקשה בכתובת:
לפרמטרים של בקשת apiUrl
, idInstance
ו-apiTokenInstance
, עיין ב לפני שמתחילים סָעִיף.
בקש פרמטרים#
פָּרָמֶטֶר | סוּג | הֶכְרֵחִי | תֵאוּר |
---|---|---|---|
chatId | string | כֵּן | Correspondent id |
בקשת גוף לדוגמה#
{
"chatId": "71234567890@c.us"
}
תְגוּבָה#
פרמטרי תגובה#
פָּרָמֶטֶר | סוּג | תֵאוּר |
---|---|---|
avatar | string | כתובת ה-avatar |
name | string | שם איש הקשר |
1) אם יש תכתובות/תגובות נכנסות מהחשבון, אז אנחנו מקבלים את השם מפרופיל WhatsApp | ||
2) אם אין תכתובות/תגובות נכנסות מהחשבון, אז נקבל שורה ריקה | ||
contactName | string | שם איש הקשר מתוך ספר הטלפונים |
1) אם המספר נשמר באנשי קשר, אנו מקבלים את השם מספר אנשי הקשר; | ||
2) אם המספר לא נשמר בספר אנשי הקשר או נמחק ממנו, נקבל שורה ריקה. | ||
email | string | דואר אלקטרוני ליצירת קשר |
category | string | קטגוריית אנשי קשר לעסקים |
description | string | תיאור איש קשר עסקי |
products | object | כרטיסי מוצרים ליצירת קשר |
chatId | string | Correspondent ID |
lastSeen | string | זמן הסטטוס המקוון האחרון |
isArchive | boolean | סטטוס ארכיון צ'אט, מקבל ערכי אמת/שקר |
isDisappearing | boolean | סטטוס צ'אט נעלם, נכון/לא נכון |
isMute | boolean | סטטוס התראות צ'אט, נכון/לא נכון |
messageexpiration | integer | זמן לחיות עבור הודעות צ'אט, תוך שניות |
muteexpiration | integer | הזמן שאחריו יופעלו התראות צ'אט |
isBusiness | boolean | הדגל המציין אם איש הקשר משתמש ב-WhatsApp Business, מקבל ערכי אמת/שקר |
products
פרמטרים של אובייקט
פָּרָמֶטֶר | סוּג | תֵאוּר |
---|---|---|
id | string | מזהה מוצר |
imageUrls | object | כתובות אתרים של תמונות מוצר |
availability | string | זמינות המוצר |
reviewStatus | object | סטטוס סקירת מוצר |
name | string | שם המוצר |
description | string | תיאור המוצר |
price | string | מחיר המוצר |
isHidden | boolean | מצב המוצר |
imageUrls
פרמטרים של אובייקט
פָּרָמֶטֶר | סוּג | תֵאוּר |
---|---|---|
requested | string | קישור לתמונת המוצר ברזולוציה נמוכה (תצוגה מקדימה) |
original | string | קישור לתמונת המוצר ברזולוציה גבוהה (מקורי) |
reviewStatus
פרמטרים של אובייקט
פָּרָמֶטֶר | סוּג | תֵאוּר |
---|---|---|
whatsapp | string | המוצר אושר על ידי WhatsApp |
גוף לדוגמא תגובה#
{
"avatar": "https://pps.whatsapp.net/v/t61.24694-24/24_1349471992200940_2091838963901201896_n.jpg?ccb=11-4&oh=01_AVzZilQn10nj9M9cfQV4PW5dgdXOkiOuD_jCqP2MCXIpyA",
"name": "Dealer",
"contactName": "Dealer",
"email": "24service@tt.tt",
"category": "Automotive Dealership",
"description": "Official service",
"products": [
{
"id": "42079728159",
"imageUrls": {
"requested": "https://mmg.whatsapp.net/v/t45.5328-4/263329037_6625110154227932_2879714823340281709_n.jpg?stp=dst-jpg_p100x100&ccb=1-7&_nc_sid=c48759&_nc_ohc=NKICbZlqfPMAX9077mo&_nc_ad=z-m&_nc_cid=0&_nc_ht=mmg.whatsapp.net&oh=01_AVwYzx7CckCFf8F8xIIZ5m2AGdeC8YTnLyd29",
"original": "https://mmg.whatsapp.net/v/t45.5328-4/263329037_6625110154227932_2879714823340281709_n.jpg?ccb=1-7&_nc_sid=c48759&_nc_ohc=NKICbZlqfPMAX9077mo&_nc_ad=z-m&_nc_cid=0&_nc_ht=mmg.whatsapp.net&oh=01_AVzn_O9azpKNRs1iPId0TQkGYk4D7HZFSQMeobvRiR"
},
"reviewStatus": {
"whatsapp": "APPROVED"
},
"availability": "in stock",
"name": "Replacement",
"description": "From 1000 RUB",
"price": null,
"isHidden": false
},
{
"id": "3545870328871389",
"imageUrls": {
"requested": "https://mmg.whatsapp.net/v/t45.5328-4/261250418_4513761695371199_1710541959703469822_n.jpg?stp=dst-jpg_p100x100&ccb=1-7&_nc_sid=c48759&_nc_ohc=eps8lAw2_3MAX_mWW8K&_nc_ad=z-m&_nc_cid=0&_nc_ht=mmg.whatsapp.net&oh=01_AVxT3HnbR04qKZJSOeK4d8p-noZokqly9QbpYFK-c_8kSA&oe",
"original": "https://mmg.whatsapp.net/v/t45.5328-4/261250418_4513761695371199_1710541959703469822_n.jpg?ccb=1-7&_nc_sid=c48759&_nc_ohc=eps8lAw2_3MAX_mWW8K&_nc_ad=z-m&_nc_cid=0&_nc_ht=mmg.whatsapp.net&oh=01_AVx2wTCmzof0BoZDmIUpD328CtpJmlvEXGdVzew&o"
},
"reviewStatus": {
"whatsapp": "APPROVED"
},
"availability": "in stock",
"name": "Technical maintenance",
"price": null,
"isHidden": false
}
],
"chatId": "71234567890@c.us",
"lastSeen": null,
"isArchive": false,
"isDisappearing": false,
"isMute": false,
"messageExpiration": 0,
"muteExpiration": null,
"isBusiness": true
}
Note
When the method requests information about a group chat, the response will receive status code 200 with a null body
GetContactInfo שגיאות{#errors}#
לרשימה של שגיאות משותפות לכל השיטות, עיין ב שגיאות נפוצות סָעִיף
בקש דוגמאות#
import requests
url = "{{apiUrl}}/waInstance{{idInstance}}/getContactInfo/{{apiTokenInstance}}"
payload = {"chatId": "71234567890@c.us"}
headers = {
'Content-Type': 'application/json'
}
response = requests.request("GET", url, headers=headers, data = payload)
print(response.text.encode('utf8'))
curl --location '{{apiUrl}}/waInstance{{idInstance}}/getContactInfo/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"chatId": "71234567890@c.us"
}'
var restTemplate = new RestTemplate();
var requestUrl = new StringBuilder();
requestUrl
.append({{apiUrl}})
.append("/waInstance").append({{idInstance}})
.append("/getContactInfo/")
.append({{apiTokenInstance}});
var headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
var jsonBody = "{\"chatId\": \"71234567890@c.us\"}";
var requestEntity = new HttpEntity<>(jsonBody, headers);
var response = restTemplate.exchange(requestUrl.toString(), HttpMethod.GET, requestEntity, String.class);
System.out.println(response);
var requestUrl = new StringBuilder();
requestUrl
.append({{apiUrl}})
.append("/waInstance").append({{idInstance}})
.append("/getContactInfo/")
.append({{apiTokenInstance}});
var response = Unirest.post(requestUrl.toString())
.header("Content-Type", "application/json")
.body("{\"chatId\": \"71234567890@c.us\"}")
.asString();
System.out.println(response);
Sub GetContactInfo()
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}}/GetContactInfo/{{apiTokenInstance}}"
' chatId - is the number to send the message to (@c.us for private chats, @g.us for group chats)
RequestBody = "{""chatId"":""71234567890@c.us""}"
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