SendTemplateButtons#

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

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

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

בקשה#

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

POST

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

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

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

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

פרמטרי בקשה#

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

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

פרמטר	הקלד	תיאור
`index`	integer	זיהוי לחצן
`urlButton`	object	כפתור כתובת אתר
`callButton`	object	כפתור שיחה
`quickReplyButton`	object	כפתור רגיל

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

פרמטר	הקלד	תיאור
`displayText`	string	טקסט קישור
`url`	string	קישור אינטרנט

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

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

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

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

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

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

{
 "idMessage": "3EB0C767D097B7C7C030"
}

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

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

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

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

שגיאות SendTemplateButtons#

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

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

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

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

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

בחרו פעולה:

1 - פעולה 1

2 - פעולה 2

3 - פעולה 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"}}
        ]
}'
```