SendTextStatus#
Beta version
The functionality is in beta mode. Features are subject to change and may also work unstably. There may be additional charges for functionality in the future.
השיטה מכוונת לשליחת סטטוס טקסט. הסטטוס יתווסף לתור. הסטטוס יישמר 24 שעות בתור עד לאישור המופע. הקצב שבו סטטוסים נשלחים מהתור מנוהל על ידי עיכוב בשליחת הודעה parameter.
Important
על מנת שהנמען יוכל לראות את סטטוסי השולח, על שני הצדדים לשמור את המספרים של בני השיח ברשימת אנשי הקשר
רשימת אנשי הקשר מאוחזרת באמצעות GetContacts שיטה המבוססת על השדה 'שם קשר'. כדי לקבל רשימת אנשי קשר מעודכנת, עליך לשנות את שם איש הקשר ולאשר מחדש על ידי סריקה מחדש של קוד ה-QR.
סטטוסים נשלחים רק ל-1024 אנשי הקשר הראשונים מה- GetContacts שיטה עם שדה 'שם קשר' חוקי.
בַּקָשָׁה#
כדי לשלוח סטטוס טקסט, עליך לבצע בקשה בכתובת:
For apiUrl
, idInstance
and apiTokenInstance
request parameters, refer to Before you start section.
בקש פרמטרים#
פָּרָמֶטֶר | סוּג | הֶכְרֵחִי | תֵאוּר |
---|---|---|---|
message | string | כֵּן | טקסט הודעה. דמויות Emoji 😃 נתמכות. דורש קידוד UTF-8 ללא BOM |
backgroundColor | string | לֹא | רקע הודעה. בְּרִירַת מֶחדָל: #FFFFFF . אתר לדוגמא לקבלת ערך צבע הרקע. חשוב! יש לשנות את צבע הרקע לכל דבר אחר מלבד לבן. טקסט הסטטוס מתפרסם בתווים לבנים. |
font | string | לֹא | גופן טקסט. מקבל ערכים: |
SERIF -כך ייראה הטקסט שלך | |||
SANS_SERIF - כך ייראה הטקסט שלך | |||
NORICAN_REGULAR -כך ייראה הטקסט שלך | |||
BRYNDAN_WRITE - כך ייראה הטקסט שלך | |||
OSWALD_HEAVY - כך ייראה הטקסט שלך | |||
participants | array | לֹא | מערך של מיתרים עםcontact IDs עבור מי הסטטוס יהיה זמין. אם ערך השדה ריק,"participants": [] , הסטטוס יהיה זמין לכל אנשי הקשר. |
האורך המרבי של הודעת טקסט הוא 500 תווים
אם יתווספו מספרים לא קיימים לשדה
משתתפים
, הסטטוס לא יישלח למספרים אלו
בקשת גוף לדוגמה#
שליחת סטטוס:
{
"message": "I use Green-API to send this Status!",
"backgroundColor": "#228B22", // (#FFFFFF) It is not recommended to use a white background
"font": "SERIF",
"participants": ["70000001234@c.us", "440000001234@c.us"] // status will be available only to the specified contacts
}
תְגוּבָה#
פרמטרי תגובה#
פָּרָמֶטֶר | סוּג | תֵאוּר |
---|---|---|
idMessage | string | מזהה הודעה שנשלחה |
גוף לדוגמא תגובה#
{
"idMessage": "3EB0C767D097B7C7C030"
}
SendTextStatus שגיאות#
לרשימה של שגיאות משותפות לכל השיטות, עיין ב שגיאות נפוצות סָעִיף
בקש דוגמאות#
import requests
import json
url = "{{apiUrl}}/waInstance{{idInstance}}/sendTextStatus/{{apiTokenInstance}}"
payload = json.dumps({
"message": "I use Green-API to send this Status!",
"backgroundColor": "#228B22",
"font": "SERIF",
"participants": [
"70000001234@c.us",
"440000001234@c.us"
]
})
headers = {
'Content-Type': 'application/json'
}
response = requests.post(url, json=payload)
print(response.text.encode('utf8'))
<?php
//The apiUrl, idInstance and apiTokenInstance values are available in console, double brackets must be removed
$url = '{{apiUrl}}/waInstance{{idInstance}}/sendTextStatus/{{apiTokenInstance}}';
//chatId is the number to send the message to (@c.us for private chats, @g.us for group chats)
$data = array(
"message": "I use Green-API to send this Status!",
"backgroundColor": "#228B22",
"font": "SERIF",
"participants": ["70000001234@c.us", "440000001234@c.us"]
);
$options = array(
'http' => array(
'header' => "Content-Type: application/json\r\n",
'method' => 'POST',
'content' => json_encode($data)
)
);
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
echo $response;
?>
curl --location '{{apiUrl}}/waInstance{{idInstance}}/sendTextStatus/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"message": "I use Green-API to send this Status!",
"backgroundColor": "#228B22",
"font": "SERIF",
"participants": ["70000001234@c.us", "440000001234@c.us"]
}'
var restTemplate = new RestTemplate();
var requestUrl = new StringBuilder();
requestUrl
.append({{apiUrl}})
.append("/waInstance").append({{idInstance}})
.append("/sendTextStatus/")
.append({{apiTokenInstance}});
var headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
var jsonBody = "{\r\n\t \"message\": \"I use Green-API to send this Status!\",\r\n\t \"backgroundColor\": \"#228B22\",\r\n\t \"font\": \"SERIF\",\r\n\t \"participants\": [\"70000001234@c.us\", \"440000001234@c.us\"]\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("/sendTextStatus/")
.append({{apiTokenInstance}});
var response = Unirest.post(requestUrl.toString())
.header("Content-Type", "application/json")
.body("{\r\n\t \"message\": \"I use Green-API to send this Status!\",\r\n\t \"backgroundColor\": \"#228B22\",\r\n\t \"font\": \"SERIF\",\r\n\t \"participants\": [\"70000001234@c.us\", \"440000001234@c.us\"]\r\n}")
.asString();
System.out.println(response);