เชื่อมต่อ Zapier

ทำให้ Workflow ทำงานอัตโนมัติโดยเชื่อมต่อ Ocriva กับแอปพลิเคชันกว่า 6,000 รายการผ่าน Zapier ทุกครั้งที่เอกสารถูกประมวลผลสำเร็จ ล้มเหลว หรือ Batch เสร็จสิ้น Ocriva จะส่ง Event Payload ทั้งหมดไปยัง Zap ของคุณโดยอัตโนมัติ — ไม่ต้องเขียนโค้ดแม้แต่บรรทัดเดียว

สิ่งที่ต้องเตรียม

• บัญชี Zapier (แผน Free ใช้ทดสอบปริมาณน้อยได้ สำหรับ Production ปริมาณสูงต้องใช้แผนแบบชำระเงิน)
• Organization ใน Ocriva ที่มี Webhook Quota เหลืออยู่

หลักการทำงาน

Trigger แบบ Catch Hook ของ Zapier คอยรับ HTTP POST Request ที่เข้ามา Ocriva ส่ง Event JSON ดิบตรงไปยัง URL นั้น — ไม่ต้องกำหนด Payload Template เพิ่มเติม Zapier จะแยกวิเคราะห์โครงสร้าง JSON โดยอัตโนมัติเมื่อได้รับครั้งแรก ทำให้ทุก Field พร้อมใช้เป็นตัวแปรสำหรับ Zap Steps ถัดไปได้ทันที

ต่างจากการเชื่อมต่อ Slack (ซึ่งใช้ Payload Template เพื่อจัดรูปแบบข้อความ) การเชื่อมต่อ Zapier ส่ง Event Payload ของ Ocriva แบบไม่ผ่านการแปลง ซึ่งหมายความว่าคุณเข้าถึงข้อมูล Event ทั้งหมดได้ครบถ้วน ทั้ง extractedData ค่าความเชื่อมั่น (Confidence) และ Timestamp การประมวลผล — Zapier จัดการส่วนที่เหลือเอง

ขั้นตอนที่ 1: สร้าง Catch Hook ใน Zapier

1. ล็อกอินที่ zapier.com แล้วคลิก + Create Zap
2. ใต้ Trigger ค้นหา Webhooks by Zapier แล้วเลือก
3. เลือก Catch Hook เป็น Trigger Event แล้วคลิก Continue
4. ปล่อยช่อง Child Key ว่างไว้ (ไม่จำเป็นสำหรับ Ocriva Payloads)
5. คลิก Continue — Zapier จะสร้าง Webhook URL เฉพาะตัวในรูปแบบ:

https://hooks.zapier.com/hooks/catch/1234567/abcdefg/

6. คัดลอก Webhook URL ทั้งหมด — คุณจะต้องใช้ในขั้นตอนถัดไป
7. เปิดแท็บเบราว์เซอร์นี้ไว้ Zapier จะรอรับ Payload ทดสอบก่อนที่จะให้คุณดำเนินการต่อ

ขั้นตอนที่ 2: ตั้งค่าใน Ocriva

1. ไปที่หน้า Integrations ในแดชบอร์ด Ocriva
2. ค้นหาการ์ด Template ของ Zapier แล้วคลิก
3. วาง Catch Hook URL ลงในช่อง URL
4. เลือก Event ที่ต้องการรับ — ค่าเริ่มต้นคือ document.processed คุณสามารถเพิ่ม document.failed และ batch.completed ได้
5. ปล่อย Payload Template ว่างไว้ — Zapier รับ JSON ดิบจาก Ocriva ได้โดยอัตโนมัติ
6. คลิก Create Endpoint

Endpoint จะเปิดใช้งาน (active) ทันที และ Ocriva จะเริ่มส่ง Event ไปยัง Zap ของคุณ

ขั้นตอนที่ 3: ทดสอบและกำหนด Field Mapping

1. เปิด Endpoint ที่สร้างไว้ใน Ocriva แล้วคลิกปุ่ม Test
2. Ocriva ส่ง Payload ตัวอย่างแบบ document.processed ไปยัง Zapier Webhook URL ของคุณ
3. กลับไปที่แท็บ Zapier — ควรตรวจพบ Payload ที่เข้ามาและแสดง Field ทั้งหมดที่แยกวิเคราะห์แล้ว
4. คลิก Continue with selected record ใน Zapier เพื่อยืนยันข้อมูล Trigger
5. เพิ่ม Step แบบ Action ใน Zap (เช่น Google Sheets, Gmail, Slack) แล้วใช้ไอคอน + เพื่อกำหนด Field ของ Ocriva ไปยัง Input ของ Action:
   • payload__extractedData__invoiceNumber → คอลัมน์ Google Sheets Invoice Number
   • payload__status → ช่อง Filter หรือ Label
   • payload__confidence → คอลัมน์ตัวเลขสำหรับติดตาม QA
   • timestamp → คอลัมน์วันที่/เวลา

ตัวอย่าง Workflow

ใบแจ้งหนี้ → Google Sheets

สถานการณ์: ผู้ใช้อัปโหลดไฟล์ PDF ใบแจ้งหนี้ Ocriva ดึงข้อมูลและส่ง Event document.processed

Zap: Ocriva (document.processed) → Google Sheets (Append Row)

กำหนด Field เหล่านี้ไปยังคอลัมน์ Spreadsheet:

เอกสารล้มเหลว → แจ้งเตือนทาง Email

สถานการณ์: เอกสารประมวลผลล้มเหลว ทีมต้องได้รับแจ้งทันที

Zap: Ocriva (document.failed) → Gmail (Send Email)

ตั้งค่า Email โดยใส่ payload__fileName ในหัวเรื่อง และ payload__error ในเนื้อหา เพื่อให้ผู้รับทราบว่าไฟล์ใดล้มเหลวและเพราะเหตุใด

Batch เสร็จสิ้น → สรุปผลใน Slack

สถานการณ์: เอกสารใน Batch ประมวลผลเสร็จทั้งหมด โพสต์สรุปไปยัง Channel ของทีม

Zap: Ocriva (batch.completed) → Slack (Send Channel Message)

ใช้ payload__totalDocuments, payload__successCount, และ payload__failedCount เพื่อประกอบข้อความ

Raw Payload ที่ Zapier ได้รับ

JSON ด้านล่างคือข้อมูลที่ Ocriva ส่งสำหรับ Event แบบ document.processed Zapier จะแยกวิเคราะห์ทุก Field โดยอัตโนมัติ

{
  "eventType": "document.processed",
  "eventId": "evt_1743418800000_prc002",
  "timestamp": "2026-03-31T12:00:03.241Z",
  "organizationId": "org_abc123",
  "projectId": "proj_xyz789",
  "payload": {
    "id": "doc_upl_001",
    "fileName": "invoice_march.pdf",
    "status": "completed",
    "extractedData": {
      "invoiceNumber": "INV-2026-0331",
      "vendor": "Acme Supplies Co.",
      "totalAmount": 15408.00,
      "currency": "THB"
    },
    "confidence": 0.97,
    "processingTime": 3241,
    "processedAt": "2026-03-31T12:00:03.241Z"
  }
}

ข้อมูล Event ที่ใช้ได้

ตารางด้านล่างแสดง Field หลักที่ใช้งานได้ใน Zapier หลังจากเกิด Event แบบ document.processed Field ทั้งหมดเข้าถึงได้เป็นตัวแปร Zap ใน Action Steps ถัดไป

สำหรับรายการ Event Type ทั้งหมดและรายละเอียด Payload Fields ดูที่ Event Types & Payloads

เคล็ดลับ

• ใช้ Step แบบ Formatter ของ Zapier เพื่อแปลงข้อมูลที่ดึงได้ก่อนส่งไปยังแอปอื่น เช่น แปลงตัวเลขเป็น String สกุลเงิน หรือจัดรูปแบบวันที่ใหม่
• เพิ่ม Step แบบ Filter หลัง Trigger เพื่อดำเนินการเฉพาะเอกสารที่มีค่า Confidence สูงกว่าระดับที่กำหนด (เช่น payload__confidence มากกว่า 0.90) หรือตรงกับรูปแบบชื่อไฟล์ที่ต้องการ
• สำหรับการประมวลผลปริมาณสูง ตรวจสอบขีดจำกัด Task ของแผน Zapier ที่ใช้อยู่ การรัน Zap แต่ละครั้งใช้หนึ่ง Task ต่อหนึ่ง Action Step แผน Free อนุญาต 100 Tasks ต่อเดือน พิจารณาแผน Starter หรือ Professional สำหรับงาน Production
• สำหรับเอกสารอ้างอิง Zapier Webhooks ฉบับเต็ม ดูที่ Trigger Zaps from Webhooks