ภาพรวมและ Integrations ที่มี
Ocriva เชื่อมต่อกับบริการภายนอกผ่าน การส่ง Event แบบ Webhook เมื่อเอกสารถูกประมวลผล Batch เสร็จสิ้น หรือ Template มีการเปลี่ยนแปลง Ocriva จะส่งการแจ้งเตือน HTTP แบบ Real-time ไปยังบริการที่คุณเชื่อมต่อไว้ — ไม่ต้อง Poll ไม่ต้อง Export ด้วยมือ และไม่ต้องเขียน Glue Code ใด ๆ
ทุก Integration ในหัวข้อนี้สร้างบนกลไกพื้นฐานเดียวกัน: Webhook Endpoint ที่ลงทะเบียนใน Ocriva ซึ่งจะรับ JSON Payload ทันทีที่ Event เกิดขึ้น ความแตกต่างระหว่าง Integration แต่ละตัวอยู่ที่ URL ที่คุณกำหนดให้ Webhook ชี้ไป และวิธีที่บริการปลายทางตีความ Payload นั้น
Integration ทำงานอย่างไร
เมื่อคุณเชื่อมต่อ Ocriva กับบริการภายนอก ข้อมูลจะไหลในทิศทางเดียว — จาก Ocriva ออกสู่ภายนอก:
อัปโหลดเอกสาร
|
v
AI ประมวลผลและดึงข้อมูล
|
v
Event ถูกยิง (เช่น document.processed)
|
v
Webhook ส่ง JSON Payload
|
v
บริการภายนอกดำเนินการ
(ส่งข้อความ Slack, เรียก Zap, เพิ่มแถวใน Sheet เป็นต้น)ปรับแต่ง Payload ด้วย {{variable}}
Ocriva ใช้ระบบ Template แบบ {{variable}} เพื่อให้คุณกำหนดได้อย่างละเอียดว่าจะส่งอะไรไปยัง Integration แต่ละตัว เมื่อตั้งค่า Webhook คุณสามารถอ้างอิงฟิลด์ใดก็ได้จาก Event Payload โดยใช้ไวยากรณ์วงเล็บคู่:
Document "{{payload.fileName}}" processed successfully.
Confidence: {{payload.confidence}}
Extracted by: {{payload.templateName}}ขณะส่ง Ocriva จะแทนที่ Placeholder แต่ละตัวด้วยค่าจริงจาก Event ทำให้คุณสามารถสร้างข้อความ Slack, Discord Embed หรือ Zapier Field Mapping ได้โดยไม่ต้องเขียนโค้ดฝั่ง Server เลย
TIP
ใช้ {{payload.extractedData.*}} เพื่อส่งฟิลด์ที่ดึงมาโดยตรงเข้าสู่เครื่องมือ Automation เช่น {{payload.extractedData.invoiceNumber}} ดึงเลขที่ใบแจ้งหนี้เข้าสู่ Make Scenario หรือแถวใน Google Sheets โดยตรง
ดูรายละเอียดเต็มเกี่ยวกับโครงสร้าง Payload การยืนยันลายเซ็น และพฤติกรรม Retry ได้ที่ คู่มือ Webhook
Integrations ที่มีให้ใช้งาน
| Integration | หมวดหมู่ | สิ่งที่ทำ | คู่มือ |
|---|---|---|---|
| Slack | Messaging | ส่งการแจ้งเตือนการประมวลผลไปยัง Slack Channel | คู่มือการตั้งค่า |
| Discord | Messaging | ส่งการแจ้งเตือนไปยัง Discord Channel | คู่มือการตั้งค่า |
| Zapier | Automation | เรียก Zap จาก Event การประมวลผลเอกสาร | คู่มือการตั้งค่า |
| Make (Integromat) | Automation | เชื่อมต่อกับ Make Scenario | คู่มือการตั้งค่า |
| n8n | Automation | เรียก n8n Workflow | คู่มือการตั้งค่า |
| Google Sheets | Spreadsheet | บันทึกข้อมูลที่ดึงได้ลง Spreadsheet อัตโนมัติ | คู่มือการตั้งค่า |
| LINE | Mobile | สแกนเอกสารผ่าน LINE และรับการแจ้งเตือน | คู่มือการตั้งค่า |
| Google Drive | File Storage | ดึงเอกสารจาก Drive มาประมวลผล และส่งผลลัพธ์กลับ Drive อัตโนมัติ | คู่มือการตั้งค่า |
| Custom | Custom | HTTP Endpoint ใดก็ได้ที่รับ POST | การตั้งค่า Webhook |
NOTE
ทุก Integration ยกเว้น LINE และ Google Drive ใช้ Outbound Webhook มาตรฐาน LINE เป็น Integration แบบสองทิศทาง — ผู้ใช้สามารถส่งเอกสารไปยัง LINE Bot และรับผลลัพธ์กลับมา Google Drive เป็น Integration แบบสองทิศทางเช่นกัน — ดึงเอกสารจาก Drive Input Folder มาประมวลผล และส่งผลลัพธ์กลับไปยัง Drive Output Folder อัตโนมัติ
หมวดหมู่
Messaging — Slack, Discord
Integration ประเภท Messaging ส่งการแจ้งเตือนทีมแบบ Real-time เมื่อเอกสารสำเร็จหรือล้มเหลว เป็นวิธีที่เร็วที่สุดในการแจ้งทีมโดยที่ไม่มีใครต้องเข้าสู่ระบบ Ocriva
- โพสต์ไปยัง Channel
#ocr-resultsที่กำหนดเมื่อมีการดึงข้อมูลที่มีความมั่นใจสูง - แจ้งเตือน
#ops-alertsทันทีเมื่อเอกสารประมวลผลล้มเหลว - Mention ผู้ใช้หรือ Role เฉพาะสำหรับเอกสารที่เร่งด่วน
Automation — Zapier, Make, n8n
แพลตฟอร์ม Automation เชื่อมต่อ Ocriva กับบริการอื่น ๆ อีกหลายร้อยรายการโดยไม่ต้องเขียนโค้ด เมื่อ Ocriva ยิง Event แพลตฟอร์ม Automation จะรับเป็น Trigger และสามารถส่งต่อข้อมูลที่ดึงมาได้ทุกที่:
- ส่งฟิลด์ใบแจ้งหนี้เข้าสู่ระบบบัญชี (Xero, QuickBooks)
- สร้าง CRM Record จากข้อมูลติดต่อที่ดึงมา (HubSpot, Salesforce)
- จัดเก็บข้อมูลที่มีโครงสร้างลงในฐานข้อมูลหรือ Data Warehouse
- เชื่อมต่อหลายการกระทำ — แจ้งเตือน Slack เขียนลง Sheets และเปิด Jira Ticket ทั้งหมดจาก Event เดียว
File Storage — Google Drive
Google Drive Integration แตกต่างจาก Integration อื่นๆ อย่างสิ้นเชิง — ไม่ใช่ Outbound Webhook แต่เป็นการเชื่อมต่อแบบสองทิศทาง (Bidirectional):
- Pull: ดึงเอกสารจาก Google Drive Input Folder เข้ามาประมวลผลใน Ocriva อัตโนมัติ
- Push: ส่งผลลัพธ์ (JSON/CSV) กลับไปยัง Google Drive Output Folder ทันทีที่ประมวลผลเสร็จ
- ตั้งค่า Input/Output Folder แยกตาม Template — ใบแจ้งหนี้ไป folder หนึ่ง สัญญาไปอีก folder หนึ่ง
- ทีมทำงานใน Google Drive ตามปกติ — อัปโหลดเอกสารเข้า Drive เท่านั้น Ocriva จัดการที่เหลือ
- รองรับ Shared Drive ขององค์กร — จัดการสิทธิ์ผ่าน Drive permissions ตามปกติ
Spreadsheet — Google Sheets
Integration กับ Google Sheets บันทึกข้อมูลที่ดึงมาลงในแถวของ Spreadsheet ทุกครั้งที่เอกสารถูกประมวลผล เหมาะสำหรับทีมที่ต้องการ Audit Trail ที่เบาและอ่านง่าย หรือต้องการแชร์ผลลัพธ์โดยไม่ต้องตั้งค่าฐานข้อมูล
Mobile — LINE
Integration กับ LINE เป็น Mobile Workflow ระดับ First-class ผู้ใช้สแกนเอกสารด้วยโทรศัพท์ ส่งไปยัง LINE Bot ที่กำหนดค่าไว้ และรับผลลัพธ์ที่ดึงข้อมูลกลับมาเป็นการตอบกลับ — ทั้งหมดนี้โดยไม่ต้องเปิด Browser บนคอมพิวเตอร์ เป็นที่นิยมอย่างมากในตลาดที่ LINE เป็นเครื่องมือสื่อสารทางธุรกิจหลัก
ข้อกำหนดเบื้องต้น
ก่อนตั้งค่า Integration ใด ๆ ให้ตรวจสอบสิ่งต่อไปนี้:
- Organization ที่ใช้งาน Ocriva อยู่และมี Webhook Quota เหลือ (ตรวจสอบที่ Organization → Limits)
- Project สำหรับกำหนดขอบเขต Webhook Event — Integration จะผูกกับ Project เฉพาะเสมอ
- Credentials ของบริการปลายทาง (สิทธิ์ Admin ของ Slack Workspace, สิทธิ์ Discord Server, บัญชี Zapier หรือ Make เป็นต้น)
WARNING
Webhook Quota จะถูกบังคับใช้ต่อ Organization หากถึงขีดจำกัด การส่ง Webhook ใหม่จะถูกยกเลิกโดยไม่มีการแจ้งเตือน ติดตาม Quota ของคุณใน Organization → Limits และอัปเกรดแผนถ้าจำเป็นก่อนเชื่อมต่อ Integration ใหม่ในสภาพแวดล้อม Production
เริ่มต้นอย่างรวดเร็ว
ขั้นตอนการตั้งค่าเหมือนกันทุก Integration ที่คุณเลือก:
- เปิดหน้า Integrations ใน Ocriva (Sidebar → Integrations)
- เลือกบริการที่ต้องการเชื่อมต่อ
- ทำตามขั้นตอนเฉพาะของบริการเพื่อรับ Webhook URL จากบริการนั้น (คู่มือแต่ละตัวด้านล่างอธิบายขั้นตอนนี้โดยละเอียด)
- วาง Webhook URL ลงใน Ocriva
- เลือก Event ที่ต้องการ Subscribe (ดู ประเภท Event ด้านล่าง)
- ตั้งค่า Secret สำหรับการยืนยันลายเซ็น (ไม่บังคับ)
- คลิก Test Connection — Ocriva จะส่ง Payload ตัวอย่างและยืนยันการส่ง
TIP
สำหรับ Integration แบบ Custom ที่ไม่มีในรายการ ให้ใช้ Template Custom บริการใดก็ตามที่รับ HTTP POST Request ได้ก็รับ Ocriva Webhook ได้ — ไม่ว่าจะเป็น Internal Microservice, Data Pipeline หรือเครื่องมือที่สร้างเอง
ประเภท Event สำหรับ Integrations
Event สามประเภทที่ใช้กับ Integration บ่อยที่สุด:
| Event | เมื่อไรที่ยิง | เหมาะสำหรับ |
|---|---|---|
document.processed | หลังจาก AI ดึงข้อมูลเสร็จสมบูรณ์ | ทุก Integration — เป็น Event การแจ้งเตือนหลัก |
document.failed | เมื่อการประมวลผลล้มเหลวหลังจาก Retry ทั้งหมด | Integration สำหรับแจ้งเตือน (Slack, Discord) |
batch.completed | เมื่อทุกไฟล์ใน Batch เสร็จสิ้น | Integration สำหรับรายงาน (Sheets, Automation) |
NOTE
batch.completed จะยิงครั้งเดียวต่อ Batch ไม่ใช่ครั้งเดียวต่อเอกสาร ใช้เมื่อต้องการการแจ้งเตือนสรุปครั้งเดียวแทนที่จะเป็นข้อความต่อไฟล์ สำหรับผลลัพธ์ไฟล์แต่ละไฟล์ภายใน Batch ให้ Subscribe กับ document.processed แทน
ดู ประเภท Event และ Payload สำหรับ Reference ครบถ้วน รวมถึง template.updated, document.exported และนิยามฟิลด์ Payload ทั้งหมด
ขั้นตอนถัดไป
เลือก Integration ที่เหมาะกับ Workflow ของคุณ:
- การตั้งค่า Slack — โพสต์ไปยัง Channel พร้อมรูปแบบข้อความแบบ Custom
- การตั้งค่า Discord — ส่ง Embed ไปยัง Discord Channel
- การตั้งค่า Zapier — เรียก Zap จาก Document Event ใดก็ได้
- การตั้งค่า Make — สร้าง Make Scenario โดยใช้ Ocriva เป็น Trigger
- การตั้งค่า n8n — เชื่อมต่อกับ n8n Workflow แบบ Self-hosted หรือ Cloud
- การตั้งค่า Google Sheets — เพิ่มแถวข้อมูลที่ดึงมาอัตโนมัติ
- LINE Integration — สแกนและรับผลลัพธ์ผ่าน LINE
- การตั้งค่า Webhook — สร้าง Integration แบบ Custom กับ HTTP Endpoint ใดก็ได้
