Passer au contenu principal
Utilisez des pièces jointes lorsqu’un message de discussion nécessite une image, un PDF, un reçu ou un autre fichier.

​
Télécharger des pièces jointes

POST /api/v1/connect/attachments
La demande doit être multipart/form-data.

​
Exemple

curl "https://api.plato.ae/api/v1/connect/attachments" \
  -X POST \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  -F "[email protected]"
Téléchargez jusqu’à 5 fichiers par demande. Chaque fichier peut atteindre 25 Mo.

​
Réponse

{
  "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"
    }
  ]
}
Utilisez id dans attachmentIds lors de l’envoi d’un message : 
await plato.v1.connect.send.mutate({
  conversationId: "conversation_id",
  content: {
    en: "Here is the receipt.",
  },
  attachmentIds: ["file_123"],
});

​
Télécharger une pièce jointe privée

GET /api/v1/connect/assets/[...key]
Utilisez le s3Key renvoyé par la réponse de téléchargement. 
curl "https://api.plato.ae/api/v1/connect/assets/workspace/path/receipt.pdf" \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  --output receipt.pdf
La clé API doit appartenir au même espace de travail que le fichier.

​
Autorisations

Le téléchargement nécessite : 
connect360:conversation:engage
Le téléchargement nécessite soit : 
connect360:conversation:read
ou: 
connect360:conversation:engage

​
Remarques

  • Les noms de fichiers sont normalisés avant le téléchargement.
  • Les fichiers téléchargés sont stockés dans un dossier Connect360 dans Drive.
  • Le URL renvoyé peut pointer vers une route d’actifs privés. Conservez la clé API sur le serveur lors de la récupération de fichiers privés.