מענה להודעות WhatsApp באמצעות chatflow של Flowise

למה Flowise צריך משהו לפניו?

כי הוובהוק של Meta וה-API של Flowise מדברים בצורות שונות. Meta מאמתת יעד באמצעות בקשת GET שחייבת להחזיר את hub.challenge כגוף גולמי, ואז מוסרת כל הודעה כבקשת POST עם JSON מקונן. ה-Prediction API של Flowise מצפה לבקשת POST אל /api/v1/prediction/ ואחריו מזהה ה-flow, עם השדה question. אף אחד מהם לא יתאים את עצמו לשני, ולכן מקלט מתרגם ביניהם.

המקלט יכול להיות צומת Webhook ב-n8n, נתיב ב-Python או ב-Node, או כל פונקציית ענן. הוא עונה על בקשת האימות, בודק סוד אקראי ארוך שמוטמע בכתובת ה-URL של הוובהוק, מחזיר ל-Meta תגובת 200 מיד, ורק אחר כך מבצע את העבודה. הסוד בכתובת הוא האימות שעובד כאן: Meta חותמת על המסירות עם סוד האפליקציה של ה-Tech Provider, שלעולם לא משותף, ולכן את הכותרת X-Hub-Signature-256 אי אפשר לאמת בצד שלכם.

איך המקלט צריך לקרוא ל-Prediction API?

עם טקסט הלקוח בשדה question ועם מספר ה-WhatsApp של הלקוח כמזהה הסשן. Flowise מקבל overrideConfig בכל בקשה, ו-sessionId בתוכו הוא מה שמאפשר לצמתי הזיכרון לשמור שיחה נפרדת לכל אדם, במקום לערבב את כולם בשרשור אחד. מספר השולח מתוך ה-payload של הוובהוק הוא מפתח יציב וטבעי לכך.

אם ה-chatflow מוגן במפתח API, המקלט שולח אותו כאסימון bearer. מגדירים את streaming כ-false, אלא אם המקלט בנוי להרכיב זרם, כי WhatsApp מוסר הודעה אחת גמורה ולא אסימון אחרי אסימון.

התשובה יוצאת כהודעת טקסט של Cloud API מאותו מספר. זה מותר וללא תשלום בתוך חלון 24 השעות שהודעת הלקוח פתחה. כל דבר שה-flow רוצה לשלוח אחר כך, כמו תזכורת, חייב להיות תבנית מאושרת.

POST https://your-flowise-host/api/v1/prediction/<flow-id>
Authorization: Bearer <flowise-api-key>
Content-Type: application/json

{
  "question": "do you have anything friday?",
  "streaming": false,
  "overrideConfig": { "sessionId": "14155550188" }
}

האם סוכן Flowise יכול להשתמש בשרת MCP של EasyCoexistence?

לא כרגע. ה-Custom MCP של Flowise מתחבר לשרת Streamable HTTP עם כתובת URL וקבוצת כותרות, בדרך כלל אסימון bearer סטטי שנשמר במשתנה של Flowise. שרת MCP של EasyCoexistence מאמת באמצעות OAuth, עם כניסה בדפדפן ואסימונים שהוא מנפיק בעצמו, ולכן אין מפתח סטטי להניח בכותרת.

החלוקה שעובדת היא שה-flow מחליט והמקלט שולח. ה-flow מחזיר את הטקסט לאמירה, או את שם התבנית כשהלקוח שותק יותר מיום, והמקלט מבצע את הקריאה ל-Cloud API עם האסימון של המספר. כך האסימון אף פעם לא נמצא בתוך Flowise, וכלל 24 השעות נאכף בקוד, לפי מועד הכתיבה האחרונה של איש הקשר, ולא נשאר בידי מודל שעלול לשכוח אותו.

הודעות נכנסות ממשיכות להגיע רק דרך הוובהוק, בכל דרך שבה השליחה מתבצעת.

טעויות נפוצות

• השמטת sessionId. כל הלקוחות חולקים אז זיכרון אחד, ופרטים של אדם אחד עלולים להופיע בתשובה לאדם אחר.
• המתנה ל-Flowise לפני שעונים ל-Meta. תגובת 200 איטית נשלחת שוב, וכך אותה הודעה מעובדת פעמיים.
• מתן ל-flow לשלוח טקסט חופשי יום אחרי. מחוץ לחלון Meta דוחה אותו עם שגיאה 131047.

שאלות נפוצות

המשיכו לקרוא