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

Make היא פלטפורמת עיצוב חזותי המאפשרת לך להפוך משימות לאוטומטיות על ידי חיבור יישומי אינטרנט (כגון Discord, Slack, Gmail). תהליכים אוטומטיים שנוצרו ב-Make נקראים תרחישים.

לפלטפורמה Green-API יש אפליקציה משלה ב-Make שירות, שבאמצעותו תוכל לשלוח הודעות וואטסאפ.

קישורים חלופיים לאפליקיה:

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

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

הליך הגדרת האינטגרציה:

1. הגדרת אפליקציית Make
2. הגדרת אפליקציית ה-API של Green
3. יצירת תרחיש
4. מקבל הודעה
5. שליחת הודעה

1. הגדרת אפליקציית Make#

• היכנס או רשם חשבון ב-Make.
• התקן את אפליקציית Green-API ב-Make על ידי לחיצה על קישור זה.

• לחץ על כפתור 'התקן'.

  

• בחר את הארגון שבו יותקן אפליקציית Green-API ולחץ על כפתור ה'התקן'.

  

• בדף 'אפליקציות מותקנות', תוכל לבדוק את זמינות האפליקציה בארגון שלך.

  

2. הגדרת אפליקציית Green API#

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

• אשר את הטלפון. כדי לעשות זאת:

אתה יכול לסרוק את קוד ה-QR בדף הגדרת המופע. באפליקציית WhatsApp לנייד או ב-WhatsApp Business, היכנסו למכשירים המקושרים וסרוקו את קוד ה-QR שהתקבל.

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

לאחר הרשאה מוצלחת, המופע צריך לקבל את הסטטוס 'מורשה'. אתה יכול לבדוק את סטטוס המופע באמצעות השיטה GetStateInstance.

• תצטרך להעתיק את הערכים של idInstance ו-apiTokenInstance לעבודה עם תרחישי Make.

3. יצירת תרחיש#

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

אלגוריתם ליצירת תרחיש:

• היכנס או רישום חשבון ב-Make
• בתפריט סרגל הצד, לחץ על כפתור תרחישים

• בדף התרחישים, לחץ על 'צור תרחיש חדש' כדי ליצור תרחיש חדש

התרחיש נוצר בהצלחה!

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

כדי לקבל הודעות ב-Make, עליך להגדיר טריגר.

טריגר - זהו אירוע שמפעיל את התרחיש שלך. לדוגמה, זו יכולה להיות הודעה חדשה ב-WhatsApp, רשומה חדשה ב-Google Sheets או משהו אחר.

ביישום Green API, ישנם שני סוגים של טריגרים המיושמים לקבלת הודעות:

1. New Message Webhook
2. הודעות נכנסות אחרונות

1. הווק הודעה חדש#

New Message Webhook - הדק מופעל בעת קבלת הודעת WhatsApp נכנסת חדשה. הטריגר מבוסס על webhooks.

יתרונות: + זמן הפעלת טריגר מינימלי + מידע מפורט יותר על הודעות נכנסות

חסרונות: - ניתן להשתמש בטריגר רק לאינטגרציה אחת במופע Green API אחד - אם תשנה את הגדרות המופע באופן ידני, הטריגר עשוי להגיב גם להתראות מלבד הודעות נכנסות

"webhookUrl": "webhookserver make",
"incomingWebhook": "yes"

2. הודעות נכנסות אחרונות#

הודעות נכנסות אחרונות - הדק מופעל בעת קבלת הודעת וואטסאפ חדשה. הטריגר מבוסס על שיטת lastIncomingMessages.

יתרונות: + טריגר זה יכול לשמש עבור אינטגרציות שונות במופע אחד של Green API + הטריגר מגיב רק להודעות נכנסות

חסרונות: - זמן הפעלת הטריגר נקבע לפי זמן הוספת ההודעה ליומן ותדירות הבקשות על ידי שירות Make (תלוי בסוג חשבון Make)

תצורת טריגר#

הליך הגדרת הטריגר:

• צור תרחיש חדש
• לחץ על סימן הפלוס, ברשימת היישומים, מצא את Green API

• בחר אחת מהשיטות לקבלת הודעות

• לחץ על 'הוסף' כדי להוסיף את הכתובת שממנה יתקבלו webhooks.

• בחלון צור webhook, לחץ על הוסף כדי להוסיף חיבור.

• הכנס את הערכים של המופע שלך idInstance ושל apiTokenInstance (אחזור הודעות יבוצע מהמספר המשויך למופע זה)

• בחלון 'צור חיבור', לחץ על 'שמור'
• החיבור למופע שנוסף יצליח אם Make יציג את המספר שלך בפורמט phoneNumber@c.us ב- רשימת "חיבור".

• To make the trigger respond to messages from any contact or chat, select No in the Only From Specify Chat field

איש קשר ספציפי

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

• בחר 'ידני' כדי להזין את המספר באופן ידני:

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

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

• בחר 'מרשימת אנשי קשר' כדי לבחור מספר מרשימת אנשי הקשר שלך:

• בחלון צור webhook, לחץ על שמור. לאחר מכן לחץ על 'אישור'.

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

נַעֲשָׂה! הדק מוגדר ומוכן לשימוש!

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

כדי לשלוח הודעות, עליך להגדיר את הפעולה ב-Make.

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

תצורת הפעולה צריכה להיעשות לאחר הגדרת הטריגר כך שהודעות יישלחו אוטומטית.

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

פעולות#

כל הפעולות חוזרות על שיטות Green API, תוכל לקרוא עוד על שיטות Green API בתיעוד.

שיטות שליחת הודעות:

• שלח הודעה - שליחת הודעת טקסט.

• שלח איש קשר - שליחת כרטיס איש קשר.

• שלח קובץ לפי כתובת אתר - שליחת קובץ לפי כתובת אתר.

• שלח מיקום - מיקום שליחת.

תצורת פעולה#

הליך הגדרת הפעולה:

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

• בחר את האפליקציה לביצוע הפעולה. כדי לעשות זאת, מצא את Green API ברשימת היישומים.

  

• בחר אחת מהשיטות לשליחת הודעה. לדוגמה, שיטת SendMessage

  

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

  בעת הוספת חיבור חדש, מלא את הנתונים עבור המופע שלך, idInstance ו-apiTokenInstance (שליחת ההודעה תתבצע מהמספר המשויך למופע זה). לאחר מכן לחץ על 'שמור'.

• בשדה 'מקור צ'אט מזהה', בחר דרך נוחה להזין את מספר הצ'אט. האפשרות 'ידנית' מאפשרת לך להזין את המספר באופן ידני. האפשרות 'מרשימת אנשי קשר' מאפשרת לך לבחור מספר מרשימת אנשי הקשר.

• שדה 'Chat ID' מלא באופן ידני או בחר אותו מרשימת אנשי הקשר. בעת הזנה ידנית, המספר צריך להיות בפורמט phoneNumber@c.us. בנה את השדה 'הודעה' משדות ההדק שהופעלו במהלך הבדיקה. לאחר מכן לחץ על 'אישור'.

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

נַעֲשָׂה! הפעולה מוגדרת ומוכנה לשימוש!

דוגמאות לשימוש ביישום Green API#

כיצד לבצע הודעות בין WhatsApp ל-Slack

כיצד לבצע הודעות בין WhatsApp ל-Discord