POST/api/public/contact

รับคำขอจากฟอร์มติดต่อของเว็บไซต์ Zentor App และส่งต่อให้ทีม Zentor

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

ภาพรวม

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

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

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

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

พารามิเตอร์

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

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

{"name":"Max Mustermann","email":"max@example.com","message":"ข้อความของคุณ (อย่างน้อย 10 ตัวอักษร)","consentGiven":true}

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

{"ok":true,"message":"คำขอของคุณได้รับการส่งเรียบร้อยแล้ว"}

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

400 VALIDATION_ERROR — ช่องที่จำเป็นหายไปหรือไม่ถูกต้อง หรือความยินยอมด้านความเป็นส่วนตัวหายไป `details` มีรายการข้อผิดพลาดแต่ละรายการ

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

ข้อมูลที่สมบูรณ์จะได้รับ 200 ช่องที่จำเป็นหรือการยินยอมที่หายไปจะได้รับ 400 `VALIDATION_ERROR`

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

POST /api/public/consultationรับคำขอรับคำปรึกษาจากฟอร์มของเว็บไซต์ Zentor AppPOST /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 กับระบบของคุณ
← ฟอร์มสาธารณะ