API חדש — שידור תבנית WhatsApp לפי תגים ולפי מזהי משתמשים
שתי נקודות קצה חדשות של Sending API מאפשרות שידור תבניות הודעות WhatsApp באופן פרוגרמטי לקבוצות ספציפיות של מנויים — באמצעות מיקוד לרשימת מזהי משתמשים ישירות או באמצעות מיקוד למנויים עם תגים ספציפיים.
נקודות קצה חדשות
שיטהנקודת קצהתיאורPOST | /subscriber/broadcast-whatsapp-template-by-user-id | שידור תבנית WhatsApp לרשימה ספציפית של מזהי משתמשים
POST | /subscriber/broadcast-whatsapp-template-by-tag | שידור תבנית WhatsApp לכל המנויים עם תגים תואמים
POST | /subscriber/broadcast-whatsapp-template-by-tag | שידור תבנית WhatsApp לכל המנויים עם תגים תואמים
תיעוד API מלא:
גוף הבקשה — שידור לפי מזהי משתמשים
{
"user_id_list": "61412345678,61387625429,61245638917",
"wa_template": {
"namespace": "string",
"name": "string",
"lang": "string",
"use_default_values": "yes",
"params": {
"HEADER_IMAGE": "https://example.com/image.png",
"BODY_{{1}}": "text",
"BODY_{{2}}": "text",
"QUICK_REPLY_1": "sub flow ns",
"URL_1": "https://example.com/url"
}
},
"scheduled_time": 1786123679,
"max_per_minute": 60
}
גוף הבקשה — שידור לפי תגים
{
"tags": ["f123t456"],
"exclude_tags": ["f123t568"],
"wa_template": {
"namespace": "string",
"name": "string",
"lang": "string",
"use_default_values": "yes",
"params": {
"HEADER_IMAGE": "https://example.com/image.png",
"BODY_{{1}}": "text",
"QUICK_REPLY_1": "sub flow ns",
"URL_1": "https://example.com/url"
}
},
"scheduled_time": 1786123679,
"max_per_minute": 60
}
פרמטרים עיקריים
פרמטרתיאורuser_id_list | רשימת מזהי משתמשים מנויים מופרדים בפסיקים (נקודת קצה by-user-id)
tags / exclude_tags | מערך של מזהי תגים לכלילה/החרגה (נקודת קצה by-tag)
wa_template.namespace / name / lang | מזהי תבנית — ניתן למצוא אותם דרך /api/whatsapp-template/list
use_default_values | יש להגדיר ל-"yes" לשימוש בברירות המחדל של התבנית, או לספק פרמטרים מותאמים אישית
scheduled_time | חותמת זמן Unix למשלוח מתוזמן (אופציונלי)
max_per_minute | מגבלת קצב לשליחה (ברירת מחדל: 60 לדקה)
tags / exclude_tags | מערך של מזהי תגים לכלילה/החרגה (נקודת קצה by-tag)
wa_template.namespace / name / lang | מזהי תבנית — ניתן למצוא אותם דרך /api/whatsapp-template/list
use_default_values | יש להגדיר ל-"yes" לשימוש בברירות המחדל של התבנית, או לספק פרמטרים מותאמים אישית
scheduled_time | חותמת זמן Unix למשלוח מתוזמן (אופציונלי)
max_per_minute | מגבלת קצב לשליחה (ברירת מחדל: 60 לדקה)
הרשאה נדרשת
Manage Flow
למה זה חשוב
- מאפשר קמפיינים פרוגרמטיים מלאים של תבניות WhatsApp ממערכות חיצוניות (מערכות CRM, פלטפורמות מסחר אלקטרוני, אוטומציות n8n)
- מיקוד מבוסס תגים מאפשר בחירת קהל דינמית ללא קידוד קשיח של מזהי משתמשים
- תמיכה ב-exclude_tags מונעת משלוחים כפולים למשתמשים שצריך להחריג
- משלוח מתוזמן ומגבלת קצב הופכים את התהליך לבטוח לפעולות שידור בקנה מידה גדול
👉 מיקום: תיעוד API ← Sending ← broadcast-whatsapp-template-by-user-id / broadcast-whatsapp-template-by-tag תאריך פרסום: 24 במרץ 2026 בשעה 6:28 בבוקר