טלגרם

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

מגבלות

השילוב הזה תומך רק בשפת ברירת המחדל של נציג התמיכה.

הגדרת טלגרם

כדי להגדיר את השילוב של Telegram עם הסוכן, צריך את הפרטים הבאים:

יצירת בוט בטלגרם

  1. נכנסים לטלגרם ועוברים אל https://telegram.me/botfather.
  2. לוחצים על הלחצן התחלה בממשק האינטרנט או מקלידים ‎ /start
  3. לוחצים על /newbot או מקלידים אותו ומזינים שם.
  4. מזינים שם משתמש לבוט שמסתיים ב-bot (לדוגמה, garthsweatherbot)
  5. מעתיקים את אסימון הגישה שנוצר

הגדרת Dialogflow

  1. ב-Dialogflow, בתפריט הימני, עוברים אל Integrations (שילובים).
  2. לוחצים על המשבצת Telegram.
  3. מדביקים את Access Token (טוקן גישה) בשדה הרלוונטי.
  4. לוחצים על הלחצן התחלה

בדיקה

אחרי שתשלימו את ההגדרה, תקבלו מ-BotFather קישור לבוט. כדי לבדוק את הסוכן, אפשר ללחוץ על הקישור הזה.

יצירה מחדש של טוקן טלגרם

כדי ליצור מחדש את אסימון Telegram לסוכן עם שילוב Telegram מופעל, צריך:

  1. עוברים להגדרות השילוב של Dialogflow ולוחצים על עצירה.
  2. מפיקים מחדש את הטוקן ב-Telegram.
  3. מזינים את טוקן Telegram החדש בהגדרות השילוב ולוחצים על התחלה.

שילוב של סוכן עם בוט חדש בטלגרם

כדי לקשר סוכן עם שילוב של Telegram לבוט חדש של Telegram:

  1. עוברים להגדרות השילוב של Dialogflow ולוחצים על STOP (עצירה).
  2. אם צריך, מוחקים את הבוט הישן בטלגרם.
  3. מזינים את טוקן Telegram החדש בהגדרות השילוב ולוחצים על התחלה.

אירועים

האירועים הבאים מופעלים על ידי השילוב הזה:

אירוע תיאור
TELEGRAM_WELCOME מופעל כשמשתמש מתחיל שיחה עם בוט Telegram או מקליד /start.
TELEGRAM_HELP מופעל כשמשתמש מזין /help במהלך שיחה עם בוט Telegram.
TELEGRAM_SETTINGS מופעל כשמשתמש מזין /settings במהלך שיחה עם בוט Telegram.

הודעות עם תשובות עשירות

אלה הודעות התגובה המתקדמות שנתמכות.

תשובות עם תמונות

פורמטים וגדלים נתמכים:

  • גודל מקסימלי של 5MB

תשובות בכרטיס

חובה למלא את השדה של כתובת ה-URL של התמונה או את השדה של שם התמונה.

יש תמיכה בלחצנים עם כתובת URL ועם החזרת נתונים (postback) של טקסט. כשלוחצים על כפתור עם כתובת URL, נפתח דף אינטרנט, וכשלוחצים על כפתור עם טקסט, הטקסט נשלח כשאילתת משתמש.

תשובות מהירות

תשובות מהירות בשילובים של Telegram בלחיצה אחת מקבילות ללחצני מקלדת ב-Telegram.

כשמשתמש לוחץ על אחד מהלחצנים, הם נעלמים. כך נמנעת הבעיה שבה משתמשים יכולים ללחוץ על לחצנים שמצורפים להודעות ישנות בשיחה.

תשובות של מטען ייעודי (payload) בהתאמה אישית

טקסט מעוצב והיפר-קישורים בשילוב עם Telegram בלחיצה אחת

בוטים שלכם ב-Telegram יכולים לשלוח טקסט מעוצב והיפר-קישורים.

בדוגמה הבאה נשלח טקסט מעוצב עם היפר-קישור באמצעות מצב הניתוח של Markdown:

{
  "telegram": {
    "text": "You can read about *entities* [here](/docs/concept-entities).",
    "parse_mode": "Markdown"
  }
}

מידע נוסף מופיע במאמרי העזרה של Telegram.

לחצנים במקלדת בתוך השורה

בדוגמה הבאה אפשר לראות איך מגדירים לחצנים של מקלדת מוטבעת ברכיב Custom payload.

{
  "telegram": {
    "text": "Pick a color",
    "reply_markup": {
      "inline_keyboard": [
        [
          {
            "text": "Red",
            "callback_data": "Red"
          }
        ],
        [
          {
            "text": "Green",
            "callback_data": "Green"
          }
        ],
        [
          {
            "text": "Yellow",
            "callback_data": "Yellow"
          }
        ],
        [
          {
            "text": "Blue",
            "callback_data": "Blue"
          }
        ],
        [
          {
            "text": "Pink",
            "callback_data": "Pink"
          }
        ]
      ]
    }
  }
}