SendTemplateButtons#

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

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

בקשה#

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

פוסט

{{apiUrl}}/waInstance{{idInstance}}/sendTemplateButtons/{{apiTokenInstance}}

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

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

לחצני url תואמים לחצני מספרי טלפון, אך לא ללחצני תשובה;
כפתורי מספרי טלפון кнопки תואמים לחצני url, אך לא ללחצני תשובה;
כפתורי תשובה מהירה אינם תואמים לחצני מספרי טלפון ולחצני url.

פרמטרי בקשה#

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

פרמטרי מערך 'templateButtons'

פרמטר	הקלד	תיאור
`אינדקס`	מספר שלם	זיהוי לחצן
`urlButton`	חפץ	כפתור כתובת אתר
`כפתור שיחה`	חפץ	כפתור שיחה
`quickReplyButton`	חפץ	כפתור רגיל

פרמטרי אובייקט urlButton

פרמטר	הקלד	תיאור
`displayText`	מחרוזת	טקסט קישור
`כתובת אתר`	מחרוזת	קישור אינטרנט

פרמטרי אובייקט 'callButton'

פרמטר	הקלד	תיאור
`displayText`	מחרוזת	טקסט קישור
`מספר טלפון`	מחרוזת	מספר טלפון

פרמטרי אובייקט quickReplyButton

פרמטר	הקלד	תיאור
`displayText`	מחרוזת	טקסט לחצן
`מזהה`	מחרוזת	מזהה לחצן

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

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

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

{
  "chatId": "11001234567@c.us",
  "message": "שלום",
 "footer": "איזה סוג פעולה תבחר?",
 "templateButtons": [
 {"index": 1, "urlButton": {"displayText": "⭐ סמן אותנו ב-GitHub!", "url": "https://github.com/green-api"}},
 {"index": 2, "callButton": {"displayText": "התקשר אלינו", "phoneNumber": "+1 (234) 5678-901"}},
 {"index": 3, "quickReplyButton": {"displayText": "Plain button", "id": "plainButtonId"}}
 ]
}

תגובה#

פרמטרי תגובה#

פרמטר	הקלד	תיאור
`idMessage`	מחרוזת	זיהוי הודעה נשלחה

דוגמה לגוף התגובה#

{
 "idMessage": "3EB0C767D097B7C7C030"
}

דוגמה לתצוגה של הנמען#

כפתור התקשרות חזרה דוגמה להצגת כפתורים

כפתור כתובת אתר דוגמה להצגת כפתורים

כפתור תשובה מהירה דוגמה להצגת כפתורים

שגיאות SendMessage#

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

טעויות אפשריות

When using the SendTemplateButtons 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 SendTemplateButtons 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}}/sendTemplateButtons/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chatId": "11001234567@c.us",
    "message": "Hello",
    "footer": "What kind of action will you choose?",
    "templateButtons": [
            {"index": 1, "urlButton": {"displayText": "⭐ Star us on GitHub!", "url": "https://github.com/green-api"}},
            {"index": 2, "callButton": {"displayText": "Call us", "phoneNumber": "+1 (234) 5678-901"}},
            {"index": 3, "quickReplyButton": {"displayText": "Plain button", "id": "plainButtonId"}}
        ]
}'
```