כיצד ליצור WhatsApp Echo Bot באמצעות GREEN-API ב-Make#

בשירות Make, לפלטפורמת GREEN-API יש אפליקציה משלה (חלופה קישור ל- אפליקציה), באמצעותה ניתן לשלוח הודעות לוואטסאפ.

מה עלי לעשות אם מתרחשת שגיאת התקנה?

אם מתרחשת שגיאה בעת התקנת האפליקציה באמצעות הקישורים שצוינו ב-Make, אנו ממליצים לציין בקישור את תת-הדומיין בו הוראתם באתר. תת הדומיין קובע את זמינות האתר באמצעות קישור. דוגמאות לדומיינים זמינים: eu1, eu2, us1, us2.

במדריך זה, נעבור על תהליך יצירת הד בוט עבור WhatsApp שיענה אוטומטית להודעות שהתקבלו. הבוט מיושם באמצעות אפליקציית GREEN-API עבור פלטפורמת Make.

שלבים ליצירת הד בוט:

1. הגדרת אינטגרציה

2. מקבל הודעה

3. שליחת הודעה

4. השקה ובדיקת הבוט

1. הגדרת אינטגרציה#

לפני שתתחיל לפתח בוט, עליך להיכנס לשירות Make ולחבר את האפליקציה מ-GREEN-API. לשם כך, עקוב אחר הקישור להתקנת האפליקציה שצוינה למעלה ולחץ על כפתור "התקן" בעמוד שנפתח. לאחר מכן, בחר את הארגון שעבורו ברצונך להתקין את האפליקציה.

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

2. קבלת הודעה#

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

גם המופע חייב להיות מורשה. פעולה זו מקשרת את חשבון WhatsApp בטלפון שלך למופע, ומאפשרת לך לשלוח ולקבל הודעות. הנחיות מפורטות להרשאת המופע מסופקות במאמר "התחלה מהירה" в нашей документации.

יש להפעיל את התרחיש לאחר שה-Echo Bot מקבל הודעה נכנסת. במדריך זה, נבחן את תהליך קבלת ההתראות באמצעות WebHook.

כדי לקבל הודעות נכנסות באמצעות WebHook, השתמש בטריגר "New Message Webhook" מהשילוב GREEN-API. בואו נגדיר את זה באופן הבא.

1. לחץ על סימן הפלוס ומצא את "GREEN-API" ברשימת האפליקציות
2. בחר את המודול "New Message Webhook".
3. לחץ על 'הוסף' כדי להוסיף webhook למופע שממנו יתקבלו הודעות
4. בחלון שנפתח, לחץ על 'הוסף' כדי להוסיף חיבור למופע
5. הזן ערך מהמופע המורשה, כאשר:
6. שם חיבור - שם שרירותי של החיבור למופע (לא להתבלבל עם שם המופע)
7. 'מופע מזהה' ו'מופע של אסימון API' - נתוני הרשאת המופע שלך

מה עלי לעשות אם מתרחשת שגיאה בעת ניסיון לחבר מופע?

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

1. שמור את נתוני ה-webhook על ידי לחיצה תחילה על כפתור "שמור" ולאחר מכן על כפתור "אישור"

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

• לשם כך, הפעל זמנית את האוטומציה על ידי לחיצה על כפתור "הפעל פעם אחת".

  

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

  

כיצד לקבל התראות רק מצ'אט או קבוצה ספציפיים?

בחלון "צור webhook", בקטע "רק מצ'אט ציין", בחר "כן". אתה יכול לציין צ'אט באופן ידני על ידי בחירה בסוג "ידני" במקור הצ'אט מזהה, או דרך רשימת אנשי הקשר על ידי בחירה ב"מרשימת אנשי קשר". בעת מילוי המספר באופן ידני, עליך להזין את המספר בפורמט phoneNumber@c.us. לדוגמה: 0100123456789@c.us. אל תשתמש באפסים, בסוגריים או במקפים בעת הזנת מספר טלפון ב פורמט בינלאומי.

בעת בחירת מספר מרשימת אנשי הקשר, עליך לבחור את הצ'אט הרצוי בתפריט הנפתח בקטע Chat ID.

3. שליחת הודעה#

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

כדי לשלוח הודעות ב-Make, עליך להוסיף ולהגדיר את מודול "שלח הודעה".

1. כדי להוסיף פעולה, לחץ על חצי העיגול ליד הדק. יופיע עיגול אפור ריק עם סימן פלוס (הוסף אפליקציה)

   

2. בחר אפליקציה לביצוע הפעולה, לשם כך, מצא את GREEN-API ברשימת היישומים

   

3. בחר בשיטת SendMessage

   

4. מרשימת 'חיבור', בחר חיבור מוכן או הוסף חיבור על ידי לחיצה על כפתור 'הוסף'

   

5. בשדה 'מקור מזהה צ'אט', בחר 'ידני'

   

6. כדי להשיב למשתמש שכתב לבוט, עליך להגדיר אותו כנמען. לשם כך, בשדה Chat Id, עליך לציין את הערך של המשתנה chatId, שנמצא בקטע senderData של ההודעה הנכנסת

   

7. בשדה הודעה, הדבק את המשתנה textMessage מהקטע messageData. לאחר מכן לחץ על 'אישור'
8. בצע בדיקה על ידי לחיצה על כפתור הפעל פעם אחת. אם הבדיקה הצליחה, לחץ על סמל 'התקרבות' כדי לראות פרטים על תוצאת הפעולה

נַעֲשָׂה! Echo Bot מוכן להפעלה

כיצד אוכל להגדיר את הבוט כך שיגיב רק להודעות מסוימות?

במצבים מסוימים עשוי להיות שימושי עבור הבוט להגיב רק להודעות מסוימות מהצ'אט, למשל כאשר הבוט נמצא בקבוצה. בואו נגדיר את הבוט שלנו להגיב להודעות עם הטקסט !green-bot. לשם כך נשתמש במסננים. אתה יכול להגדיר אותם על ידי לחיצה על הנקודות שמחברות את ה-webhook ושליחת ההודעה.

לאחר מכן, ייפתח חלון עם הגדרות סינון, בו תווית הוא שם מסנן שרירותי, ושדות הטקסט המוצגים משתמשים בהשוואות זה עם זה לפי התנאי שנבחר בתפריט אופרטורים של טקסט. במקרה שלנו, נבדוק את ההודעה הנכנסת עבור הביטוי !green-bot. לשם כך, הכנס את המשתנה textMessage מקטע messageData לשדה הראשון. בשדה השני נכתוב את הביטוי אליו יגיב הבוט הגדרנו את תנאי הסימון ל'מתחיל עם' כדי לבדוק את נוכחות הביטוי בתחילת ההודעה כעת הבוט יגיב רק להודעות המתחילות ב-!green-bot. כדי להסיר חלק זה של ההודעה ולקבל רק את שאילתת הטקסט של המשתמש, נשתמש במודול החלף מאפליקציית מנתח טקסט המובנית. צור מודול בין ה-webhook לשליחת הודעה בחר במודול 'החלף' <сenter> הזן את הביטוי שאנו נמחק בשדה 'תבנית'. במקרה שלנו, !green-bot (עם רווח בסוף) בשדה 'ערך חדש', הכנס את המשתנה 'emptyString' כדי להחליף את הביטוי במחרוזת ריקה <сenter> בתור הטקסט שיש לעבד, בחר 'הודעת טקסט' החלף את הטקסט של הודעת התגובה במודול 'שלח הודעה' בפלט של מודול 'החלף' לאחר הגדרה זו, הבוט יגיב רק אם הביטוי !green-bot הוזן בתחילת ההודעה

4. הפעלה ובדיקה של הבוט#

כדי להבטיח פעולה רציפה של ה-Echo Bot, עליך להתחיל אוטומציה על ידי הפעלת המתג.

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

זה משלים את הגדרת הבוט.