# טריגר טלגרם

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

Source: https://nodaro.ai/he/docs/nodes/automate/telegram-trigger

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

- Found in: Automate › Triggers
- Output: data
- API type: `telegram-trigger`

## מתי להשתמש
- לבנות בוט שיוצר תמונה או סרטון מכל הודעת טקסט.
- לענות על הודעות עם רכיב [יצירת טקסט - כל LLM](https://nodaro.ai/docs/nodes/automate/prompt) ולשלוח את התשובה בחזרה עם רכיב [פוסט לטלגרם](https://nodaro.ai/docs/nodes/publish/telegram-post).
- לקבל את התמונות, הסרטונים וקובצי האודיו שאנשים שולחים לבוט.
- לאסוף את הפוסטים של קבוצה או של ערוץ שהבוט שלכם חבר בהם, ולעבד כל פוסט.

## התחלה מהירה
### חיבור הבוט שלכם
קודם חברו את בוט הטלגרם שלכם בדף **אינטגרציות**. ראו את המדריך [פרסום ברשתות החברתיות](https://nodaro.ai/docs/guides/publishing-to-social).

### הוספת הרכיב ובחירת הבוט
הקישו Tab על הקנבס ובחרו **אוטומציה › טריגרים › טריגר טלגרם**. בחלונית ההגדרות, בחרו את הבוט תחת **בוט Telegram**.

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

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

### שליחת הודעה לבוט
מעכשיו כל הודעה שמתאימה למסננים מתחילה הרצה.

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

- טריגר טלגרם → יצירת תמונה (פרומפט)
- יצירת תמונה → פוסט לטלגרם

## הגדרות
| הגדרה | מה היא עושה |
| --- | --- |
| **בוט Telegram** | הבוט המחובר שהטריגר מאזין לו. נדרש: בלי בוט, שום דבר לא נרשם. כשעוד לא חובר בוט, החלונית מציגה קישור לדף **אינטגרציות**. |
| **סינון לפי מזהה צ׳אט** | רק הודעות מהצ׳אט הזה מתחילות הרצה, למשל `@channel` או מזהה מספרי שמתחיל ב-`-100`. השאירו את השדה ריק כדי לקבל הודעות מכל הצ׳אטים. |
| **סוגי הודעות** | אילו סוגי הודעות מתחילים הרצה: **טקסט**, **תמונה**, **וידאו**, **אודיו** ו**מסמך**. כל החמישה מסומנים כברירת מחדל. |
| **הפעלת הטריגר** | הכפתור מפעיל את הטריגר, והכפתור **כיבוי הטריגר** מכבה אותו. השינוי חל כששומרים את התהליך. |

הסטטוס בראש החלונית מציג את המצב של הטריגר:

| סטטוס | משמעות |
| --- | --- |
| **פעיל — מאזין להודעות** | הטריגר מופעל ונבחר בוט. |
| **בחרו בוט — עדיין לא מאזין** | הטריגר מופעל, אבל לא נבחר בוט. |
| **לא פעיל** | הטריגר כבוי. |

## מה הרכיב מעביר הלאה
לרכיב יש פלט אחד, **הודעה**. כשהרצה מתחילה, Nodaro מעביר את ההודעה לרכיבים המחוברים לפי מה שיש בה:

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

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

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

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

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

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

- רכיב טריגר טלגרם מציג **מטפל בהודעה…** כל עוד ההרצה נמשכת.
- הרכיבים שההרצה מגיעה אליהם מציגים את ההתקדמות שלהם, והתוצאות נשארות עליהם כשההרצה מסתיימת. ההודעה עצמה נשארת ברשימה **הרצות**.
- העורך בודק אם יש הרצות חדשות מהודעות בערך כל 10 שניות.
- פס ההרצה מציג את ההרצה, ותפריט העצירה שלו עובד כמו בכל הרצה. ראו את הסעיף [עצירת הרצה](https://nodaro.ai/docs/concepts/running-workflows#stop-a-run) בדף הרצת תהליכים.

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

רק הרצות מהודעות מוצגות על הקנבס. הרצות שתזמון, Webhook או ה-API מתחילים מופיעות רק ברשימה **הרצות**.

## קרדיטים
רכיב טריגר טלגרם לא עולה כלום. בכל הרצה משלמים על הרכיבים שרצים בה.

## פתרון בעיות
- **השמירה מזהירה שאי אפשר היה לרשום את הטריגר.** טלגרם דחה את הרישום, והאזהרה מסבירה למה. סיבה נפוצה אחת היא אסימון בוט שבוטל אחרי שחיברתם את הבוט. סיבה אחרת היא התקנה באירוח עצמי שה-`PUBLIC_URL` שלה הוא לא כתובת HTTPS שטלגרם יכול להגיע אליה. כשהרישום נכשל, לא נוצר טריגר.
- **שום דבר לא קורה כשנשלחות הודעות בקבוצה.** בוט מקבל רק את הודעות הקבוצה שמופנות אליו, אלא אם כיביתם את מצב הפרטיות לקבוצות של הבוט ב-BotFather.
- **המדיה חסרה בהרצה.** טלגרם מאפשר לבוטים להוריד קבצים עד 20 MB. קובץ גדול יותר מגיע כהודעה בלי מדיה.

## שאלות נפוצות

### איך מתחילים תהליך מהודעה בטלגרם?

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

### האם כמה תהליכים יכולים להאזין לאותו בוט?

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

### למה הבוט לא מגיב להודעות בקבוצה?

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

### האם אפשר להגביל את הטריגר לצ׳אט אחד?

כן. ברכיב טריגר טלגרם, הזינו את הצ׳אט בשדה סינון לפי מזהה צ׳אט, בצורה ‎@channel או כמזהה מספרי, כגון ‎-100 ואחריו ספרות. השאירו את השדה ריק כדי לקבל הודעות מכל הצ׳אטים.

### האם רכיב טריגר טלגרם עולה קרדיטים?

לא. רכיב טריגר טלגרם עצמו לא עולה כלום. בכל הרצה משלמים על הרכיבים שרצים בה.