成果範例
Telegram bot for booking haircuts at a barbershop
The bot in Telegram
A part of the code
async def booking_done(update: Update, context: ContextTypes.DEFAULT_TYPE) -> int:
"""The last step of the form: thanks the client and passes the request on."""
request = context.user_data["booking"]
request["phone"] = update.message.text.strip()
await update.message.reply_text(TEXTS["booking_thanks"], reply_markup=main_menu())
await context.bot.send_message(settings.admin_chat_id, format_request(request))
sheet.append_row([datetime.now().isoformat(timespec="minutes"), *request.values()])
return ConversationHandler.END
All the answers and buttons are in texts.yaml, so the client changes a price or the hours without touching the code.
Files: a ZIP archive with bot.py, texts.yaml, settings.example.env (where the bot token and the sheet go, filled in by the client), requirements.txt and a README: creating the bot in Telegram, connecting the Google Sheet and running it on a small server or hosting. The bot sends the request but does not check the barbers' calendar: the owner confirms the time.
Client: a barbershop with 3 barbers that took bookings only by phone. Task: a Telegram bot with a menu: prices, address and hours, a booking form (service, day and time, name, phone) that sends each request to the owner's chat and adds it to a Google Sheet.
客戶與所有細節皆為虛構。
關於此服務
抽獎活動需要公平的參加方式，以及讓人信服的抽獎過程。這個 Telegram 機器人用按鈕呈現您的規則、日期和獎品。標準版起，大家按一下按鈕或填寫簡短表單就能參加，每個 Telegram 帳號限參加一次，每位參加者都會送到您的聊天室和 Google 試算表。進階版會把參加者存在您伺服器上的小型資料庫，用管理員指令就能從符合規則（例如在截止日前參加）的人中隨機抽出一位或多位得獎者；接著機器人會把結果通知所有已啟用它的人。抽獎的規則、獎品和法律問題，包括在您舉辦的地方是否允許，都由您負責。機器人不寄送獎品、不收款，也只傳訊息給已啟用它的人。我們撰寫 Python 程式碼，以及一份 README，說明如何在 @BotFather 建立機器人，並在您的電腦、伺服器或主機空間上執行。架設和權杖都由您負責。
包含內容
- 您會得到一個 ZIP 壓縮檔，內含 Python 程式碼、放在獨立檔案中的規則和文字、一個設定檔範例和 README；程式碼也會顯示在訂單頁面上。
- 按一下就參加點一下，每個帳號限參加一次，標準版起提供
- 參加者試算表所有參加者都列在 Google 試算表中
- 隨機抽獎用管理員指令隨機抽出得獎者，進階版提供
- 套用您的規則機器人能檢查的規則（例如截止日）會在抽獎前套用
- 結果通知所有人發送給已啟用機器人的人，進階版提供
服務流程
- 1規則您提供規則、日期、獎品和參加方式
- 2程式碼我們撰寫機器人和執行說明
- 3上線您建立機器人、填入權杖、執行並分享它的連結
- 4修改您可在方案範圍內要求修改
需要您提供的資料
以文字提供抽獎規則：日期、參加資格、得獎人數及通知方式；完全依照應呈現方式描述的獎品；參加方式（按鈕，或含您問題的表單）；參加者要送到哪個聊天室；得獎者看到的領獎說明文字。請絕對不要傳送機器人的權杖或任何密碼：README 會說明您要自己把它們放在哪裡。
我們會詢問您：
- 抽獎規則
- 獎品
- 參加方式
- 參加者送到哪裡
比較方案
付款保障
下單時付款，但只有在驗收成果後，款項才會撥付。
- 固定價格付款後，方案價格不會變動。
- 款項先行保留付款時，金額只會先保留，在您驗收後才會撥付給服務。
- 交付前檢查每份成果在交到您手上之前都會經過品質檢查，您也可以在驗收前於訂單頁面查看成果。
- 免費修改在需求說明範圍內，可依方案允許的次數提出修改。
- 3 天後自動驗收若您在交付後 3 天內未驗收也未提出修改，成果將自動驗收。若您在交付後於訂單聊天室留言，訂單會暫停自動驗收；我們回覆後，可能會重新起算 3 天，並會在聊天室中告知。
- 重新製作或全額退款若成果不符合您的需求說明且修改後仍未改善，或製作時間超過交付期限的兩倍，請在訂單聊天室留言：我們將重新製作，或全額退還款項。
常見問題
得獎者是怎麼選出來的？
進階版用管理員指令：機器人會從符合它能檢查之規則（例如截止日和每個帳號限參加一次）的參加者中隨機抽出。結果會送到您的聊天室，並存在資料庫中。
它能檢查分享或留言嗎？
不行。它只檢查機器人裡發生的事：參加紀錄、日期和每個帳號限參加一次。其他條件請在公布得獎者前由您自行檢查。
誰要為抽獎規則負責？
您。規則、獎品、獎品的稅務，以及您的國家是否允許舉辦抽獎，都由您負責；機器人只收下參加紀錄，並依您提供的規則隨機抽出。
它能寄送獎品嗎？
不行。機器人不寄送獎品，也不收款。它可以向得獎者顯示您的領獎說明。
它在哪裡執行？
在您的電腦、伺服器或支援 Python 的主機空間上；權杖留在您手上。這是 Telegram 機器人；WhatsApp 不在這項服務範圍內。
沒有找到您要的答案？