Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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 di file sono diversi dai file multimediali rich card. Un messaggio contenente un file contiene un singolo file multimediale come l'intero contenuto del messaggio, mentre le rich card combinano elementi multimediali con testo e azioni suggerite. Per informazioni sulle rich card, vedereInvio di rich card RCS.

È possibile 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 sono annidati al suo interno).

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

Fonti degli URL dei file

Il FileUrl parametro accetta due formati di URL:

Politica sui bucket S3 per la consegna dei file

Per consentire AWS alla messaggistica con l'utente finale di recuperare i file dal tuo bucket Amazon S3, allega al bucket la seguente policy basata sulle risorse:

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::YOUR-BUCKET/*"
        }
    ]
}

YOUR-BUCKETSostituiscilo con il nome del bucket. Per limitare l'accesso a un prefisso specifico, sostituiscilo /* con il percorso desiderato (ad esempio,arn:aws:s3:::YOUR-BUCKET/rcs-media/*).

Tipi di supporti e limiti di dimensione supportati

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

Anteprime

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

Invio di un messaggio relativo al 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.

Il codice JSON seguente mostra il RcsMessageContent valore di un messaggio di file con suggerimenti:

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/documents/invoice.pdf",
            "ThumbnailUrl": "s3://my-media-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 se il messaggio scade prima della consegna (in base al TimeToLive valore), il servizio può tornare agli SMS o agli MMS a seconda della configurazione di fallback.

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