Skip to content

SendButtons#

שימו לב! השיטה אינה זמינה זמנית

קריאה לשיטה זו תחזיר שגיאת 403.

כדי לשלוח כפתורים, השתמשו בשיטה SendInteractiveButtons או SendInteractiveButtonsReply כדי לשלוח כפתורים לוואטסאפ מ-GREEN-API.

השיטה מיועדת לשליחת הודעת כפתור לצ'אט אישי או קבוצתי. ההודעה תתווסף לתור השליחה. ההודעה תישמר 24 שעות בתור ותשלח מיד לאחר אישור טלפוני. קצב שליחת ההודעות מהתור מנוהל על ידי פרמטר עיכוב שליחת הודעות.

בקשה#

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

POST 
{{apiUrl}}/waInstance{{idInstance}}/sendButtons/{{apiTokenInstance}}

לפרמטרים של בקשת apiUrl, idInstance ו-apiTokenInstance, עיין בסעיף לפני שמתחילים.

תכונות בעבודה עם כפתורים#

  • אורך כותרת הלחצן עשוי להיות עד 25 תווים;
  • לא יכולים להיות יותר מ-3 כפתורים מסוג זה;
  • ניתן לבחור את הכפתור פעם אחת בלבד.

פרמטרי בקשה#

פרמטר הקלד חובה תֵאוּר
chatId **string* כן צ'אט מזהה
הודעה **string* כן טקסט הודעה. דמויות Emoji 😃 נתמכות
תחתונה **string* לא כותרת תחתונה של הודעה. שימושי להדגשה ויזואלית של טקסט הקשור ללחצנים.
כפתורים array כן כפתורי הודעה
quotedMessageId **string* לא מזהה הודעה מצוטט. אם קיימת, ההודעה תישלח בציטוט הודעת הצ'אט שצוינה

פרמטרים של מערך 'לחצנים'

פרמטר הקלד תיאור
buttonId **string* מזהה לחצן
buttonText **string* טקסט לחצן

האורך המרבי של הודעת טקסט הוא 4096 תווים

דוגמה לגוף הבקשה#

שליחת הודעה לצ'אט אישי: 

{
    "chatId": "11001234567@c.us",
    "message": "Hello",
    "footer": "Please choose the color:",
    "buttons": [
        {
            "buttonId": "1",
            "buttonText": "green"
        },
        {
            "buttonId": "2",
            "buttonText": "red"
        },
        {
            "buttonId": "3",
            "buttonText": "blue"
        }
    ]
}

Response#

Response parameters#

Parameter Type Description
idMessage string Sent message Id

Response body example#

{
    "idMessage": "3EB0C767D097B7C7C030"
}

Recipient display example#

Пример отображения кнопок

שגיאות SendButtons#

רשימת השגיאות המשותפות לכל השיטות מופיעה בסעיף שגיאות נפוצות

שגיאות אפשריות

בעת שימוש בשיטה SendButtons, ייתכן שההודעות לא יוצגו בגרסת האינטרנט, בגרסת שולחן העבודה ובגרסה לנייד של האפליקציה. את האפשרות לשלוח הודעות עם כפתורים מימשנו באופן עצמאי: לקוח WhatsApp Web הרשמי אינו מספק אפשרות זו. יציבות השיטה SendButtons אינה תלויה בנו במידה רבה: WhatsApp מבצעת שינויים באופן קבוע.

אנו ממליצים תמיד לשכפל את הכפתורים באמצעות הודעות רגילות.

לדוגמה, השתמשו במספרים לבחירת אפשרות.

בחרו פעולה:

1 - פעולה 1

2 - פעולה 2

3 - פעולה 3

curl example#

curl --location --request POST '{{apiUrl}}/waInstance{{idInstance}}/sendButtons/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chatId": "11001234567@c.us",
    "message": "Please choose the color:",
    "buttons": [{"buttonId": "1", "buttonText": "green"}, {"buttonId": "2", "buttonText": "red"}, {"buttonId": "3", "buttonText": "blue"}]
}'