# API และ AI เอเจนต์ · API and AI agents

> ที่มา: https://panyaplus.com/manual/th/16-api · คู่มือการใช้งาน Panya ฉบับภาษาไทย · ปรับปรุงล่าสุด 2026-10-23

เมื่อสมัคร **Premium** แล้ว AI เอเจนต์อย่าง Claude และ ChatGPT รวมถึงโปรแกรมของคุณเอง จะทำงานกับข้อมูลบัญชีของคุณผ่าน **Panya API** ได้ เช่น ถามเอเจนต์ว่า "ลูกค้าค้างชำระเราเท่าไร" ให้เอเจนต์บันทึกบิลผู้จำหน่ายกองโตเป็นร่าง หรือให้โปรแกรมบันทึกยอดขายออนไลน์ทุกวัน

โปรแกรมเชื่อมต่อด้วย **คีย์ API** ซึ่งทำงานในนามของสมาชิกผู้สร้างคีย์ เห็นเฉพาะกิจการที่สมาชิกคนนั้นเห็น และทำได้เท่าที่บทบาทของเขาอนุญาตเท่านั้น การตรวจสอบทุกอย่างที่ใช้ในแอปก็ใช้กับคีย์ด้วย ได้แก่ สิทธิ์ งวดที่ปิดแล้ว กฎการผ่านรายการ และประวัติการใช้งาน

บทนี้อธิบายเรื่องต่อไปนี้

- Premium และการสมัคร
- การสร้าง ใช้ และเพิกถอนคีย์ API
- การเชื่อมต่อ AI เอเจนต์ด้วย Panya skill
- สิ่งที่คีย์เข้าถึงได้และเข้าถึงไม่ได้
- ข้อความที่อาจพบ

## Premium

**Premium** · ที่ **ตั้งค่าองค์กร → แพ็กเกจ** และ **API และ AI เอเจนต์**

Premium ราคา **฿199 ต่อเดือน** สำหรับทั้งองค์กร ไม่ว่าจะมีกี่กิจการหรือสมาชิกกี่คน ประกอบด้วย

- Panya API สำหรับทุกกิจการในองค์กร
- คีย์ API สำหรับสมาชิกทุกคน แบบอ่านอย่างเดียวหรือแก้ไขได้
- Panya skill ที่สอน AI เอเจนต์ให้ใช้ Panya

ข้อมูลบัญชี แอป การส่งออกข้อมูล และ Panya AI ไม่ต้องใช้ Premium การใช้ Panya AI ผ่าน API ใช้เครดิต AI เช่นเดียวกับในแอป ดูเพิ่มเติมที่ [ผู้ดูแลองค์กร](https://panyaplus.com/manual/th/09-organization)

เฉพาะเจ้าขององค์กรเป็นผู้สมัคร

1. เปิด **ตั้งค่าองค์กร → API และ AI เอเจนต์** (หรือการ์ด **Premium** ในหน้า **แพ็กเกจ**)
2. คลิก **สมัคร · ฿199/เดือน**
3. เลือกวิธีชำระเงิน
   - **ชำระด้วยบัตร** จะเปิดหน้าชำระเงินของ Stripe และ Stripe จะตัดเงินทุกเดือน
   - **ชำระผ่านพร้อมเพย์** Stripe จะส่งใบแจ้งหนี้พร้อม QR พร้อมเพย์ทางอีเมล ครบกำหนดภายใน 7 วัน
4. เมื่อ Stripe ยืนยันการชำระเงิน การ์ดจะแสดง **ใช้งานอยู่** และวันต่ออายุ Premium

ยกเลิก Premium ได้ที่ **จัดการการชำระเงิน** ในแท็บ **แพ็กเกจ** โดยยังใช้ได้จนครบเดือนที่ชำระแล้ว หากชำระเงินไม่สำเร็จ การ์ดจะแจ้งเตือน และคีย์ API ยังใช้ได้อีก 7 วัน หลังจากนั้นจะหยุดทำงานจนกว่าจะชำระค่า Premium โดยไม่มีคีย์ใดถูกลบ

> **หมายเหตุ:** ระบบ Panya ที่ไม่ได้เปิดรับชำระเงินออนไลน์จะแสดงปุ่ม **ยืนยัน** แทนปุ่มชำระเงิน และ Premium จะเริ่มทันทีเป็นเวลาหนึ่งเดือน ส่วน Panya On-premises รวม API ไว้ในใบอนุญาตแล้ว การ์ดจะแสดง *รวมอยู่ในใบอนุญาต Panya On-premises ของคุณแล้ว*

## คีย์ API

**API keys** · **ตั้งค่าองค์กร → API และ AI เอเจนต์**

![แท็บ API และ AI เอเจนต์: Premium คีย์ API และวิธีเชื่อมต่อเอเจนต์](https://panyaplus.com/manual/th/images/api-keys.png)

การ์ด **คีย์ API** แสดงคีย์ของคุณ

| คอลัมน์ | ความหมาย |
|---|---|
| **ชื่อ** | ชื่อที่ตั้งให้คีย์ และอักษรขึ้นต้นของคีย์ เช่น `panya_sk_3f9a1c…` |
| **สิทธิ์** | **อ่านอย่างเดียว** หรือ **อ่านและแก้ไข** |
| **สมาชิก** | เฉพาะเจ้าของและผู้ดูแล: คีย์ของใคร |
| **ใช้ล่าสุด** | เวลาที่ใช้คีย์ครั้งล่าสุด หรือ *ยังไม่เคยใช้* |
| **หมดอายุ** | วันหมดอายุ *ไม่หมดอายุ* หรือ *เพิกถอน* พร้อมวันที่ |

สมาชิกเห็นคีย์ของตนเอง ส่วนเจ้าของและผู้ดูแลเห็นคีย์ของทุกคนและเพิกถอนได้

### สร้างคีย์

1. คลิก **สร้างคีย์ API…** ปุ่มนี้ใช้ได้เมื่อองค์กรมี Premium แล้ว
2. กรอก **ชื่อ** ที่บอกว่าจะใช้คีย์ที่ไหน เช่น *Claude บนโน้ตบุ๊ก*
3. เลือก **สิทธิ์**
   - **อ่านอย่างเดียว: รายงาน เอกสาร รายการต่าง ๆ** เป็นค่าเริ่มต้น และเพียงพอสำหรับการถามคำถามและดูรายงาน
   - **อ่านและแก้ไข: สร้างและผ่านรายการเอกสารได้ด้วย** หน้าต่างจะเตือนว่าเอเจนต์จะสร้าง ผ่านรายการ และยกเลิกเอกสารในนามของคุณได้
4. เลือก **หมดอายุหลังจาก** **30 วัน** **90 วัน** **1 ปี** หรือ **ไม่หมดอายุ**
5. คลิก **สร้างคีย์**

ระบบจะแสดงคีย์เพียง **ครั้งเดียว** เช่น `panya_sk_3f9a1c…` ตามด้วยตัวอักษรและตัวเลข 64 ตัว คลิก **คัดลอก** แล้วเก็บรักษาไว้อย่างปลอดภัยเหมือนรหัสผ่าน Panya เก็บไว้เพียงลายนิ้วมือของคีย์ คุณและทีมสนับสนุน Panya จึงดูคีย์นี้อีกไม่ได้ หากทำหายให้เพิกถอนแล้วสร้างใหม่

สมาชิกแต่ละคนมีคีย์ได้สูงสุด 20 คีย์ต่อองค์กร

### คีย์ทำอะไรได้บ้าง

คีย์ทำได้เท่าที่ **คุณ** ทำได้ ไม่มากกว่านั้น

- เข้าถึงกิจการที่คุณเปิดได้ ด้วยบทบาทของคุณในแต่ละกิจการ (ดู [บทบาทและสิทธิ์](https://panyaplus.com/manual/th/09-organization#บทบาทและสิทธิ์))
- คีย์อ่านอย่างเดียวอ่านได้อย่างเดียว แม้บทบาทของคุณจะผ่านรายการได้
- คีย์ของผู้ใช้งานบทบาทผู้ดูข้อมูลผ่านรายการไม่ได้ แม้จะเป็นคีย์แบบแก้ไขได้
- ข้อมูลเงินเดือนและงานบุคคลต้องมีสิทธิ์เหมือนบนหน้าจอ

สิ่งที่คีย์ทำจะบันทึกในประวัติการใช้งานภายใต้ชื่อของคุณ พร้อมป้าย **คีย์ API** (ดู [ผู้ดูแลองค์กร](https://panyaplus.com/manual/th/09-organization))

คีย์เข้าถึงได้เฉพาะข้อมูลบัญชี การเข้าสู่ระบบ สมาชิกและคำเชิญ แพ็กเกจและการชำระเงิน คีย์ API อื่น การส่งออกข้อมูล และสิทธิ์ทีมสนับสนุน ยังต้องทำในแอป Panya

### เพิกถอนคีย์

คลิก **เพิกถอน** ในแถวของคีย์ แล้วยืนยัน ทุกโปรแกรมที่ใช้คีย์นี้จะหยุดทำงานทันที คีย์ที่เพิกถอนแล้วยังแสดงเป็นสีจางในรายการอีก 30 วัน

คีย์จะหยุดทำงานด้วยเมื่อ

- หมดอายุ
- สมาชิกเจ้าของคีย์ถูกนำออกจากองค์กร (คีย์ของเขาในองค์กรนั้นจะถูกเพิกถอน แม้จะถูกเพิ่มกลับมาภายหลัง)
- บัญชี Panya ของสมาชิกเจ้าของคีย์ถูกระงับ
- Premium ขององค์กรสิ้นสุด (คีย์จะกลับมาใช้ได้เมื่อชำระค่า Premium)

## เชื่อมต่อ AI เอเจนต์

การ์ด **เชื่อมต่อ AI เอเจนต์** มีสามขั้นตอน

1. **ดาวน์โหลด skill.md** skill นี้สอนเอเจนต์ให้ใช้ Panya
   - ต้องค้นหาข้อมูลอะไรก่อน
   - ให้บันทึกเอกสารเป็นร่างและถามคุณก่อนผ่านรายการ
   - รูปแบบของจำนวนเงินและวันที่
   - งานที่ทำบ่อย ได้แก่ การขาย การรับชำระ ค่าใช้จ่าย การจ่ายผู้จำหน่ายพร้อมภาษีหัก ณ ที่จ่าย สมุดรายวัน และรายงาน

   สำหรับ Claude Code ให้บันทึกไฟล์เป็น `~/.claude/skills/panya/SKILL.md` สำหรับเอเจนต์อื่นให้ใส่ไว้ในคำสั่งหรือคลังความรู้ของเอเจนต์
2. ตั้งคีย์ของคุณเป็นตัวแปรสภาพแวดล้อม `PANYA_API_KEY` และที่อยู่เซิร์ฟเวอร์เป็น `PANYA_BASE_URL` (`https://panyaplus.com` สำหรับ Panya Cloud)
3. ทดสอบคีย์ด้วยคำสั่งบนการ์ด

   ```
   curl -H "Authorization: Bearer $PANYA_API_KEY" $PANYA_BASE_URL/api/key
   ```

   ระบบจะตอบชื่อของคุณ องค์กร และกิจการที่คีย์เข้าถึงได้

ดาวน์โหลด skill ได้ที่ `https://panyaplus.com/skill.md` ด้วย

ข้อแนะนำในการใช้เอเจนต์

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

## สำหรับนักพัฒนา

API นี้เป็นตัวเดียวกับที่แอป Panya ใช้ เป็น JSON ผ่าน HTTPS ภายใต้ `/api/companies/{company_id}/…`

- ส่งคีย์ใน `Authorization: Bearer panya_sk_…`
- จำนวนเงินส่งและรับเป็นข้อความ (`"642.00"`) และวันที่เป็น `YYYY-MM-DD` แบบคริสต์ศักราช
- การสร้างเอกสารรับ header `Idempotency-Key` เพื่อไม่ให้การส่งซ้ำสร้างเอกสารใบที่สอง

แต่ละคีย์เรียกใช้ได้สูงสุด 300 ครั้งต่อนาที ไฟล์ skill ใช้เป็นเอกสารอ้างอิง API ได้ด้วย ในไฟล์มีรายการ endpoint รูปแบบคำขอของเอกสารที่ใช้บ่อย และรหัสข้อผิดพลาด

## ข้อความ

| ข้อความ | ความหมาย |
|---|---|
| การใช้ Panya API ต้องสมัคร Premium: เจ้าขององค์กรสมัครได้ที่หน้าแพ็กเกจและการใช้งาน | องค์กรยังไม่มี Premium หรือ Premium สิ้นสุดแล้ว คีย์ยังอยู่ และจะกลับมาใช้ได้เมื่อชำระเงิน |
| คีย์ API ไม่ถูกต้อง: ถูกเพิกถอนหรือหมดอายุแล้ว หรือผู้ใช้งานของคีย์ไม่มีสิทธิ์เข้าถึงแล้ว | สร้างคีย์ใหม่ |
| คีย์ API นี้อ่านได้อย่างเดียว: สร้างคีย์ที่แก้ไขข้อมูลได้เพื่อเปลี่ยนแปลงข้อมูล | เอเจนต์พยายามแก้ไขข้อมูลด้วยคีย์อ่านอย่างเดียว |
| คีย์ API เข้าถึงได้เฉพาะข้อมูลบัญชีของกิจการ: ทำรายการนี้ในแอป Panya | คำขอนี้อยู่นอกข้อมูลบัญชี เช่น สมาชิกหรือการชำระเงิน |
| บทบาทของคุณ (ผู้ดูข้อมูล) ไม่มีสิทธิ์ทำรายการนี้ | สมาชิกเจ้าของคีย์ไม่มีสิทธิ์ทำรายการนี้ ดู [บทบาทและสิทธิ์](https://panyaplus.com/manual/th/09-organization#บทบาทและสิทธิ์) |
| คุณมีคีย์ API ในองค์กรนี้ครบ 20 คีย์แล้ว: เพิกถอนคีย์เดิมก่อน | เพิกถอนคีย์ที่ไม่ใช้แล้ว |
| มีคำขอมากเกินไป กรุณารอสักครู่แล้วลองใหม่ | เรียกใช้เกิน 300 ครั้งในหนึ่งนาที เอเจนต์ควรรอหนึ่งนาที |