การลงทะเบียนคอร์ส

register_customer_on_course(tariff_id, email, email_notification, period, reregistration)

ตัวอย่าง: register_customer_on_course(123, email, 1, "", True)

เพื่อให้ลูกค้าได้รับอีเมล ให้ส่งค่า 1 ไปยังพารามิเตอร์ email_notification

หากคุณไม่ส่งค่า 1 ลูกค้าจะไม่ได้รับอีเมล!

ฉันจะให้สิทธิ์เข้าถึงคอร์สผ่าน Telegram Web App ได้อย่างไร?

ในการนี้ ให้ระบุฟังก์ชันใน Block Calculator

access_course_from_webapp(text, button_label)
เมื่อใช้ฟังก์ชันนี้ นักเรียนจะเข้าสู่ระบบ Telegram และได้รับสิทธิ์เข้าถึงคอร์ส สำหรับการเรียนรู้เพิ่มเติม นักเรียนไม่จำเป็นต้องป้อนชื่อผู้ใช้และรหัสผ่าน เนื่องจากการยืนยันตัวตนเสร็จสมบูรณ์แล้ว

พารามิเตอร์ของฟังก์ชัน:

text - คือข้อความที่ลูกค้าจะได้รับ พารามิเตอร์สามารถระบุในตัวแปรโดยเขียนในฟิลด์ Calculator ก่อนเรียกใช้ฟังก์ชัน หรือระบุในฟังก์ชันเองในเครื่องหมายคำพูด

button_label - คือข้อความบนปุ่ม Web App คุณสามารถระบุพารามิเตอร์ในตัวแปรหรือในฟังก์ชันเอง ในกรณีที่สอง พารามิเตอร์จะถูกเขียนในเครื่องหมายคำพูด

เกี่ยวข้องเฉพาะเมื่อทำงานกับบอท Telegram เท่านั้น

ภาพหน้าจอด้านล่างแสดงตัวอย่างการใช้ฟังก์ชัน
ในขั้นตอนแรก เราลงทะเบียนลูกค้าสำหรับคอร์ส จากนั้นใช้ฟังก์ชัน access_course_com_webapp เพื่อให้สิทธิ์เข้าถึงผลิตภัณฑ์ออนไลน์

ผลลัพธ์ของการเรียกใช้ฟังก์ชัน:

ปุ่มนี้จะเปิดหน้าเว็บที่มีคอร์ส/แผนราคาที่นักเรียนมี

หากลูกค้าไม่ได้เชื่อมโยงกับบัญชีนักเรียน ฟังก์ชันจะส่งคืน 'client not attached to customer'

ในการสร้างการเชื่อมต่อนี้ คุณเพียงแค่ต้องลงทะเบียนคอร์สผ่านบอท

วิธีให้สิทธิ์เข้าถึงคอร์สผ่านบอท

register_customer_on_course()

ในการนี้ ให้ระบุฟังก์ชันใน Block Calculator

register_customer_on_course(tariff_id, email, email_notification, period)

พารามิเตอร์ที่จำเป็น พารามิเตอร์เสริม
! tariff_id - รหัสของแผนราคา คุณสามารถคัดลอกได้จากแถบเบราว์เซอร์ในการตั้งค่าแผนราคา email_notification - พารามิเตอร์นี้ส่งข้อความอีเมลถึงนักเรียนเกี่ยวกับการลงทะเบียนคอร์ส หากเปิดใช้งาน
! email - ที่อยู่อีเมลของลูกค้า คุณสามารถระบุค่าเฉพาะหรือตัวแปรที่บันทึกอีเมลของลูกค้าไว้ period - ข้อจำกัดเวลาสำหรับความถูกต้องของแผนราคา รูปแบบวันที่ที่รองรับ: %d.%m.%Y %H:%M หรือ %d.%m.%Y ตัวอย่าง: period = '15.08.2023 11:00'

เพื่อให้ลูกค้าได้รับอีเมล คุณต้องส่งค่า 1 ในพารามิเตอร์ email_notification

หากคุณไม่ส่งค่า 1 ลูกค้าจะไม่ได้รับอีเมล!

กำหนดฟังก์ชันให้กับตัวแปร

หลังจากการดำเนินการ หนึ่งในคำตอบจะถูกเขียนลงในตัวแปร:

customer is already on tariff - หากมีแผนราคาหรือสิทธิ์ถูกปิดด้วยตนเอง

wrong_tariff_id - ระบุรหัสที่ไม่ถูกต้อง

tariff_added - แผนราคาถูกเพิ่มให้กับนักเรียน

ตัวอย่าง:

วิธีตรวจสอบความพร้อมในการเข้าถึงคอร์ส

has_customer_tariff(tariff_id)

ในการนี้ ให้ระบุฟังก์ชันใน Block Calculator has_customer_tariff(tariff_id, email)

พารามิเตอร์ที่จำเป็น พารามิเตอร์เสริม
! tariff_id - รหัสของแผนราคา คุณสามารถคัดลอกได้จากแถบเบราว์เซอร์ในการตั้งค่าแผนราคาหรือในส่วนแผนราคา email - พารามิเตอร์เสริม ส่งพารามิเตอร์นี้เพื่อตรวจสอบว่าลูกค้าลงทะเบียนคอร์สด้วยที่อยู่อีเมลที่ระบุหรือไม่

หลังจากการดำเนินการ ฟังก์ชันจะส่งคืน True หรือ False

คำตอบที่เป็นไปได้ของฟังก์ชันในกรณีที่เกิดข้อผิดพลาด:

wrong tariff_id - ค่าที่ส่งไปยัง tariff_id ไม่ถูกต้อง

customer not found - ผู้ใช้ไม่ได้ลงทะเบียนเป็นนักเรียน

วิธีลงทะเบียนลูกค้าบนแพลตฟอร์มโดยไม่ให้สิทธิ์เข้าถึงคอร์ส

register_customer(email)

ในการนี้ ให้ระบุฟังก์ชันใน Block Calculator register_customer(email)

พารามิเตอร์ของฟังก์ชัน คำอธิบาย
! email ที่อยู่อีเมลของลูกค้า

คุณสามารถระบุตัวแปรในฟังก์ชันหรือค่าพารามิเตอร์ ในการระบุตัวแปร ให้เขียนชื่อโดยไม่มีเครื่องหมายคำพูดและเครื่องหมายไวยากรณ์ ตาราง และวงเล็บปีกกา ในการระบุค่าเฉพาะ ให้ระบุที่อยู่อีเมลของลูกค้าในเครื่องหมายคำพูด

ขอแนะนำให้กำหนดตัวแปรให้กับฟังก์ชัน เพื่อให้คุณสามารถดูผลลัพธ์ของฟังก์ชันและทำงานกับมันได้ ตัวอย่างในภาพหน้าจอด้านล่าง: ชื่อตัวแปรถูกตั้งค่าก่อนเครื่องหมายเท่ากับ ตามด้วยฟังก์ชันและพารามิเตอร์ในวงเล็บ

หลังจากการดำเนินการฟังก์ชันสำเร็จ คำตอบจะถูกเขียนลงในตัวแปร:
customer created

วิธีตรวจสอบสิทธิ์เข้าถึงคอร์สและข้อจำกัดเวลา?

ในการนี้ ให้ระบุฟังก์ชันใน Block Calculator has_customer_tariff_with_date(tariff_id, email) เพื่อตรวจสอบความพร้อมในการเข้าถึงคอร์สตามอีเมล (ส่งคืนคำตอบโดยละเอียดเกี่ยวกับความพร้อมในการเข้าถึงและข้อจำกัดเวลา)

พารามิเตอร์ของฟังก์ชัน:

พารามิเตอร์ที่จำเป็น พารามิเตอร์เสริม
! tariff_id - รหัสของแผนราคา คุณสามารถคัดลอกได้จากแถบเบราว์เซอร์ในการตั้งค่าแผนราคาหรือในส่วนแผนราคา email - พารามิเตอร์เสริม

คำตอบจะเป็น:

  • นักเรียนลงทะเบียนแล้วและมีข้อจำกัดเวลาในการเข้าถึง: มีสิทธิ์เข้าถึงจนถึง 2023-09-28 22:00:00
  • นักเรียนลงทะเบียนแล้ว ไม่มีข้อจำกัด: มีสิทธิ์เข้าถึงโดยไม่มีข้อจำกัดเวลา
  • นักเรียนไม่ได้ลงทะเบียน: ไม่มีสิทธิ์เข้าถึงแผนราคานี้

คำตอบที่เป็นไปได้ของฟังก์ชันในกรณีที่เกิดข้อผิดพลาด:

wrong tariff_id - ค่าที่ส่งไปยัง tariff_id ไม่ถูกต้อง

customer not found - ผู้ใช้ไม่ได้ลงทะเบียนเป็นนักเรียน

วิธีลบสิทธิ์เข้าถึงคอร์สของนักเรียนผ่านบอท

del_customer_from_course(course_id, email)

ในการนี้ ให้ระบุฟังก์ชันใน Block Calculator del_customer_from_course(course_id, email)

พารามิเตอร์ คำอธิบาย
! tariff_id รหัสแผนราคา
! email ที่อยู่อีเมลของลูกค้า

วิธีตรวจสอบว่านักเรียนเข้าร่วมเว็บินาร์หรือไม่

customer_was_on_translation()

ต้องให้สิทธิ์เข้าถึงคอร์สในบอท

มีฟังก์ชันสำหรับสิ่งนี้ register_customer_on_course() และ access_course_from_webapp()

ในการตรวจสอบว่านักเรียนเข้าร่วมเว็บินาร์หรือไม่ ให้ระบุฟังก์ชันใน Block Calculator customer_was_on_translation(translation_guid, email, after_start_time)

พารามิเตอร์ที่จำเป็น พารามิเตอร์เสริม
! translation_guid - รหัสการถ่ายทอดสด คัดลอกค่าฟิลด์ ชื่ออยู่ในลิงก์การตั้งค่าการถ่ายทอดสด after_start_time - เวลาเริ่มต้นของการถ่ายทอดสดในรูปแบบ: '2023-04-18 13:30:00'
! email - ที่อยู่อีเมลของนักเรียน

โปรดทราบ! ชื่อของตัวแปรสามารถเป็นชื่อใดก็ได้ที่สะดวกและเข้าใจสำหรับคุณ ในกรณีที่เกิดข้อผิดพลาดในการเขียนพารามิเตอร์ของฟังก์ชัน ข้อความจะถูกเขียนลงในตัวแปร: wrong translation_guid

ในกรณีนี้ เราขอแนะนำให้ตรวจสอบพารามิเตอร์ของฟังก์ชันและทดสอบอีกครั้ง เพื่อรับค่าระยะเวลาที่อยู่ในเว็บินาร์จากตัวแปรใน Calculator คุณสามารถใช้ฟังก์ชันการทำงานกับอาร์เรย์และพจนานุกรม อาร์เรย์ และ พจนานุกรม

ตัวอย่างการตั้งค่าใน Block Calculator:

time_spent1 = answer2[0]['time_spent']

วิธีค้นหาชื่อนักเรียนที่เชื่อมโยงกับบอท?

มีกรณีที่นักเรียนอาจเชื่อมโยงกับแชทออนไลน์ของบัญชีส่วนตัวของนักเรียน รวมถึงผู้ที่เชื่อมโยงกับแอปส่งข้อความและเขียนถึงหัวหน้างานของคุณผ่านบอท เพื่อออกใบรับรองการสำเร็จคอร์สที่มีชื่อในบอทอย่างถูกต้องและไม่ต้องค้นหาชื่อนักเรียนในรายการ จึงมีฟังก์ชัน:

get_customer_name() - ส่งคืนชื่อของนักเรียนที่เชื่อมโยงกับลูกค้า

ฟังก์ชันที่ไม่มีพารามิเตอร์

ส่งคืนชื่อนักเรียนที่นักเรียนป้อนระหว่างการลงทะเบียนคอร์ส หรือชื่อนักเรียนจากบัญชีส่วนตัวของพวกเขา