เชื่อมต่อ Slack

รับการแจ้งเตือนใน Slack ทันทีเมื่อเอกสารถูกประมวลผล เกิดข้อผิดพลาด หรือ Batch ประมวลผลเสร็จสิ้น การเชื่อมต่อ Slack ของ Ocriva ใช้ฟีเจอร์ Incoming Webhooks ของ Slack โดยตรง — ไม่ต้องพึ่งพา Middleware จากบุคคลที่สาม

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

• Slack Workspace ที่คุณมีสิทธิ์ติดตั้งแอป (สิทธิ์ Admin หรือสิทธิ์ติดตั้งแอป)
• องค์กร Ocriva ที่มี Webhook Quota เหลืออยู่

ขั้นตอนที่ 1: สร้าง Slack Incoming Webhook

1. ไปที่ Slack API: Incoming Webhooks
2. คลิก Create New App (หรือเลือกแอปที่มีอยู่แล้วที่คุณเป็นเจ้าของ)
3. ภายใต้ Features เลือก Incoming Webhooks แล้วสลับเป็น On
4. คลิก Add New Webhook to Workspace
5. เลือกช่องที่ต้องการรับการแจ้งเตือน (เช่น #document-notifications)
6. คลิก Allow — Slack จะสร้าง Webhook URL ในรูปแบบ:

https://hooks.slack.com/services/T.../B.../...

7. คัดลอก Webhook URL ทั้งหมด — คุณจะต้องใช้ในขั้นตอนถัดไป

ขั้นตอนที่ 2: กำหนดค่าใน Ocriva

1. ไปที่หน้า Integrations ในแดชบอร์ด Ocriva
2. ค้นหาการ์ด Slack แล้วคลิก
3. วาง Slack Webhook URL ลงในช่อง URL
4. เลือก Event ที่ต้องการรับ (ค่าเริ่มต้น: document.processed, document.failed, batch.completed)
5. ตรวจสอบ Payload Template ที่กรอกไว้ล่วงหน้า — สามารถใช้ตามเดิมหรือปรับแต่งได้ (ดู การปรับแต่ง Payload)
6. คลิก Create Endpoint

Endpoint จะมีสถานะ active ทันที และ Ocriva จะเริ่มส่ง Event ไปยังช่อง Slack ของคุณ

Payload Template

Slack Payload เริ่มต้นใช้การจัดรูปแบบ Block Kit เพื่อสร้างข้อความที่มีโครงสร้างและอ่านง่าย:

{
  "text": "{{eventType}} - {{payload.fileName}}",
  "blocks": [
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*{{eventType}}*\n>File: {{payload.fileName}}\n>Status: {{payload.status}}\n>Time: {{timestamp}}"
      }
    }
  ]
}

ตารางอ้างอิง Variable

ลักษณะข้อความที่แสดงใน Slack

Template นี้สร้างข้อความสองส่วน: บรรทัด Plain-text สำรอง (ใช้ในการแจ้งเตือนและการค้นหา) และส่วน Block Kit ที่แสดงผลใน Slack Client ส่วน Block Kit จะแสดงเป็น Quoted Block พร้อมหัวข้อ Event Type ตัวหนา ชื่อไฟล์ สถานะ และ Timestamp แยกบรรทัดกัน

การปรับแต่ง Payload

คุณสามารถแก้ไข Payload Template โดยตรงในการตั้งค่า Endpoint เพื่อเพิ่มฟิลด์ข้อมูลเพิ่มเติมได้

การเพิ่มข้อมูลที่ดึงออกมา

หากต้องการรวมเนื้อหาที่ AI ดึงออกมา — เช่น ยอดเงินรวมจากใบแจ้งหนี้ — เพิ่ม {{payload.extractedData}} ลงใน Block:

{
  "text": "{{eventType}} - {{payload.fileName}}",
  "blocks": [
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*{{eventType}}*\n>File: {{payload.fileName}}\n>Status: {{payload.status}}\n>Extracted: {{payload.extractedData}}\n>Time: {{timestamp}}"
      }
    }
  ]
}

การเพิ่มคะแนนความมั่นใจ

"text": "*{{eventType}}*\n>File: {{payload.fileName}}\n>Status: {{payload.status}}\n>Confidence: {{payload.confidence}}\n>Time: {{timestamp}}"

สำหรับรายการ Template Variable ทั้งหมดที่รองรับ ดูที่ Webhook Events reference

ตัวอย่าง: การแจ้งเตือนการประมวลผลใบแจ้งหนี้

สถานการณ์: ผู้ใช้อัปโหลด invoice-2026-03.pdf AI ของ Ocriva ดึงข้อมูลเสร็จสิ้นและส่ง Event document.processed

สิ่งที่ Ocriva ส่งไปยัง Slack:

{
  "text": "document.processed - invoice-2026-03.pdf",
  "blocks": [
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*document.processed*\n>File: invoice-2026-03.pdf\n>Status: completed\n>Time: 2026-04-05T09:30:00Z"
      }
    }
  ]
}

ลักษณะที่แสดงใน Slack: ข้อความพร้อมหัวข้อ document.processed ตัวหนา ตามด้วยสามบรรทัด Quoted แสดงชื่อไฟล์ สถานะ และ Timestamp Plain-text Fallback ยังแสดงในการแจ้งเตือน Push บนเดสก์ท็อปและมือถือด้วย

การทดสอบการเชื่อมต่อ

1. เปิด Endpoint ที่เพิ่งสร้างแล้วคลิกปุ่ม Test
2. Ocriva จะส่ง Payload ตัวอย่าง document.processed ไปยัง Slack Webhook URL ของคุณ
3. ตรวจสอบว่าข้อความปรากฏในช่อง Slack ที่เลือกไว้
4. เปิดแท็บ Logs บน Endpoint เพื่อยืนยันว่าสถานะการส่งเป็น success และ HTTP Response Code เป็น 200

การแก้ไขปัญหา