חיבור WhatsApp ל-Activepieces במספר Coexistence

איך מחברים מספר Coexistence ל-Activepieces?

יוצרים ב-Activepieces חיבור WhatsApp Business עם שני ערכים: האסימון ומזהה חשבון WhatsApp Business. לוח הבקרה של EasyCoexistence מציג את שניהם לכל חיבור, והכלי get_api_credentials מחזיר אותם לעוזר AI. ההוראות של הרכיב מדברות על יצירת אפליקציית Meta ומשתמש מערכת, כי הן מניחות שאין לכם אף אחד מהם. כאן המספר כבר מחובר, אז מדלגים ישר להדבקת הערכים.

אחר כך בונים תהליך שמתחיל בטריגר New Incoming Message, מגדירים בו אסימון אימות לבחירתכם ומפרסמים את התהליך. מעתיקים את כתובת ה-URL של הוובהוק של הטריגר ליעד הוובהוק של המספר ב-EasyCoexistence, עם אותו אסימון אימות. Meta שולחת בקשת אימות, הטריגר עונה לה, וכל הודעה למספר מפעילה ריצה.

למה סוד האפליקציה חייב להישאר ריק?

כי את הסוד שחותם על המשלוחים האלה אי אפשר להדביק. Meta חותמת כל וובהוק עם סוד האפליקציה של האפליקציה שמחזיקה במינוי, ובמספר שחובר דרך EasyCoexistence זו אפליקציית EasyCoexistence, והסוד שלה לא משותף אף פעם.

הרכיב מגדיר את השדה כאופציונלי. כשהוא ריק, הטריגרים מקבלים משלוחים כפי שהם. אם ממלאים בו סוד של אפליקציה אחרת, כל משלוח נכשל בבדיקת X-Hub-Signature-256 ומתעלמים ממנו בשקט, וזה נראה בדיוק כמו הודעות שלא מגיעות.

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

מה תהליך יכול לעשות אחרי שהודעה מגיעה?

הטריגר מעביר לתהליך הודעה מפושטת: שולח, שם פרופיל, מזהה הודעה, סוג, טקסט, מזהה מדיה אם יש, תשובות מכפתורים ומרשימות, ומזהה מספר הטלפון שקיבל את ההודעה. משם זה תהליך Activepieces רגיל, עם שאר הרכיבים, למשל CRM, גיליון או שלב AI.

התשובות משתמשות באותו רכיב. הפעולה Send Message שולחת טקסט חופשי, והיא נמסרת רק עד 24 שעות מההודעה האחרונה של הלקוח. הפעולה Send Template Message שולחת תבנית מאושרת, והיא הדבר היחיד שנמסר אחרי החלון הזה. כפתורים אינטראקטיביים, רשימות, מדיה, מיקום ותגובות הן פעולות נפרדות.

ההוראות של Activepieces עצמה מציינות ש-Meta מקבלת כתובת URL אחת לקריאה חוזרת לכל אפליקציה. עם יעדים לכל מספר, המגבלה היא כתובת אחת לכל מספר, ולכן תהליך שצריך לטפל בכמה סוגי אירועים צריך להסתעף בתוך תהליך אחד.

האם תשובות שמוקלדות בטלפון מגיעות לתהליך?

הן מגיעות לוובהוק, אבל לא לטריגר הזה. במספר Coexistence, Meta שולחת הד של כל תשובה שהוקלדה באפליקציית WhatsApp Business לאותו יעד, תחת השדה smb_message_echoes. הטריגר New Incoming Message של הרכיב קורא רק את השדה messages ומשליך את כל השאר.

אם צריך את תשובות הטלפון בתהליך, מתחילים אותו ברכיב Webhook הכללי של Activepieces, שמקבל כל שיטת HTTP, ועונים על בקשת ה-GET של האימות בשלב Return Response בכתובת הסינכרונית שלו. אז מפענחים בעצמכם את ה-payload הגולמי, עם שני השדות.

ברוב התהליכים הטריגר של הרכיב הוא הבחירה הפשוטה יותר: הוא מגיב ללקוחות, והתשובות של הצוות נשארות גלויות באפליקציה שבטלפון.

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

• הדבקת סוד אפליקציה בחיבור WhatsApp. המשלוחים חתומים בסוד של אפליקציית EasyCoexistence, ולכן מתעלמים מכולם.
• הגדרת היעד לפני פרסום התהליך. Meta מאמתת מיד, ותהליך שלא פורסם לא יכול לענות.
• ציפייה שהטריגר New Incoming Message יראה תשובות שהוקלדו בטלפון. הוא קורא רק את השדה messages ולא את smb_message_echoes, ולכן התשובות האלה לא נקלטות.

שאלות נפוצות

המשיכו לקרוא