เชื่อมต่อ Google Drive
เชื่อมต่อ Google Drive กับ Ocriva เพื่อให้ระบบดึงเอกสารจาก Input Folder มาประมวลผลด้วย AI และส่งผลลัพธ์กลับไปยัง Output Folder โดยอัตโนมัติ ต่างจาก Integration อื่นที่เป็น Outbound Webhook (ส่งข้อมูลออกทางเดียว) — Google Drive Integration เป็นแบบ สองทิศทาง (Bidirectional): Ocriva ดึงไฟล์เข้ามาประมวลผล และส่งผลลัพธ์กลับคืนสู่ Drive ในขั้นตอนเดียว
สิ่งที่ต้องเตรียม
- บัญชี Google ที่เข้าถึง Google Drive ได้
- Organization ใน Ocriva ที่ต้องการเชื่อมต่อ
หลักการทำงาน
Google Drive (Input Folder)
|
▼
Ocriva ดึงไฟล์ (Pull) → สร้าง Upload → AI OCR
|
▼
ประมวลผลด้วย Template
|
├──▶ Export ผลลัพธ์ (JSON/CSV) → Google Drive (Output Folder)
|
└──▶ (ไม่บังคับ) Webhook แจ้งเตือนระบบภายนอกเมื่อ Sync ถูกเปิดใช้งาน Ocriva จะตรวจสอบ Input Folder เป็นระยะ หากพบไฟล์ใหม่จะดึงเข้ามาสร้างเป็น Upload ทันที — ไม่ต้องอัปโหลดด้วยมือผ่านแดชบอร์ด ผลลัพธ์ที่ได้จะถูกเขียนกลับไปยัง Output Folder ในรูปแบบที่ตั้งค่าไว้ ทำให้ทีมงานเข้าถึงข้อมูลที่สกัดได้โดยตรงจาก Drive โดยไม่ต้องเข้าสู่ระบบ Ocriva
NOTE
Google Drive Integration ทำงานในระดับ Organization ต่อ Template หนึ่ง Organization สามารถเชื่อมต่อ Drive ได้หนึ่งครั้ง จากนั้นแต่ละ Template เลือก Folder ของตัวเองได้อิสระ
ขั้นตอนที่ 1: เชื่อมต่อ Google Drive กับ Organization
- ไปที่ Organization Settings ในแดชบอร์ด Ocriva
- เลือกแท็บ Integrations แล้วค้นหาการ์ด Google Drive
- คลิก Connect
- ระบบจะ Redirect ไปยัง Google OAuth Consent Screen
- เลือกบัญชี Google ที่มีสิทธิ์เข้าถึง Drive ที่ต้องการ
- คลิก Allow เพื่ออนุญาตให้ Ocriva อ่านและเขียนไฟล์ใน Drive
- หลังจาก Authorize สำเร็จ หน้า Organization Settings จะแสดงสถานะ Connected
TIP
ใช้บัญชี Google ที่เป็น Drive Owner หรือ Editor ของ Folder ที่ต้องการ เพื่อให้แน่ใจว่า Ocriva มีสิทธิ์อ่านและเขียนครบถ้วน
ขั้นตอนที่ 2: ตั้งค่า Input/Output Folder ใน Template
หลังจากเชื่อมต่อ Drive แล้ว ให้กำหนด Folder สำหรับแต่ละ Template:
- ไปที่ Templates แล้วเปิด Template ที่ต้องการ
- เลือกแท็บ Google Drive Settings
- ตั้งค่าตามตารางด้านล่าง แล้วคลิก Save
| Field | คำอธิบาย |
|---|---|
| Input Folder | Folder ที่เก็บเอกสารรอประมวลผล Ocriva จะดึงไฟล์ใหม่จาก Folder นี้ |
| Output Folder | Folder ที่จะบันทึกไฟล์ผลลัพธ์ (JSON/CSV) หลังประมวลผลเสร็จ |
| Sync Enabled | เปิด/ปิดการตรวจสอบ Input Folder อัตโนมัติ |
TIP
แนะนำให้สร้าง Folder แยกกันชัดเจนต่อแต่ละ Template เช่น Ocriva/Invoices/Input และ Ocriva/Invoices/Output เพื่อให้ไฟล์ไม่ปะปนกัน
ขั้นตอนที่ 3: ดึงเอกสารจาก Drive
เมื่อ Sync เปิดใช้งาน Ocriva จะดึงไฟล์ใหม่จาก Input Folder โดยอัตโนมัติ:
- รองรับ PDF, รูปภาพ (PNG, JPG, TIFF) และเอกสารสแกน
- ไฟล์ที่ดึงแล้วจะถูกสร้างเป็น Upload ใน Ocriva และประมวลผลด้วย Template ที่กำหนดไว้
- ดูสถานะการประมวลผลได้ที่แดชบอร์ด Processing History
TIP
จัด Folder ตามประเภทเอกสาร เช่น Folder แยกสำหรับ "ใบแจ้งหนี้", "ใบเสร็จ", "สัญญา" และสร้าง Template ของ Ocriva ที่สอดคล้องกัน วิธีนี้ช่วยให้แต่ละ Template ดึงเฉพาะเอกสารประเภทที่ตัวเองรับผิดชอบ
ขั้นตอนที่ 4: ส่งผลลัพธ์กลับ Drive
เมื่อ Ocriva ประมวลผลเอกสารเสร็จ ระบบจะ Export ผลลัพธ์ไปยัง Output Folder โดยอัตโนมัติ:
- ไฟล์ผลลัพธ์บันทึกในรูปแบบ JSON หรือ CSV ตามที่ตั้งค่าใน Template
- ชื่อไฟล์ผลลัพธ์จะสอดคล้องกับชื่อไฟล์ต้นฉบับ เช่น
invoice-2026-04.pdf→invoice-2026-04-result.json - ทีมงานเข้าถึงผลลัพธ์ได้โดยตรงจาก Drive โดยไม่ต้องเข้าสู่ระบบ Ocriva
สามารถใช้ร่วมกับ Webhook ได้เพื่อแจ้งเตือนระบบภายนอกพร้อมกัน เช่น ส่งข้อมูลเข้า Google Sheets หรือ Slack ทันทีที่ Export เสร็จ
การตรวจสอบสถานะการเชื่อมต่อ
ไปที่ Organization Settings → Integrations → Google Drive เพื่อดูสถานะ:
| สถานะ | ความหมาย |
|---|---|
| active | เชื่อมต่อสำเร็จ Token ยังใช้งานได้ |
| disconnected | ยกเลิกการเชื่อมต่อด้วยมือ หรือ Revoke จาก Google Account |
| expired | Token หมดอายุและ Auto-refresh ล้มเหลว |
Ocriva จะ Refresh Token โดยอัตโนมัติก่อนหมดอายุ หากการ Refresh ล้มเหลว (เช่น ผู้ใช้ Revoke สิทธิ์จาก Google Account) สถานะจะเปลี่ยนเป็น expired และ Sync จะหยุดทำงานจนกว่าจะเชื่อมต่อใหม่
วิธียกเลิกการเชื่อมต่อ: คลิก Disconnect ใน Organization Settings Token จะถูกลบออกจากระบบทันที
วิธีเชื่อมต่อใหม่: คลิก Connect แล้วทำ OAuth Flow อีกครั้ง
Troubleshooting
| ปัญหา | สาเหตุที่เป็นไปได้ | วิธีแก้ |
|---|---|---|
| ไม่สามารถเชื่อมต่อ Google Drive | ยังไม่ได้ Authorize หรือ Token หมดอายุ | ไปที่ Organization Settings → Integrations → Google Drive แล้วคลิก Connect ใหม่ |
| ไม่พบไฟล์ใน Input Folder | Folder ID ไม่ถูกต้อง หรือบัญชีที่เชื่อมต่อไม่มีสิทธิ์เข้าถึง Folder | ตรวจสอบว่า Folder ถูก Share ให้กับบัญชี Google ที่ใช้เชื่อมต่อ และ Folder ID ใน Template ตรงกัน |
| Export ไม่สำเร็จ | Output Folder ไม่มีสิทธิ์เขียน | ตรวจสอบว่าบัญชี Google ที่เชื่อมต่อมีสิทธิ์ Editor หรือ Owner ใน Output Folder |
| สถานะแสดง "expired" | Token Refresh ล้มเหลว อาจเกิดจากการ Revoke สิทธิ์จาก Google Account | ยกเลิกการเชื่อมต่อแล้วเชื่อมต่อใหม่ผ่าน Organization Settings |
| Sync ไม่ทำงานแม้สถานะเป็น active | Sync Enabled ปิดอยู่ใน Template หรือ Input Folder ว่างเปล่า | เปิด Sync Enabled ใน Template Settings และตรวจสอบว่ามีไฟล์ใน Input Folder |
เคล็ดลับ
- โครงสร้าง Folder ตามประเภทเอกสาร: สร้าง Folder แยกต่อ Template เช่น
Ocriva/Invoices/Input,Ocriva/Receipts/Inputทำให้ไฟล์ไม่ปะปนและติดตามได้ง่าย - ใช้ร่วมกับ Webhook: ตั้งค่า Webhook เพิ่มเติมเพื่อส่งข้อมูลเข้า Google Sheets หรือ Slack พร้อมกับที่ Export ไฟล์ไปยัง Drive เป็น Double Delivery ที่ครอบคลุมทุกช่องทาง
- Shared Drive: Ocriva รองรับ Google Shared Drive ขององค์กร ใช้ได้กับ Folder ใน Shared Drive โดยตรง — ไม่ต้องอยู่ใน My Drive เท่านั้น
- การเก็บรักษาไฟล์ (PDPA): ไฟล์ต้นฉบับที่ดึงจาก Drive จะถูกจัดการตาม File Retention Policy ที่ตั้งค่าใน Ocriva ตรวจสอบนโยบายการเก็บข้อมูลก่อนเปิดใช้งาน Sync กับเอกสารที่มีข้อมูลส่วนบุคคล ดูรายละเอียดที่ File Retention
