SendContact#
השיטה מכוונת לשליחת הודעת יצירת קשר. כרטיס ביקור ליצירת קשר נוצר ונשלח לצ'אט. ההודעה תתווסף לתור השליחה. אין צורך במכשיר מקושר בעת השליחה. ההודעות יישמרו 24 שעות בתור עד לאישור המופע קצב שליחת ההודעות מהתור מנוהל על ידי עיכוב בשליחת הודעה פָּרָמֶטֶר.
בַּקָשָׁה#
כדי לשלוח הודעת איש קשר, עליך לבצע בקשה בכתובת:
לפרמטרים של בקשת apiUrl
, idInstance
ו-apiTokenInstance
, עיין ב לפני שמתחילים סָעִיף.
בקש פרמטרים#
פָּרָמֶטֶר | סוּג | הֶכְרֵחִי | תֵאוּר |
---|---|---|---|
chatId | string | כֵּן | זיהוי צ'אט |
contact | object | כֵּן | אובייקט מגע |
quotedMessageId | string | לֹא | מזהה הודעה מצוטטת, אם קיימת ההודעה תישלח בציטוט הודעת הצ'אט שצוינה |
contact
פרמטרים של אובייקט:
פָּרָמֶטֶר | סוּג | הֶכְרֵחִי | תֵאוּר |
---|---|---|---|
phoneContact | integer | כֵּן | מספר טלפון ליצירת קשר בפורמט בינלאומי (ללא +) 11 או 12 ספרות |
firstName | string | אִם middleName , lastName , company לא צוין | שם איש הקשר |
middleName | string | אִם firstName , lastName , company לא צוין | שם אמצעי ליצירת קשר |
lastName | string | אִם middleName , firstName , company לא צוין | שם אמצעי ליצירת קשר |
company | string | אִם middleName , lastName , firstName לא צוין | צור קשר עם שם החברה |
בקשה דוגמה גוף#
שליחת הודעה לצ'אט אישי:
{
"chatId": "11001234567@c.us",
"contact": {
"phoneContact": 79001234568,
"firstName": "Artem",
"middleName": "Petrovich",
"lastName": "Evpatoriysky",
"company": "Bicycle"
}
}
שליחת הודעה לצ'אט קבוצתי:
{
"chatId": "11001234567-1581234048@g.us",
"contact": {
"phoneContact": 79001234568,
"firstName": "Artem",
"middleName": "Petrovich",
"lastName": "Evpatoriysky",
"company": "Bicycle"
}
}
שליחת הודעה מצוטטת:
{
"chatId": "11001234567@c.us",
"quotedMessageId": "361B0E63F2FDF95903B6A9C9A102F34B",
"contact": {
"phoneContact": 79001234568,
"firstName": "Artem",
"middleName": "Petrovich",
"lastName": "Evpatoriysky",
"company": "Bicycle"
}
}
תְגוּבָה#
פרמטרי תגובה#
פָּרָמֶטֶר | סוּג | תֵאוּר |
---|---|---|
idMessage | string | מזהה הודעה יוצאת |
גוף לדוגמא תגובה#
{
"idMessage": "3EB0C767D097B7C7C030"
}
שגיאות SendContact#
לרשימה של שגיאות משותפות לכל השיטות, עיין ב שגיאות נפוצות סָעִיף
בקש דוגמאות#
import requests
url = "{{apiUrl}}/waInstance{{idInstance}}/sendContact/{{apiTokenInstance}}"
payload = {
"chatId": "11001234567@c.us",
"contact": {
"phoneContact": "79001234568",
"firstName": "Artem",
"middleName": "Petrovich",
"lastName": "Evpatoriysky",
"company": "Bicycle"
}
}
headers = {
'Content-Type': 'application/json'
}
response = requests.post(url, json=payload, headers=headers)
print(response.text.encode('utf8'))
curl --location '{{apiUrl}}/waInstance{{idInstance}}/sendContact/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"chatId": "123456780910@c.us",
"contact": {
"phoneContact": 111111111111,
"firstName": "Артем",
"middleName": "Петрович",
"lastName": "Евпаторийский",
"company": "Велосипед"
}
}'
var restTemplate = new RestTemplate();
var requestUrl = new StringBuilder();
requestUrl
.append({{apiUrl}})
.append("/waInstance").append({{idInstance}})
.append("/sendContact/")
.append({{apiTokenInstance}});
var headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
var jsonBody = "{\r\n\t\"chatId\": \"11001234567@c.us\",\r\n\t\"contact\": {\r\n\t\t\"phoneContact\": 79001234568,\r\n \t\"firstName\": \"Артем\",\r\n\t\t\"middleName\": \"Петрович\",\r\n\t\t\"lastName\": \"Евпаторийский\",\r\n\t\t\"company\": \"Велосипед\"\r\n\t}\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("/sendContact/")
.append({{apiTokenInstance}});
var response = Unirest.post(requestUrl.toString())
.header("Content-Type", "application/json")
.body("{\r\n\t\"chatId\": \"11001234567@c.us\",\r\n\t\"contact\": {\r\n\t\t\"phoneContact\": 79001234568,\r\n \t\"firstName\": \"Артем\",\r\n\t\t\"middleName\": \"Петрович\",\r\n\t\t\"lastName\": \"Евпаторийский\",\r\n\t\t\"company\": \"Велосипед\"\r\n\t}\r\n}\r\n")
.asString();
System.out.println(response);
Sub SendContact()
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}}/sendContact/{{apiTokenInstance}}"
' chatId - chat identifier, phoneContact - contact phone number in international format (without +) 11 or 12 digits, firstName - contact name, middleName - contact's middle name, lastName - contact's last name, company - contact's company name
RequestBody = "{""chatId"":""71234567890@c.us"",""contact"":{""phoneContact"":70123456789,""firstName"":""Artyom"",""middleName"":""Petrovich"",""lastName"":""Evpatorsky"",""company"":""Bicycle""}}"
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