Ana içeriğe atla
Bir sohbet mesajının resim, PDF, makbuz veya başka bir dosyaya ihtiyacı olduğunda ekleri kullanın.

​
Ekleri Yükle

POST /api/v1/connect/attachments
İstek multipart/form-data olmalıdır.

​
Örnek

curl "https://api.plato.ae/api/v1/connect/attachments" \
  -X POST \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  -F "[email protected]"
İstek başına en fazla 5 dosya yükleyin. Her dosya en fazla 25 MB olabilir.

​
Cevap

{
  "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"
    }
  ]
}
Mesaj gönderirken attachmentIds’de id’yi kullanın: 
await plato.v1.connect.send.mutate({
  conversationId: "conversation_id",
  content: {
    en: "Here is the receipt.",
  },
  attachmentIds: ["file_123"],
});

​
Özel Bir Ek İndirin

GET /api/v1/connect/assets/[...key]
Yükleme yanıtının döndürdüğü s3Key’yi kullanın. 
curl "https://api.plato.ae/api/v1/connect/assets/workspace/path/receipt.pdf" \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  --output receipt.pdf
API anahtarı dosyayla aynı çalışma alanına ait olmalıdır.

​
İzinler

Yükleme şunları gerektirir: 
connect360:conversation:engage
İndirme aşağıdakilerden birini gerektirir: 
connect360:conversation:read
veya: 
connect360:conversation:engage

​
Notlar

  • Dosya adları yüklemeden önce normalleştirilir.
  • Yüklenen dosyalar Drive içindeki bir Connect360 klasöründe saklanır.
  • Döndürülen URL, özel bir varlık rotasına işaret edebilir. Özel dosyaları alırken API anahtarını sunucuda tutun.