בונים בוטים ל-Qivuna
בוט ב-Qivuna הוא חשבון שהשרת שלכם מפעיל. אנשים מדברים איתו ביחידות, ומנהלי קבוצות וערוצים יכולים להוסיף אותו עם ההרשאות שהם בוחרים. בוטים מוצפנים מקצה לקצה מתוארים בתיעוד, אבל עוד לא פתוחים.
בהשקה: long polling בלבד
הבוטים מקבלים עדכונים דרך getUpdates (long polling). Webhooks ובוטים מוצפנים מתוארים בתיעוד, אבל עוד לא פתוחים: setWebhook מחזיר 400 webhooks_disabled, וכל בוט חדש נוצר כבוט רגיל, לא מוצפן מקצה לקצה. התיעוד המלא כתוב באנגלית ומתאר את Bot API 1.0.
מה שונה כאן#
- בוטים אינם חברים בחדר. מנהל מוסיף בוט עם רשימת הרשאות מפורשת. כל שינוי יוצר אישור הסכמה שאי אפשר לערוך, ושורה גלויה בחדר. בוטים לא מופיעים ברשימת החברים.
- מצב פרטיות פעיל כברירת מחדל. בקבוצה הבוט רואה רק פקודות, אזכורים שלו ותגובות להודעות שלו — אלא אם מצב הפרטיות שלו כבוי וגם מנהל של קבוצה ציבורית אישר לו „קריאת כל ההודעות“.
- בוטים לעולם לא רואים מספרי טלפון. אנשים מופיעים אצל הבוט במזהים שונים לכל מפתח, עם השם שחברי חדר משותף כבר רואים.
- בוטים מוצפנים (עוד לא פתוחים). בבוט מוצפן, ההודעות מוצפנות כבר בטלפון של השולח, למפתח שנמצא רק בשרת של הבוט. השרת של Qivuna מעביר אותן ואינו יכול לקרוא אותן — אבל מי שמפעיל את הבוט כן יכול, והאפליקציה אומרת זאת במפורש.
- הטוקן נשלח רק בכותרת, אף פעם לא בכתובת. טוקן שמופיע ב-URL מבוטל מיד.
איך מתחילים#
- פותחים את @qivbot באפליקציה ושולחים /newbot. צריך חשבון בן שבעה ימים לפחות, אימות דו-שלבי עם אפליקציית אימות או סיסמה נוספת (קוד SMS לא מספיק), והסכמה לתנאי המפתחים.
- בוחרים שם ושם משתמש שמסתיים ב-bot. בשלב הזה כל בוט חדש הוא בוט רגיל, לא מוצפן.
- מציגים את הטוקן במסך המאובטח ושומרים אותו במשתנה סביבה.
- מריצים בוט הד (echo) עם ערכת הפיתוח ל-Node.js או ל-Python, ב-long polling. ההוראות במדריך ההתחלה (באנגלית).
בוט חדש נמצא במצב פיתוח: כל מי שיש לו את הקישור יכול להתחיל איתו שיחה, אבל אפשר להוסיף אותו רק לקבוצות שלכם עם עד עשרה חברים, והוא לא מופיע בחיפוש. כשיש לו תיאור ולפחות פקודה אחת, מפרסמים אותו מ-QivBot.
התיעוד (באנגלית)#
- Getting startedCreate a bot, get the token, run an echo bot.
- ConceptsGrants, consent, privacy mode, ids.
- API referenceEvery method, parameter and error.
- Encrypted botsNot open yet. The honest security model.
- WebhooksNot open yet. Challenge, signatures, retries.
- SDKsNode.js, Python, test vectors.
יצירת קשר#
שאלות ותקלות: support@qivuna.com. צרפו את שם המשתמש של הבוט ואת ה-request_id של הקריאה שנכשלה. לעולם אל תשלחו את הטוקן — אף אחד ב-Qivuna לא יבקש אותו.