Media
Carica e gestisci i file media referenziati nei messaggi e nelle campagne.
Carica un file media
Carica un nuovo file multimediale (immagine o video) nella tua libreria media. La richiesta deve usare la codifica multipart/form-data, con il file binario nella parte 'file'. I formati immagine supportati includono JPEG, PNG e GIF. I formati video supportati includono MP4. Facoltativamente, fornisci un nome e una descrizione leggibili per il file e un folderId per organizzarlo in una cartella specifica della tua libreria. In caso di successo, la risposta include l'ID del media appena creato. Conserva questo ID e usalo ogni volta che devi allegare il file a un messaggio in uscita (es. rich card RCS, messaggi media WhatsApp) o al contenuto delle campagne. Restituisce 400 se la richiesta è malformata, se manca la parte file o se il tipo di file non è supportato. Restituisce 401 se la chiave API è mancante o non valida. Restituisce 502 se il servizio upstream di archiviazione dei media è temporaneamente non disponibile; in questo caso riprova dopo una breve attesa.
Elenca media aziendali
Restituisce un elenco paginato di tutti i file multimediali archiviati nella tua libreria media. Ogni voce contiene l'ID del file, il nome, il tipo MIME, la dimensione e un URL per visualizzare in anteprima o scaricare il file. Usa il campo id di un risultato per fare riferimento a quel file quando componi i messaggi (ad esempio, per allegare un'immagine a una card RCS o a un messaggio media WhatsApp) o quando includi media nel contenuto delle campagne. La paginazione è controllata da page (indice a partire da 0) e limit (elementi per pagina, predefinito 10, massimo 1000). I risultati possono essere ordinati tramite sortBy (es. id, name) e sortOrder (asc o desc). I tipi di media supportati includono i formati immagine più comuni (JPEG, PNG, GIF) e i formati video (MP4). L'insieme esatto dei tipi accettati dipende dai requisiti del canale downstream. Restituisce 401 se la chiave API è mancante o non valida.
Ottieni un file media
Restituisce i metadati completi e l'URL di accesso di un singolo file multimediale identificato dal suo ID numerico. La risposta include il nome del file, il tipo MIME, la dimensione in byte, la data di creazione e un URL che puoi usare per scaricare il file o visualizzarne l'anteprima. È utile quando devi verificare i dettagli di un elemento media prima di farvi riferimento in un messaggio o in una campagna. Restituisce 404 se nella tua libreria non esiste alcun file multimediale con l'ID specificato. Restituisce 401 se la chiave API è mancante o non valida.
Elimina un file media
Elimina definitivamente un file multimediale dalla tua libreria. Questa azione non può essere annullata. I messaggi già inviati con questo media non sono interessati, perché il contenuto multimediale è stato consegnato al momento dell'invio. Tuttavia, qualsiasi messaggio o campagna futuri che fanno riferimento all'ID del media eliminato non riusciranno a risolvere il file. Prima di eliminarlo, assicurati che l'ID del media non sia referenziato in alcuna campagna programmata o template di messaggio non ancora inviati. Restituisce 204 in caso di successo, senza corpo di risposta. Restituisce 404 se nella tua libreria non esiste alcun file multimediale con l'ID specificato. Restituisce 409 se il media è pubblico o è ancora referenziato da un post sui social media. Restituisce 400 se il media è ancora in fase di caricamento. Restituisce 401 se la chiave API è mancante o non valida.