Skip to content

SendButtons#

שים לב, בבקשה! השיטה לא עובדת באופן זמני

כאשר השיטה נקראת, תוחזר שגיאת 403.

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

בקשה#

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

פוסט 
{{apiUrl}}/waInstance{{idInstance}}/sendButtons/{{apiTokenInstance}}

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

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

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

פרמטרי בקשה#

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

פרמטרים של מערך 'לחצנים' | פרמטר | הקלד | תיאור | |-------------|-------------|----------------| | buttonId | מחרוזת | מזהה לחצן | | כפתורטקסט | מחרוזת | טקסט לחצן |

האורך המרבי של הודעת טקסט הוא 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#

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

SendMessage errors#

For a list of errors common to all methods, refer to Common errors section

Possible mistakes

When using the SendButtons method, messages may not be displayed on the web, desktop, and mobile versions of the application. The ability to send messages with buttons is implemented by us in a low-level way. The official WhatsApp-Web client does not provide the functionality of sending buttons. To a large extent, the stability of the SendButtons method does not depend on us, WhatsApp constantly makes changes to their work.

We recommend that you always duplicate buttons with regular messages.

For example, use numbers to define choices.

Choose an action:

1 - action 1

2 - action 2

3 - action 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"}]
}'