ערוצים: Telegram, WhatsApp ו-VK
חברו Telegram, WhatsApp ו-VK לאותו פרויקט. הכירו את יכולות הערוצים וגלו לאן נשלחת תשובת הבוט.
בעמוד זה
פרויקט אחד ב-GetMyBot יכול לענות ב-Telegram, ב-WhatsApp וב-VK. לדוגמה, אפשר להשתמש באותה תגובה שמספקת מערכת שעות בשלושתם. התשובה חוזרת לאפליקציה שממנה האדם כתב.
כשמחברים אפליקציה נוספת, בדקו את הכפתורים והפעולות: היכולות שונות בין הפלטפורמות. בהמשך תמצאו את ההבדלים ואת שלבי החיבור.
מהו ערוץ?
ערוץ הוא חשבון מחובר שדרכו הודעות נשלחות ומתקבלות: בוט Telegram מסוים, מספר WhatsApp Business או קהילת VK. אפשר לחבר כמה ערוצים לבוט GetMyBot אחד. התגובות משותפות: הודעה שמנוי שולח ב-WhatsApp מעובדת על ידי אותן תגובות כמו ב-Telegram, והתשובה נשלחת בחזרה ל-WhatsApp.
כפתורים, עיצוב טקסט ופעולות אינם פועלים באותה דרך בכל אפליקציה. העורך עשוי להסתיר הגדרה שאינה נתמכת או להמיר אותה לחלופה זמינה. לפני ההפעלה בדקו את ההודעה בכל ערוץ מחובר.
הערוץ הראשי (primary_channel)
לכל בוט יש ערוץ ראשי (primary_channel): האפליקציה שאליה הוא משויך בעיקר. לרוב זה Telegram, אבל אפשר ליצור מראש בוט WhatsApp או VK גם בלי Telegram. הערוץ הראשי נקבע בזמן יצירת הבוט ומופיע ברשימת הבוטים; ערוצים אחרים אפשר להוסיף אחר כך.
יכולות הערוצים
להלן היכולות של כל ערוץ. רשימה עדכנית בפורמט שמיועד לתוכנות זמינה ב-API דרך GET /api/channels/capabilities.
Telegram: הערוץ עם מגוון היכולות הרחב ביותר. הוא תומך בכפתורים משובצים ובמקלדת תשובה, בהפעלת תגובה בלחיצה על כפתור (callback), בתגובות אימוג'י, בקישור התחלה ישיר /start, בעריכה, מחיקה והעברה של הודעות, בשימוש בתשובה להודעה כטריגר, באירועי חברים, בהרשאות ובניהול שיחות. כשיש מזהי קבצים מתאימים, כרטיסי קרוסלת תמונות מתחלפים באמצעות כפתורים באותה הודעה. עיצוב הטקסט: Plain / HTML / Markdown. אין בו תבניות, רשימות או חלון שיחה של WhatsApp, כי אין בהם צורך ב-Telegram.
WhatsApp דרך WhatsApp Cloud API: תומך בכפתורים משובצים, callback, תגובות אימוג'י וקישור התחלה /start. בנוסף יש בו תבניות הודעה, רשימות אינטראקטיביות (interactive list) וחלון שיחה של 24 שעות. עיצוב הטקסט: Plain / Markdown. הוא אינו תומך במקלדת תשובה קבועה, בעריכה, מחיקה או העברה של הודעות, בתשובה כטריגר, באירועי חברים, בהרשאות וניהול, או בדפדוף בקרוסלה בתוך הודעה אחת. ראו WhatsApp.
VK: תומך בהודעות וקבצים מצורפים, בכפתורים משובצים ובמקלדת תשובה, ב-callback, בתגובות אימוג'י, בקישור התחלה /start, בעריכה, מחיקה והעברה של הודעות, באירועי חברים, בחסימה וביטולה, באישור בקשת הצטרפות שכבר הוגשה לקהילה סגורה ובאירועי מנוי בתשלום של VK Donut. הוא מציג טקסט רגיל בלבד: HTML ו-Markdown מוסרים בזמן ההצגה. אין בו תבניות WhatsApp, רשימות, דפדוף בקרוסלה בתוך הודעה אחת או חלון שיחה.
בכל הערוצים זמינים כפתורים משובצים, callback, תגובות אימוג'י וקישור התחלה /start. בלוק קרוסלת התמונות זמין בערוצים שתומכים בתמונות. ב-Telegram הכרטיסים מופיעים באותה הודעה רק אם לכל התמונות יש file_id מתאים. ב-WhatsApp וב-VK, וגם ב-Telegram אם לא ניתן להשיג מזהה מתאים אפילו לאחת מהתמונות, כל הכרטיסים נשלחים כהודעות תמונה נפרדות, עם הכיתוב והכפתורים של כל כרטיס. ראו הודעות וכפתורים.
VK Donut
אם שירות VK Donut מופעל בקהילה שלכם, הבוט מקבל אירועי מערכת על מנויים בתשלום:
| שם האירוע בעורך | מפתח | ערכים זמינים |
|---|---|---|
| VK Donut: subscription created (מנוי חדש) | donut_subscription_created | {{event.donut_amount}}, {{event.donut_amount_without_fee}} |
| VK Donut: subscription prolonged (מנוי חודש) | donut_subscription_prolonged | {{event.donut_amount}}, {{event.donut_amount_without_fee}} |
| VK Donut: subscription expired (מנוי פג) | donut_subscription_expired | אין |
| VK Donut: subscription cancelled (מנוי בוטל) | donut_subscription_cancelled | אין |
{{event.donut_amount}} הוא סכום התשלום; {{event.donut_amount_without_fee}} הוא הסכום בלי העמלה של VK. לאירועי פקיעה וביטול אין סכום. פקיעת התקופה ששולמה אינה מציינת תשלום חדש, והצגת תשלום ישן כאן תטעה.
זהו אירוע על המנוי, לא הודעה ממנו. לכן הוא אינו פותח אפשרות לשלוח לו הודעות פרטיות, אינו מסיר חסימה, אינו מעדכן את „הפעילות האחרונה” ואינו מגדיל את מספר ההודעות. חיוב הכרטיס אינו אומר שהאדם כתב לבוט. אם האדם אינו מוכר לפלטפורמה, נוצרת עבורו רשומה כדי שאפשר יהיה לתת לו תוויות והרשאות.
דוגמה למועדון בתשלום:
- צרו תגובות לאירועים VK Donut: subscription created ו-VK Donut: subscription prolonged. בפעולה שנה תוויות הוסיפו את התווית „מועדון” למשך
ttl_days= 31 יום. שלחו גם קישור לקהילה הסגורה ובקשו מהאדם להגיש בקשת הצטרפות. - אשרו את הבקשה רק אחרי שהאדם הגיש אותה. הפעולה שנה הרשאות → אישור בקשת הצטרפות מאשרת בקשה קיימת (
groups.approveRequest). לפני שהוגשה בקשה, אין מה לאשר. הוסיפו את הפעולה לתגובה שפועלת אחרי שלב 1, למשל כשלוחצים על „שלחתי בקשה” מתחת לאותה הודעה, או באירוע VK Donut: subscription prolonged הבא. - בטריגר Label expired (
label_expired) הוסיפו שנה הרשאות → הסרה מהצ'אט. כך האדם יוצא מהמועדון כשהתווית פוקעת, גם אם לא התקבל מ-VK אירוע פקיעת מנוי. ראו טריגרים → פקיעת תווית. - לאירועים VK Donut: subscription cancelled ו-VK Donut: subscription expired, השתמשו בפעולה שנה תוויות → הסרת „מועדון”, ואם צריך, גם בהסרה מהצ'אט מיד.
בשדה צ'אט (chat_id) של פעולות ההרשאות ב-VK הזינו את המזהה המספרי של הקהילה המחוברת, אותו מספר שמופיע ליד ערוץ VK ברשימת הערוצים. VK יכול לנהל חברים רק בקהילה הזאת. מזהה אחר יידחה לפני שליחת הפעולה ל-VK. כדי לנהל קהילה אחרת, חברו אותה כערוץ נפרד.
כדי להפעיל את האירועים:
- Long Poll: הבוט נרשם אליהם בעצמו בזמן חיבור הערוץ ובכל הפעלה של הפלטפורמה. אין צורך לעשות דבר עבור קהילות שכבר מחוברות.
- Callback API: בהגדרות הקהילה פתחו עבודה עם API → Callback API → סוגי אירועים → VK Donut והפעילו את כל ארבעת האירועים שבטבלה.
איך מחברים ערוץ?
מוסיפים ערוצים בדף פרויקטים:
- פתחו את פרויקטים ומצאו את הפרויקט הרצוי.
- בכרטיס הפרויקט לחצו הוספת ערוץ.
- בחרו Telegram, WhatsApp או VK.
- הזינו את פרטי הערוץ: טוקן ל-Telegram, פרטי Meta ל-WhatsApp או פרטי הקהילה ל-VK.
- לחצו אימות כדי שהמערכת תבדוק את הפרטים אצל ספק המסרים.
- לחצו חיבור.
אחרי חיבור ערוץ WhatsApp או VK מופיעה בו כתובת webhook עם הסמל 🔗. רשמו את הכתובת אצל הספק, ביישום Meta עבור WhatsApp או בהגדרות הקהילה עבור VK, כדי שאירועים נכנסים יגיעו לבוט. הוראות WhatsApp נמצאות בהגדרת webhook.
מה הלאה?
- WhatsApp: חיבור, webhook, חלון שיחה ותבניות הודעה.
- פרויקטים וערוצים: חיבור בסיסי של בוט.
- תגובות: יסודות: התנהגות משותפת לבוט בכל הערוצים.
פרטי הגישה לערוץ
Telegram משתמש בטוקן המלא מ-BotFather. ל-VK צריך טוקן קהילה ומזהה קהילה מספרי; עבור Callback API צריך גם מחרוזת סודית וקוד אישור. ל-WhatsApp הזינו Phone Number ID, מזהה חשבון WhatsApp Business, טוקן גישה לחשבון, Verify Token של ה-webhook ו-App Secret של יישום Meta.
בדקו את הפרטים לפני החיבור. כשמחליפים מפתח, עדכנו גם את ההגדרה התואמת אצל הספק: Verify Token מאמת את כתובת ה-webhook, ו-App Secret מאמת את חתימת האירועים הנכנסים. הם אינם מחליפים את טוקן הגישה ל-API.
אירועים נכנסים וכתובות webhook
ב-VK Callback API רשמו את הכתובת שמציג MyBot בהגדרות השרת של הקהילה, והגדירו מחרוזת סודית וקוד אישור זהים בשני הצדדים. Long Poll אינו דורש כתובת ציבורית או את שני הערכים האלה. ב-WhatsApp רשמו את הכתובת ביישום Meta, הזינו Verify Token תואם והירשמו לאירועי ההודעות הדרושים. פרטי גישה לשליחת הודעות בלבד אינם מספיקים לקבלת הודעות נכנסות.
הרשאה ל-Instagram ול-Messenger
אשף החיבור פותח את מסך ההרשאה של Meta. התחברו עם חשבון שמנהל את דף Facebook הרצוי או חשבון Instagram מקצועי, תנו את ההרשאות המבוקשות ובחרו את החשבונות לפרויקט הזה. האשף בודק את ההרשאות, את ההרשמה ל-webhook ואת מוכנות מסירת ההודעות. טפלו בבדיקות שנכשלו לפני השימוש בערוץ. בחיבור קיים אפשר לחזור ולבחון את החשבונות שנבחרו.