الانتقال إلى المحتوى الرئيسي
استخدم المرفقات عندما تحتاج رسالة الدردشة إلى صورة أو ملف PDF أو إيصال أو ملف آخر.

تحميل المرفقات

POST /api/v1/connect/attachments
يجب أن يكون الطلب multipart/form-data.

مثال

curl "https://api.plato.ae/api/v1/connect/attachments" \
  -X POST \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  -F "[email protected]"
تحميل ما يصل إلى 5 ملفات لكل طلب. يمكن أن يصل حجم كل ملف إلى 25 ميغابايت.

إجابة

{
  "files": [
    {
      "id": "file_123",
      "name": "receipt.pdf",
      "s3Key": "workspace/path/receipt.pdf",
      "type": "application/pdf",
      "url": "https://app.plato.ae/api/assets/workspace%2Fpath%2Freceipt.pdf"
    }
  ]
}
استخدم id في attachmentIds عند إرسال رسالة:
await plato.v1.connect.send.mutate({
  conversationId: "conversation_id",
  content: {
    en: "Here is the receipt.",
  },
  attachmentIds: ["file_123"],
});

تحميل مرفق خاص

GET /api/v1/connect/assets/[...key]
استخدم s3Key التي تم إرجاعها بواسطة استجابة التحميل.
curl "https://api.plato.ae/api/v1/connect/assets/workspace/path/receipt.pdf" \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  --output receipt.pdf
يجب أن ينتمي المفتاح API إلى نفس مساحة العمل التي ينتمي إليها الملف.

الأذونات

يتطلب التحميل:
connect360:conversation:engage
يتطلب التنزيل إما:
connect360:conversation:read
أو:
connect360:conversation:engage

ملحوظات

  • تتم تسوية أسماء الملفات قبل التحميل.
  • يتم تخزين الملفات التي تم تحميلها في مجلد Connect360 في Drive.
  • قد يشير URL الذي تم إرجاعه إلى مسار أصول خاصة. احتفظ بمفتاح API على الخادم عند جلب الملفات الخاصة.