FileMessage struttura Fonti URL dei file Politica del bucket S3 per la consegna dei file Tipi di file multimediali supportati e limiti di dimensione Anteprime Invio di un messaggio relativo a un file Consegna e fallback

Invio di messaggi di file RCS

Puoi utilizzare il tipo di FileMessage contenuto nell'SendRcsMessageAPI per inviare immagini, video, file audio e PDF come messaggi autonomi ai destinatari. I messaggi di file vengono visualizzati come file multimediali in linea nell'app di messaggistica del destinatario.

I messaggi in formato file sono diversi dai rich card multimediali. Un file di messaggio recapita un singolo elemento multimediale come contenuto completo del messaggio, mentre le rich card combinano contenuti multimediali con testo e azioni suggerite. Per informazioni sulle rich card, vedereInvio di rich card RCS.

Puoi allegare suggerimenti a livello di messaggio, come chip di risposta o pulsanti di azione, ai messaggi di file. Per informazioni dettagliate sui suggerimenti, consulta. Configurazione dei suggerimenti RCS

FileMessage struttura

L'FileMessageoggetto è annidato all'interno del Content campo del RcsMessageContent parametro. Message-levelSuggestionssono fratelli di Content (non annidati al suo interno).


{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://amzn-s3-demo-bucket/campaigns/welcome-image.png",
            "ThumbnailUrl": "s3://amzn-s3-demo-bucket/thumbnails/welcome-thumb.jpg"
        }
    },
    "Suggestions": []
}

FileUrl (obbligatorio): L'URL Amazon S3 o HTTPS del file da inviare. La lunghezza massima è di 2.000 caratteri. L'URL deve corrispondere al modello^(https://|s3://).+$. Il file può avere una dimensione massima di 100 MB.
ThumbnailUrl (facoltativo): L'URL Amazon S3 o HTTPS di un'immagine in miniatura. La lunghezza massima è di 2.000 caratteri. L'URL segue lo stesso schema URL diFileUrl. Consigliato per file video e PDF.

Fonti URL dei file

Il FileUrl parametro accetta due formati di URL:

URL Amazon S3 (s3://bucket-name/object-key): quando si specifica un URL Amazon S3, AWS End User Messaging recupera l'oggetto, lo reospita e genera un URL prefirmato a tempo limitato per la consegna al dispositivo del destinatario. Il bucket S3 deve avere una policy basata sulle risorse che conceda al servizio l'accesso in lettura. Per ulteriori informazioni, consulta Politica del bucket S3 per la consegna dei file.
URL HTTPS (https://cdn.example.com/path/to/file.jpg): l'URL viene trasmesso al corriere per la consegna. L'URL deve essere accessibile pubblicamente senza autenticazione. http://Gli URL semplici non sono supportati.

Nota

Quando utilizzi un URL Amazon S3, l'API convalida al momento della richiesta che l'oggetto esista, rientri nei limiti di dimensione e sia accessibile. Se la convalida fallisce, l'API restituisce un ValidationException errore con un messaggio di errore descrittivo. Gli URL HTTPS non vengono convalidati al momento della richiesta nello stesso modo.

Politica del bucket S3 per la consegna dei file

Per consentire a AWS End User Messaging di recuperare i file dal bucket S3, allega al bucket la seguente politica basata sulle risorse:


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}

Sostituisci con l'ID 123456789012 dell'account del tuo. Account AWS Sostituiscilo amzn-s3-demo-bucket con il nome del tuo bucket S3. Per limitare l'accesso a un prefisso specifico nel bucket, sostituiscilo /* con il percorso, ad esempio,. arn:aws:s3:::amzn-s3-demo-bucket/rcs-media/*

Nota

Se il bucket S3 utilizza la SSE-KMS crittografia, la policy relativa alle chiavi AWS KMS key deve inoltre concedere le autorizzazioni affinché il servizio utilizzi la chiave. sms-voice.amazonaws.com SSE-S3 la crittografia non richiede una configurazione aggiuntiva.

Tipi di file multimediali supportati e limiti di dimensione

La tabella seguente elenca i tipi di file multimediali supportati daFileMessage.

Tipo MIME	Estensioni	Dimensione massima	Note
`image/jpeg`	.jpeg, .jpg	100 MB	Consigliato per fotografie.
`image/png`	.png	100 MB	Supporta la trasparenza. Consigliato per grafica e loghi.
`image/gif`	.gif	100 MB	Le GIF animate vengono riprodotte su Android. Renderizzate come statiche su iOS.
`video/mp4`	.mp4	5 MB	H.264 codec consigliato per la massima compatibilità.
`video/webm`	.webm	5 MB	VP8/VP9 codec. Supportato principalmente su Android.
`audio/mp3`	.mp3	100 MB	Il più ampio supporto per la riproduzione di audio.
`audio/aac`	.aac	100 MB	Formato audio alternativo.
`application/pdf`	.pdf	100 MB	Il supporto varia in base all'operatore e all'area geografica.

Importante

Il limite di dimensione del file di 100 MB viene applicato a livello di API. I singoli corrieri potrebbero imporre limiti inferiori per la consegna ai dispositivi finali. Per i video, i gestori di solito applicano un limite massimo di 5 MB. Conserva i file video al di sotto dei 5 MB per garantire la corretta consegna.

Anteprime

È possibile fornire un'immagine in miniatura per i messaggi video e in formato PDF utilizzando il ThumbnailUrl parametro. La miniatura viene visualizzata come anteprima nella conversazione prima che il destinatario apra o scarichi il file completo.

I formati di anteprima supportati sono JPEG e PNG.
L'URL delle miniature segue le stesse regole di formato FileUrl (Amazon S3 o HTTPS, massimo 2.000 caratteri).
Usa un rapporto di aspetto che corrisponda al file originale per evitare il ritaglio sul dispositivo.

Invio di un messaggio relativo a un file

Per inviare un messaggio di file, chiama l'SendRcsMessageAPI con un FileMessage oggetto all'interno del RcsMessageContent parametro. È possibile specificare l'identità di origine (un pool o un agente AWS RCS) utilizzando il --origination-identity parametro.

L'esempio JSON seguente mostra il RcsMessageContent valore di un messaggio di file con suggerimenti.


{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://amzn-s3-demo-bucket/documents/invoice.pdf",
            "ThumbnailUrl": "s3://amzn-s3-demo-bucket/thumbnails/invoice-thumb.jpg"
        }
    },
    "Suggestions": [
        {
            "Reply": {
                "Text": "Download receipt",
                "PostbackData": "action=download_receipt"
            }
        }
    ]
}

Consegna e fallback

Quando si invia un messaggio di file, AWS End User Messaging tenta di recapitarlo tramite il canale RCS. Se il dispositivo del destinatario non supporta RCS o il messaggio scade prima della consegna (in base al TimeToLive valore), il servizio può ricorrere a SMS o MMS a seconda della configurazione di riserva utilizzata.

È possibile configurare il fallback SMS o MMS a livello di pool o per messaggio. Per informazioni dettagliate sul comportamento di fallback, vedere. Invio di messaggi RCS complessi

Importante

I messaggi relativi ai file RCS sono disponibili in tutti i paesi in cui RCS è supportato. Per l'elenco attuale, vedere. Paesi supportati per RCS

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Messaggi di testo

Carte ricche