מדריכי מוצר

חיבור חשבון Telegram

אפשר לחבר ל-Wbiztool את חשבון ה-Telegram שלכם, לצד מספרי ה-WhatsApp. הוא שולח דרך אותו API ואותם דפים כמו מספר WhatsApp, והנמענים רואים את ההודעות כהודעות Telegram רגילות מכם.

API אחד לשניהם. שליחת הודעה, שליחה למספרים מרובים, תזמון הודעה, שליחה לקבוצה, ביטול הודעה וה-Webhooks של סטטוס ההודעות עובדים באותה דרך. העבירו את המזהה של חשבון ה-Telegram כ-whatsapp_client.
אותם דפים. שליחה מהירה, קמפיינים ותזכורות יכולים לשלוח ממנו.
יותר דרכים להגיע לאנשים. שליחה למספר טלפון, לשם משתמש (‎@username), לקישור ‎t.me או לקבוצה.

מי יכול לעשות זאת: בעלים ועורכים מחברים ומנהלים חשבונות Telegram.

לפני שמתחילים#

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

חיבור החשבון#

בדף מספרים, לחצו על הוספת חשבון Telegram. הכפתור מופיע גם בחלון הוספת מספר WhatsApp, מתחת לטופס: רוצים לחבר חשבון Telegram? הוספת חשבון Telegram.

החלון הוספת חשבון Telegram מציע שתי דרכים להתחבר: סריקת קוד QR או קוד התחברות. התוצאה זהה בשתיהן.

עם קוד QR#

השתמשו בדרך הזו כשהטלפון נמצא ליד המחשב.

פתיחת הוספת חשבון Telegram
בדף מספרים, לחצו על הוספת חשבון Telegram. החלון נפתח כשסריקת קוד QR מסומנת.
הצגת קוד ה-QR
לחצו על הצגת קוד QR. החלון סרקו עם Telegram מציג את הקוד.
פתיחת הוספת מכשיר בטלפון
פתחו את Telegram בטלפון ועברו אל הגדרות ← מכשירים ← הוספת מכשיר.
סריקת הקוד
כוונו את הטלפון אל קוד ה-QR. הקוד מתחלף כל 30 שניות: סרקו את החדש ביותר. כשההתחברות מצליחה, בחלון מופיעים חשבון Telegram מחובר ו-"… מחובר. הודעות שתשלחו ממנו יוצאות דרך Telegram."

עם קוד התחברות#

השתמשו בדרך הזו כשאי אפשר לסרוק קוד QR, למשל כשהטלפון הוא המכשיר היחיד שלכם.

בחירה בקוד התחברות
בחלון הוספת חשבון Telegram, לחצו על הלשונית קוד התחברות.
הזנת המספר
בדקו את המדינה שלכם תחת קידומת מדינה. תחת מספר הטלפון של חשבון Telegram, הקלידו את המספר שחשבון ה-Telegram שלכם משתמש בו, בלי קידומת המדינה, למשל 9876543210. לחצו על שליחת קוד התחברות.
הקלדת הקוד
Telegram שולח קוד התחברות לאפליקציית Telegram שלכם (או ב-SMS). בחלון הזינו את קוד ההתחברות, הקלידו אותו תחת קוד התחברות ולחצו על התחברות. אז מופיע בחלון חשבון Telegram מחובר.

אימות דו-שלבי#

אם בחשבון שלכם מופעל אימות דו-שלבי, אחרי קוד ה-QR או קוד ההתחברות החלון מבקש את סיסמת ה-Telegram שלו: הזינו את הסיסמה של Telegram. הקלידו את סיסמת ה-Telegram (סיסמת הענן) שלכם תחת סיסמת Telegram ולחצו על התחברות. ‏Wbiztool משתמשת בה פעם אחת כדי להתחבר ולעולם לא שומרת אותה.

אחרי החיבור#

החשבון מקבל כרטיס בדף מספרים עם התגית Telegram והמזהה שלו, לדוגמה מזהה 702. לחצו על המזהה כדי להעתיק אותו: השתמשו בו כ-whatsapp_client ב-API, כמו במספר.
לחצו על שליחת הודעת בדיקה כדי לוודא שהחשבון שולח. תחת שליחה אל, הקלידו שם משתמש (‎@username) או מספר טלפון עם קידומת המדינה, למשל ‎@name או ‎+91 98765 43210.
שינוי שם והסרה עובדים כמו במספר WhatsApp. ראו ניהול מספר.

שליחה מחשבון ה-Telegram שלכם#

בחרו את חשבון ה-Telegram כמו כל מספר: תחת מאת בשליחה מהירה, כמספר השולח של קמפיין או של תזכורת, או עם המזהה שלו כ-whatsapp_client ב-API. ההודעות שלו מופיעות בדוחות, וה-webhook של שליחת הודעה מדווח SENT או FAILED כמו ב-WhatsApp.

curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 702,
    "phone": "@emma_thompson",
    "msg": "Hi Emma, your order #4821 has shipped and will arrive on Thursday."
  }'

החליפו את 12345, YOUR_API_KEY ו-702 בערכים שלכם: 702 הוא המזהה של חשבון ה-Telegram מהכרטיס שלו.

למי אפשר לשלוח#

מחשבון Telegram, ‏phone ב-API (וגם המספרים בשליחה מהירה, המספרים של קמפיין והשדה שליחה אל של תזכורת) מקבל כל אחד מאלה:

מה כותבים	דוגמה	כדאי לדעת
מספר טלפון עם קידומת המדינה	‎`+91 98765 43210`	האדם חייב להיות ב-Telegram. בפעם הראשונה, המספר נוסף לאנשי הקשר של החשבון ב-Telegram. ‏Telegram דוחה אנשים שמסתירים את המספר שלהם מזרים: ההודעה נכשלת עם "Not on Telegram, or their privacy settings hide this number".
שם משתמש (‎@username)	‎`@emma_thompson`	שם המשתמש של האדם ב-Telegram.
קישור ‎t.me	`t.me/emma_thompson`	כמו שם המשתמש. גם `https://t.me/emma_thompson` עובד.
`tg:<id>`	`tg:5012345678`	כך תיבת ההודעות וה-Webhooks שלה מציינים אדם שלא מציג מספר ולא שם משתמש. השתמשו בזה כדי להשיב לו.

שמות משתמש, קישורי ‎t.me ו-tg:<id> עובדים רק מחשבון Telegram. ממספר WhatsApp, שליחת הודעה ותזמון הודעה עונים "Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client", ושליחה למספרים מרובים מדלג עליהם.

איזה חשבון ה-API בוחר#

כשלא שולחים whatsapp_client, שליחת הודעה משתמש במספר המחובר היחיד, WhatsApp קודם:

אם מחובר מספר WhatsApp אחד, הוא זה שמשמש, גם אם מחובר גם חשבון Telegram. הוספה של חשבון Telegram לא מעבירה אליו את האינטגרציות הקיימות שלכם.
חשבון Telegram משמש רק כשאין מספר WhatsApp מחובר.
שם משתמש (‎@username) משתמש בחשבון ה-Telegram המחובר היחיד.

כדי לשלוח מחשבון ה-Telegram בכל מקרה אחר, העבירו את המזהה שלו כ-whatsapp_client.

קבוצות#

מחשבון Telegram, ‏group_name (וגם קבוצות בשליחה מהירה) מקבל:

את שם המשתמש (‎@username) או את קישור ה-‎t.me של קבוצה ציבורית, למשל ‎@lumen_club או t.me/lumen_club, או
את השם המדויק של קבוצה או ערוץ שהחשבון חבר בהם, למשל Lumen VIP Club. אין הבדל בין אותיות גדולות לקטנות.

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

אם אף קבוצה לא מתאימה, ההודעה נכשלת עם "Group not found".
אם החשבון לא יכול לפרסם בקבוצה, ההודעה נכשלת עם "This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)".

המגבלות של Telegram#

Telegram מגביל לכמה אנשים שלא פנו לחשבון מותר לו לשלוח הודעות. חשבונות חדשים מוגבלים יותר מכולם.

כש-Telegram מבקש להאט, החשבון עוצר לזמן מה וההודעות שלו ממתינות. הן יוצאות אחרי ההפסקה.
כש-Telegram מגביל הודעות לזרים, ההודעה הזו נכשלת עם "Telegram limited this account: it can't message people who haven't contacted it for now. Sending resumes in an hour", והחשבון נח למשך שעה.

תיבת ההודעות (Unibox)#

אפשר להוסיף חשבון Telegram לתיבת ההודעות Unibox כמו מספר: בדף מספרים בתיבת ההודעות, לחצו על הוספת מספר לתיבת ההודעות ובחרו אותו. הוא תופס אחד ממספרי תיבת ההודעות של תוסף ה-Unibox שלכם, כמו מספר WhatsApp.

הצ׳אטים הפרטיים שלו מופיעים בתיבת ההודעות: הודעות שהוא מקבל, והודעות שנשלחו מהטלפון או דרך Wbiztool. ליד צ׳אטים מ-Telegram מופיע סמל של Telegram.
קבצים של עד 16 MB מועתקים לתיבת ההודעות.
אפשר להשיב גם לאנשים שמסתירים את המספר שלהם.
קבוצות, ערוצים, ההודעות השמורות (Saved Messages) והצ׳אט של שירות Telegram עצמו (זה עם קודי ההתחברות) אף פעם לא מוצגים.

ה-Webhook של חשבון בתיבת ההודעות שולח את ההודעות שלו כמו של מספר. במטען, platform מוגדר ל-telegram, ו-contact.phone ו-message.from הם המספר של האדם, ה-‎@username שלו או tg:<id>: שלחו את התשובה לערך הזה כ-phone. ראו מטען ה-Webhook.

ניתוק או חיבור מחדש#

ניתוק בכרטיס מפסיק את השליחה מהחשבון. הוא גם מוציא את Wbiztool מרשימת המכשירים של החשבון ב-Telegram.
אם Telegram מסיים את הסשן, למשל כשאתם מנתקים את Wbiztool תחת הגדרות ← מכשירים, או כשהחשבון מנותק מכל המכשירים, בכרטיס מופיע לא מחובר. בעלים ועורכים מקבלים התראה על ניתוק בנוסח של Telegram, כמו במספר WhatsApp. ראו התראות על ניתוק WhatsApp.
כל עוד החשבון לא מחובר, ההודעות שלו ממתינות תחת ממתינות לשליחה.
כדי לחבר אותו שוב, לחצו על חיבור מחדש בכרטיס שלו והתחברו שוב, עם קוד QR או קוד התחברות.

עדיין לא זמין#

ייצוא החברים של קבוצות Telegram. ייצוא חברי קבוצה עובד רק בקבוצות WhatsApp.
קבוצות Telegram בתיבת ההודעות Unibox. רק צ׳אטים פרטיים מופיעים שם.

פתרון בעיות#

בעיה	מה לעשות
אין כפתור הוספת חשבון Telegram	אתם אנליסטים בסביבת העבודה הזו. בקשו מאחד הבעלים לעשות זאת או להפוך אתכם לעורכים.
הוספת חשבון Telegram אפור	העבירו את העכבר מעליו כדי לראות למה: כתובת האימייל שלכם לא אומתה, כל מקומות המספרים בתוכנית תפוסים, או שיש תשלום באיחור. חלים אותם כללים כמו במספרים, ראו מגבלת מספרים.
קוד ה-QR לא עובד	הוא מתחלף כל 30 שניות: סרקו את החדש ביותר, ב-Telegram תחת הגדרות ← מכשירים ← הוספת מכשיר. אם בחלון כתוב "ההתחברות נמשכה יותר מדי זמן. התחילו מחדש.", לחצו על התחלה מחדש.
"הקוד הזה שגוי. בדקו את הקוד האחרון ש-Telegram שלח ונסו שוב."	הקלידו את קוד ההתחברות החדש ביותר מאפליקציית Telegram (או מה-SMS).
"תוקף הקוד פג. התחילו מחדש כדי לקבל קוד חדש."	לחצו על התחלה מחדש והקלידו את הקוד החדש.
"הסיסמה הזו שגויה. נסו שוב."	הקלידו את סיסמת ה-Telegram של החשבון מהאימות הדו-שלבי, לא את קוד ההתחברות.
"למספר הזה אין חשבון Telegram."	בדקו את המדינה ואת המספר, או התחברו עם קוד QR.
"Telegram מבקש להמתין לפני ניסיון נוסף. נסו שוב מאוחר יותר."	חכו זמן מה, ואז התחברו שוב.
נכשלה עם "Not on Telegram, or their privacy settings hide this number"	האדם לא ב-Telegram, או שהוא מסתיר את המספר שלו מאנשים שהוא לא מכיר. שלחו במקום זאת לשם המשתמש שלו (‎@username), או בקשו ממנו לכתוב קודם לחשבון שלכם והשיבו מתיבת ההודעות.
נכשלה עם "Group not found"	בדקו את השם המדויק של הקבוצה, או השתמשו בשם המשתמש (‎@username) או בקישור ה-‎t.me שלה. החשבון חייב להיות חבר בקבוצה.
נכשלה עם "This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)"	הצטרפו קודם לקבוצה ב-Telegram עם החשבון הזה. אם רק מנהלים יכולים לפרסם, פנו למנהל של הקבוצה.
נכשלה עם "Telegram limited this account: …"	ראו המגבלות של Telegram. השליחה מתחדשת אחרי שעה.
ה-API עונה "Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client"	העבירו את המזהה של חשבון ה-Telegram כ-`whatsapp_client`. ראו איזה חשבון ה-API בוחר.
בכרטיס מופיע לא מחובר	Telegram סיים את הסשן. לחצו על חיבור מחדש והתחברו שוב.