צמתי Trigger
צמתי trigger הם נקודות הכניסה של כל workflow. הם מגדירים איזה אירוע מפעיל את ההרצה. לכל workflow חייב להיות בדיוק trigger אחד.
trigger.inbound_message
נקודת כניסה להודעות WhatsApp נכנסות.
זהו צומת ה-trigger המרכזי לשימוש ב-production. כאשר לקוח שולח הודעת WhatsApp למספר המחובר שלכם, הצומת מופעל ומעביר את נתוני ההודעה לתוך ה-workflow.
קונפיגורציה
אין צורך בהגדרות. הצומת מוגדר אוטומטית כאשר מוסיפים אותו לקנבס.
Outputs
צומת ה-trigger מעביר את הנתונים הבאים לצמתים המחוברים:
| Output | Type | Description |
|---|
message.text | string | תוכן הטקסט של ההודעה הנכנסת |
message.type | string | סוג ההודעה, כמו text, image, document וכו’ |
contact | object | רשומת ה-contact של השולח, כולל שם, טלפון, תגיות ושדות מותאמים |
conversation | object | הקשר השיחה הפעיל, כולל מזהה, סטטוס והיסטוריה |
timestamp | string | חותמת זמן בפורמט ISO 8601 של ההודעה הנכנסת |
Connections
- Inputs: אין, זהו צומת הכניסה
- Outputs: ידית יציאה אחת שמתחברת לצומת הבא בזרימה
דוגמת שימוש
כל workflow שפונה ללקוחות מתחיל בצומת הזה. כאשר לקוח שולח “Hi, I need help with my order”, ה-trigger לוכד את ההודעה ומעביר אותה לצומת AI Router או AI Respond להמשך עיבוד.
trigger.manual_test
Trigger לבדיקה מקדימה בתוך הבונה.
הצומת הזה מיועד רק לבדיקה מתוך workflow builder, בלי לשלוח הודעות WhatsApp אמיתיות. הוא מדמה הודעה נכנסת באמצעות נתוני בדיקה שאתם מגדירים.
קונפיגורציה
| Option | Type | Required | Description |
|---|
testMessage | string | Yes | טקסט ההודעה המדומה שיישלח דרך ה-workflow |
Outputs
אותו מבנה outputs כמו trigger.inbound_message, כך שהלוגיקה של ה-workflow פועלת אותו דבר בשני המצבים.
| Output | Type | Description |
|---|
message.text | string | טקסט הודעת הבדיקה שהגדרתם |
contact | object | רשומת contact מדומה |
conversation | object | הקשר conversation מדומה |
Connections
- Inputs: אין, זהו צומת הכניסה
- Outputs: ידית יציאה אחת שמתחברת לצומת הבא בזרימה
דוגמת שימוש
כאשר בונים workflow לתמיכת לקוחות, אפשר להשתמש בצומת הזה כדי לבדוק איך AI Respond מטפל בסוגי הודעות שונים, כמו שאלות, תלונות או ברכות, מבלי לשלוח הודעות אמיתיות ב-WhatsApp. לפני פרסום, מחליפים חזרה ל-trigger.inbound_message.
הצומת trigger.manual_test מיועד לבדיקה בתוך הבונה בלבד. workflows שפורסמו משתמשים תמיד ב-trigger.inbound_message כנקודת הכניסה שלהם.