Skip to content

SendTextStatus#

Test

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 שיטה עם שדה 'שם קשר' חוקי.

בַּקָשָׁה#

כדי לשלוח סטטוס טקסט, עליך לבצע בקשה בכתובת:

POST
{{apiUrl}}/waInstance{{idInstance}}/sendTextStatus/{{apiTokenInstance}}
TEST

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);