# เอเจนซี ทีม และ API

วิธีที่เอเจนซีลงโฆษณาให้ลูกค้าบน Agilis ในชื่อของลูกค้าแต่ละราย บทบาทในทีม ยอดเงินคงเหลือและใบแจ้งหนี้ และวิธีใช้ Agilis REST API

**สรุปสั้น ๆ:** เอเจนซีลงทะเบียนเพียงครั้งเดียวในชื่อตามกฎหมายของตนเอง และลงโฆษณาให้ลูกค้าโดยกรอกชื่อของลูกค้าแต่ละรายในช่อง **ชื่อที่แสดงต่อสมาชิก** เอเจนซีเป็นผู้ชำระเงิน ถือยอดเงินคงเหลือ และรับใบแจ้งหนี้ นักพัฒนาสามารถสร้างและจัดการข้อเสนอและกิจกรรมผ่าน **Agilis REST API** (https://ads.agilis.dating) ด้วยคีย์ API จากพอร์ทัลโฆษณา คีย์ทดสอบใช้งานได้ฟรีและจะไม่แสดงต่อสมาชิกเลย

## สำหรับเอเจนซี

1. **ลงทะเบียนเอเจนซี** ในชื่อตามกฎหมายของเอเจนซีเอง → [วิธีลงทะเบียน](https://www.agilis.dating/th/business/guide/register)
2. เมื่อสร้างข้อเสนอหรือกิจกรรม ให้กรอก**ชื่อของลูกค้า**ในช่อง **ชื่อที่แสดงต่อสมาชิก** สมาชิกจะเห็นชื่อของลูกค้า ไม่ใช่ชื่อของคุณ
3. คุณต้องได้รับอนุญาตจากลูกค้าแต่ละรายก่อนลงโฆษณาให้ ข้อกำหนดการโฆษณากำหนดให้เอเจนซีเป็นผู้รับผิดชอบในเรื่องนี้

**ใครเป็นผู้ชำระเงิน และใครได้รับใบแจ้งหนี้**

- บัญชีของเอเจนซีเป็นผู้ชำระเงิน โดยใช้สกุลเงินสำหรับการเรียกเก็บเงินของเอเจนซี
- แต่ละคนในเอเจนซีมียอดเงินคงเหลือของตนเองและชำระเงินจากยอดนั้น ยอดเงินคงเหลือขององค์กรคือยอดรวมทั้งหมด → [ยอดเงินคงเหลือทำงานอย่างไร](https://www.agilis.dating/th/business/guide/pricing)
- ใบแจ้งหนี้และผลลัพธ์จะอยู่ในชื่อของเอเจนซี โดยออกใบแจ้งหนี้หนึ่งใบต่อการชำระเงินหนึ่งครั้ง คุณจึงเรียกเก็บเงินต่อจากลูกค้าแต่ละรายได้
- หากต้องการแยกค่าใช้จ่ายของลูกค้าแต่ละราย ให้ใช้ข้อเสนอหรือกิจกรรมหนึ่งรายการต่อลูกค้าหนึ่งราย และเรียกเก็บเงินต่อโดยอ้างอิงจากใบแจ้งหนี้ของรายการนั้น

## บทบาทในทีม

ผู้ดูแลองค์กรและผู้ลงโฆษณาทำงานในพอร์ทัลโฆษณา ส่วนนักพัฒนาทำงานผ่าน API นักพัฒนาไม่สามารถสร้างข้อเสนอหรือกิจกรรมในพอร์ทัลโฆษณาได้ แต่สามารถใช้คีย์ API ของตนสร้าง เผยแพร่ และชำระเงินสำหรับรายการเหล่านั้นผ่าน API ได้ และธุรกิจของคุณต้องรับผิดชอบต่อการใช้คีย์ของธุรกิจ ดูตารางฉบับเต็มได้ที่ [บทบาทและสิทธิ์ในทีม](https://www.agilis.dating/th/business/guide/getting-started)

## Agilis REST API

- **URL หลัก:** https://ads.agilis.dating
- **เอกสารอ้างอิง:** www.agilis.dating/api-doc พร้อมตัวอย่างใน cURL, Python, Node.js และ PHP รวมถึงผู้ช่วย API
- **รูปแบบที่เครื่องอ่านได้:** OpenAPI 3.1 ที่ www.agilis.dating/openapi.json, Markdown ที่ www.agilis.dating/api-doc.md และข้อความฉบับเต็มสำหรับเครื่องมือ AI ที่ www.agilis.dating/llms-full.txt
- **ข้อเสนอ:** ดูรายการหมวดหมู่และความสนใจ ประเมินราคาข้อเสนอก่อนสร้าง สร้าง ดูรายการ หยุดชั่วคราว เริ่มต่อ และลบข้อเสนอ อ่านผลลัพธ์ของข้อเสนอแต่ละรายการ
- **กิจกรรม:** ดูตัวอย่าง เผยแพร่ ดูรายการ แก้ไข เปลี่ยนกำหนดการ ยกเลิก และลบกิจกรรม อ่านผลลัพธ์ของกิจกรรมแต่ละรายการ

### รับคีย์ API

1. ลงชื่อเข้าใช้พอร์ทัลโฆษณาในฐานะผู้ดูแลองค์กรหรือนักพัฒนา
2. เลือก **โหมดทดสอบ** หรือโหมดใช้งานจริงด้วยสวิตช์ที่ด้านบนของหน้า
3. ไปที่ **คีย์ API** → **สร้างคีย์ใหม่** ตั้งชื่อคีย์ และกำหนดวันหมดอายุหากต้องการ
4. **คัดลอกคีย์ทันที** คุณจะไม่สามารถดูคีย์นี้ได้อีก

คีย์ทดสอบขึ้นต้นด้วย `pk_test_` ส่วนคีย์ใช้งานจริงขึ้นต้นด้วย `pk_live_` แต่ละคนมีคีย์ได้สูงสุด 10 คีย์ในแต่ละโหมด **เปลี่ยนคีย์** จะแทนที่คีย์ทันที ดังนั้นโปรดอัปเดตระบบของคุณก่อน ส่งคีย์ในส่วนหัวคำขอ `x-api-key`: `x-api-key: pk_test_…`

### พัฒนาอย่างปลอดภัย

- พัฒนาและทดสอบด้วยคีย์ `pk_test_` ข้อเสนอและกิจกรรมทดสอบใช้งานได้ฟรีและจะไม่แสดงต่อสมาชิกเลย
- ประเมินราคาข้อเสนอด้วยเอนด์พอยต์ประเมินราคาก่อนสร้าง
- อย่าเก็บคีย์ไว้ในที่เก็บโค้ดหรือในเบราว์เซอร์ และโปรดเรียกใช้ API จากเซิร์ฟเวอร์ของคุณ

## คำถามที่พบบ่อย

### เอเจนซีจัดการลูกค้าหลายรายจากบัญชีเดียวได้หรือไม่

ได้ ลงทะเบียนเอเจนซีเพียงครั้งเดียว แล้วระบุชื่อลูกค้าในข้อเสนอหรือกิจกรรมแต่ละรายการ

### ลูกค้าแต่ละรายมีใบแจ้งหนี้แยกของตนเองได้หรือไม่

ใบแจ้งหนี้จะออกให้เอเจนซีของคุณ หนึ่งใบต่อการชำระเงินหนึ่งครั้ง โปรดเรียกเก็บเงินต่อจากลูกค้าโดยอ้างอิงจากใบแจ้งหนี้เหล่านั้น

### มีสภาพแวดล้อมทดสอบ (แซนด์บ็อกซ์) หรือไม่

มี โหมดทดสอบที่ใช้คีย์ `pk_test_` เป็นแซนด์บ็อกซ์ที่ใช้งานได้ครบถ้วน ไม่มีการเรียกเก็บเงินใด ๆ และไม่มีสิ่งใดแสดงต่อสมาชิก

### เชื่อมต่อเครื่องมือเขียนโค้ด AI ได้หรือไม่

ได้ ชี้เครื่องมือของคุณไปที่ www.agilis.dating/api-doc.md หรือ www.agilis.dating/openapi.json

Source: https://www.agilis.dating/th/business/guide/agencies-and-api