# งานอัตโนมัติ ช่องทางรับเรื่อง API และการนำเข้า

> กฎอัตโนมัติและงานตามรอบ webhook ไป Slack / Teams / ระบบอื่น API key และ API สาธารณะ แจ้งเตือนจากระบบ monitoring และนำเข้าข้อมูลจาก Jira Zendesk Freshdesk

ที่มา: https://anasaki.live/docs/primeticket/pt-automation-channels

## งานอัตโนมัติ

เมนู **อัตโนมัติ / งานตามรอบ**

| ส่วน | ทำอะไร |
| --- | --- |
| เมื่อ | เปิดเรื่อง แก้เรื่อง เปลี่ยนสถานะ มีความเห็น SLA ใกล้หมดหรือเลย หรือทุกชั่วโมง |
| เงื่อนไข | เขียนแบบ PQL เช่น `priority = P1 AND assignee is empty` |
| ทำ | ตั้งความสำคัญ มอบหมาย เปลี่ยนสถานะ ใส่ความเห็น แจ้งเตือน ติดป้าย ส่ง webhook |

มีกฎตัวอย่างให้เริ่ม ทุกครั้งที่กฎทำงานมีบันทึกให้ตรวจ

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

## Webhook และ Slack / Teams

เมนู **ช่องทางรับเรื่อง / webhook** → webhook ใส่ URL ปลายทางและเลือกเหตุการณ์ ระบบส่งข้อมูลพร้อมลายเซ็น `X-Anasaki-Signature` ให้ปลายทางตรวจสอบได้

ใส่ URL incoming webhook ของ Slack หรือ Microsoft Teams ได้โดยตรง ระบบส่งเป็นข้อความสั้นให้เอง

## API key และ API

เมนู **API key** สร้าง key ให้ระบบอื่นเปิดหรืออ่านเรื่อง เลือก space และสิทธิ์ของ key ได้ (ให้สิทธิ์เกินที่ตัวเองมีไม่ได้) key แสดงครั้งเดียวตอนสร้าง

```
POST /v1/tickets?wait=true
X-Api-Key: pt_live_…
Content-Type: application/json

{&#34;space&#34;:&#34;SUP&#34;,&#34;title&#34;:&#34;เครื่องพิมพ์ใช้ไม่ได้&#34;,&#34;priority&#34;:&#34;P2&#34;,&#34;reporter&#34;:{&#34;email&#34;:&#34;customer@example.com&#34;}}
```

- เอกสาร API อยู่ที่ `/v1/openapi.json`
- รองรับ `Idempotency-Key` ส่งซ้ำไม่เกิดเรื่องซ้ำ
- จำนวนคำขอต่อนาทีขึ้นกับแพ็กเกจ

### แจ้งเตือนจากระบบ monitoring

`POST /v1/alerts` จากระบบเฝ้าดูเซิร์ฟเวอร์: การแจ้งเตือนเดียวกันเปิดเรื่องเดียว แจ้งซ้ำเพิ่มเป็นบันทึก เมื่อแจ้งว่ากลับมาปกติ ระบบปิดเรื่องให้ (key ต้องมีสิทธิ์เปลี่ยนสถานะ)

## นำเข้าข้อมูล

ที่ **ตั้งค่า workspace** นำเข้าลูกค้า องค์กร พนักงาน และเรื่องเก่าจาก CSV ไฟล์ส่งออกของ Jira, Zendesk และ Freshdesk ใช้ได้ทันทีโดยไม่ต้องแก้หัวคอลัมน์ ลองแบบไม่บันทึกเพื่อตรวจก่อน นำเข้าซ้ำไม่เกิดข้อมูลซ้ำ
