צמתי WhatsApp
צמתי WhatsApp מטפלים בתקשורת היוצאת עם לקוחות. הם שולחים הודעות, מפעילים תבניות ומעבירים שיחות לנציגים אנושיים.
wa.send_message
שליחת הודעת טקסט חופשית ללקוח.
הצומת הזה שולח הודעת טקסט בחזרה דרך WhatsApp. הוא תומך במשתנים דינמיים מתוך הקשר ה-workflow, כדי לאפשר התאמה אישית של המסר.
חלון 24 השעות: הצומת הזה פועל רק בתוך חלון שירות הלקוחות של 24 שעות, שנמדד מאז ההודעה הנכנסת האחרונה של הלקוח. אם החלון פג, זמן הריצה יחסום את השליחה וירשום שגיאה. במצב כזה צריך להשתמש ב-wa.send_template.
קונפיגורציה
| Option | Type | Required | Description |
|---|
body | string | Yes | טקסט ההודעה. תומך במשתני הקשר כמו {{contact.name}}, {{contact.phone}} וכל שדה מותאם אחר |
החלפת משתנים
השתמשו בסוגריים מסולסלים כפולים כדי להזריק ערכים דינמיים:
Hi {{contact.name}}, thanks for reaching out!
Your order {{conversation.fields.order_id}} is being processed.
{{contact.name}} — שם פרופיל ה-WhatsApp של הלקוח{{contact.phone}} — מספר הטלפון של הלקוח{{contact.fields.*}} — שדות מותאמים שנשמרו על ה-contact דרך state.set_field{{conversation.fields.*}} — שדות מותאמים שנשמרו על ה-conversation
Outputs
| Output | Type | Description |
|---|
messageId | string | מזהה הודעת WhatsApp שחזר מה-API |
status | string | סטטוס המסירה: sent, delivered, read, failed |
Connections
- Inputs: ידית כניסה אחת מהצומת הקודם, בדרך כלל
AI Respond
- Outputs: ידית יציאה אחת להמשך השרשרת
דוגמת שימוש
אחרי ש-AI Respond יוצר תשובת תמיכה, מחברים אותו ל-Send Message כדי למסור את התשובה ללקוח. גוף ההודעה יכול לכלול את הטקסט שה-AI יצר יחד עם פתיח מותאם אישית.
ל-WhatsApp יש מגבלה של 4,096 תווים לכל הודעה. אם ה-AI יוצר תשובה ארוכה יותר, Agentix תפצל אותה אוטומטית למספר הודעות, תחילה לפי פסקאות, אחר כך לפי משפטים ולבסוף לפי מילים.
wa.send_template
שליחת תבנית הודעת WhatsApp מאושרת מראש.
הודעות תבנית נדרשות כאשר צריך לשלוח הודעה יזומה לאחר שחלון 24 השעות פג. יש ליצור ולאשר את התבניות ב-Meta Business Suite לפני השימוש.
קונפיגורציה
| Option | Type | Required | Description |
|---|
templateName | string | Yes | השם המדויק של התבנית המאושרת ב-Meta |
templateLanguage | string | Yes | קוד השפה של התבנית, למשל en_US או he |
parameters | array | No | ערכי פרמטרים דינמיים למילוי placeholders |
parameters[].type | string | Yes | סוג הפרמטר: body, header, button |
parameters[].value | string | Yes | הערך שיוזרק לתבנית, כולל תמיכה במשתני הקשר |
Outputs
| Output | Type | Description |
|---|
messageId | string | מזהה הודעת WhatsApp שחזר מה-API |
status | string | סטטוס המסירה |
Connections
- Inputs: ידית כניסה אחת מהצומת הקודם
- Outputs: ידית יציאה אחת להמשך שרשור פעולות
דוגמת שימוש
אפשר לשלוח תבנית אישור הזמנה שעתיים אחרי רכישה: שם התבנית order_confirmation, עם פרמטרים עבור שם הלקוח ומספר ההזמנה. מכיוון שהשליחה מתבצעת מחוץ לחלון 24 השעות, תבנית היא חובה.
Meta מנהלת את תהליך אישור התבניות, לא Agentix. יוצרים ושולחים תבניות דרך Meta Business Suite. האישור מתקבל בדרך כלל תוך דקות עד כמה שעות.
wa.handoff
העברת השיחה לנציג אנושי.
צומת Handoff מעביר את השיחה מהאוטומציה אל ה-Inbox של הנציגים האנושיים. השיחה תופיע ב-Inbox עם סטטוס "handoff", וצוות אנושי יוכל לקחת אותה ולטפל בה ישירות.
קונפיגורציה
| Option | Type | Required | Description |
|---|
reason | string | No | הערה אופציונלית שמסבירה מדוע בוצע handoff, ותהיה גלויה לנציגים ב-Inbox |
Outputs
| Output | Type | Description |
|---|
handoff.status | string | תמיד handoff, כלומר השיחה עברה למצב טיפול אנושי |
Connections
- Inputs: ידית כניסה אחת מהצומת הקודם
- Outputs: ידית יציאה אחת, בדרך כלל מחוברת ל-
logic.end או נשארת ללא חיבור
דוגמת שימוש
אם AI Router מסווג הודעה כ-”complaint”, או אם AI Respond מזהה תסכול מצד הלקוח, אפשר לנתב אל Handoff עם סיבה כמו "Customer expressing frustration - needs human attention.". השיחה תופיע ב-Inbox ותמתין לטיפול של סוכן אנושי.
אימות בזמן publish: לכל workflow שפורסם חייב להיות לפחות צומת wa.handoff אחד שניתן להגיע אליו. הפלטפורמה אוכפת זאת כדי להבטיח שלקוחות תמיד יוכלו להגיע לאדם. אם אין מסלול handoff, אי אפשר לפרסם את ה-workflow.
