POST/api/public/consultation

รับคำขอรับคำปรึกษาจากฟอร์มของเว็บไซต์ Zentor App

ช่องที่จำเป็นได้แก่ `name` (2–120 ตัวอักษร), `email` (อีเมลที่ถูกต้อง), และ `consentGiven` ที่ต้องตั้งเป็น `true` สามารถส่ง `company`, `phone`, และ `message` เพิ่มเติมได้แบบไม่บังคับ เมื่อสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วย `{"ok":true}` และข้อความยืนยัน หลังจากนั้นทีม Zentor จะติดต่อกลับ หากช่องที่จำเป็นหายไปหรือไม่ถูกต้อง หรือความยินยอมหายไป เอนด์พอยต์จะตอบกลับด้วย 400 `VALIDATION_ERROR` การเรียกที่สำเร็จแต่ละครั้งจะสร้างคำขอใหม่ ดังนั้นการเรียกนี้จึงไม่ใช่ idempotent สูงสุด 10 คำขอต่อ 15 นาทีต่อที่อยู่ IP นอกจากนี้ยังมีกฎการเข้าถึงของ Zentor (กฎ IP ประเทศ และโดเมนอีเมล) บังคับใช้ด้วย การเรียกที่ถูกปฏิเสธจะได้รับ 403

ภาพรวม

การเรียกใช้: POST /api/public/consultation เอนด์พอยต์นี้อยู่ในกลุ่ม “ฟอร์มสาธารณะ” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้ไม่เป็นแบบ idempotent: การเรียกที่สำเร็จแต่ละครั้งจะทริกเกอร์การดำเนินการใหม่อีกครั้ง พารามิเตอร์ที่จำเป็น: name (body), email (body), consentGiven (body) พารามิเตอร์ที่ไม่บังคับ: company (body), message (body), phone (body) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 400 VALIDATION_ERROR ตัวอย่างการตอบกลับด้านล่างแสดงโครงสร้างของการตอบกลับที่สำเร็จในรูปแบบ JSON

การยืนยันตัวตนและความปลอดภัย

ไม่ต้องยืนยันตัวตน

Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ไม่

พารามิเตอร์

name(body, string, จำเป็น)— ชื่อ 2–120 ตัวอักษร
email(body, string, จำเป็น)— อีเมลที่ถูกต้อง
company(body, string)— บริษัท (ไม่บังคับ)
message(body, string)— ข้อความ (ไม่บังคับ)
phone(body, string)— หมายเลขโทรศัพท์ (ไม่บังคับ)
consentGiven(body, boolean, จำเป็น)— ความยินยอมด้านความเป็นส่วนตัว ต้องเป็น `true`

ตัวอย่างคำขอ

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"เรื่องที่ต้องการติดต่อ","consentGiven":true}

ตัวอย่างการตอบกลับ

{"ok":true,"message":"คำขอคำปรึกษาของคุณได้รับการส่งเรียบร้อยแล้ว เราจะติดต่อกลับในเร็วๆ นี้"}

รหัสข้อผิดพลาด

400 VALIDATION_ERROR — ช่องที่จำเป็นหายไปหรือไม่ถูกต้อง หรือความยินยอมหายไป

พฤติกรรมที่ตรวจสอบแล้ว

ข้อมูลที่สมบูรณ์จะได้รับ 200 ข้อมูลที่หายไปหรือไม่ถูกต้องจะได้รับ 400 `VALIDATION_ERROR`

ฟอร์มสาธารณะ

POST /api/public/contactรับคำขอจากฟอร์มติดต่อของเว็บไซต์ Zentor App และส่งต่อให้ทีม ZentorPOST /api/public/access-requestส่งคำขอเข้าถึงสำหรับแพ็กเกจ (Starter, แบบกำหนดเอง หรือ Demo 14 วัน) เงื่อนไขก่อนคือต้องมีอีเมลที่ยืนยันไว้ก่อนแล้วPOST /api/public/access-request/email/start-verificationส่งโค้ดยืนยัน 6 หลักที่มีอายุ 10 นาทีไปยังอีเมลที่ระบุ – ขั้นตอนแรกของคำขอเข้าถึงPOST /api/public/access-request/email/verifyตรวจสอบโค้ดที่ส่งผ่านอีเมล และออกโทเค็นยืนยันสำหรับคำขอเข้าถึงที่จะดำเนินการต่อไปGET /api/public/access-request/payment-statusระบุว่าวิธีการชำระเงินใด (PayPal, Stripe) พร้อมใช้งานในขณะนี้สำหรับคำขอเข้าถึงGET /api/public/access-request/paypal/configส่งคืนการตั้งค่า PayPal สาธารณะ (เปิดใช้งาน โหมด สกุลเงิน) สำหรับขั้นตอนการชำระเงินPOST /api/public/access-request/paypal/create-orderสร้างคำสั่งซื้อ PayPal สำหรับแพ็กเกจที่เลือกPOST /api/public/access-request/paypal/capture-orderดำเนินการให้เสร็จสิ้น (capture) คำสั่งซื้อที่สร้างไว้ก่อนหน้าและได้รับการอนุมัติจากผู้ซื้อในหน้าชำระเงินของ PayPal จำนวนเงินกำหนดโดยเซิร์ฟเวอร์เท่านั้นPOST /api/public/access-request/stripe/create-checkoutสร้างเซสชันการชำระเงิน Stripe สำหรับแพ็กเกจที่เลือกPOST /api/public/activate-accountเปิดใช้งานบัญชีผู้ใช้ที่สร้างขึ้นใหม่และตั้งรหัสผ่านแรก – เริ่มต้นจากลิงก์ในอีเมลคำเชิญ

บทความที่เกี่ยวข้อง

สร้างแบบฟอร์มในแชทบอทใช้ตัวสร้างแบบฟอร์มที่เมนูแชทบอท → แบบฟอร์ม เพื่อสร้างแบบฟอร์มของคุณเองที่กำหนดค่าได้อย่างอิสระ ซึ่งแชทบอทจะสอบถามอัตโนมัติระหว่างการสนทนาทำความเข้าใจการเข้าสู่ระบบและวิธีการเชื่อมต่อวิธีเข้าสู่ระบบอย่างปลอดภัย – และสามวิธีในการเชื่อมต่อ Zentor App กับระบบของคุณ
← ฟอร์มสาธารณะ