As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Enviando mensagens de arquivo RCS

Você pode usar o tipo de FileMessage conteúdo na SendRcsMessage API para enviar imagens, vídeos, arquivos de áudio e PDFs como mensagens independentes para seus destinatários. As mensagens de arquivo aparecem como mídia embutida no aplicativo de mensagens do destinatário.

As mensagens de arquivo são diferentes das mídias de rich card. Uma mensagem de arquivo fornece uma única mídia como todo o conteúdo da mensagem, enquanto os rich cards combinam mídia com texto e ações sugeridas. Para obter informações sobre rich cards, consulteEnviando cartões ricos em RCS.

Você pode anexar sugestões em nível de mensagem (como chips de resposta ou botões de ação) às mensagens de arquivo. Para obter detalhes sobre sugestões, consulteConfigurando sugestões de RCS.

FileMessage estrutura

O FileMessage objeto está aninhado dentro do Content campo do RcsMessageContent parâmetro. Message-levelSuggestionssão irmãos de Content (não estão aninhados dentro dele).

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

Fontes de URL de arquivo

O FileUrl parâmetro aceita dois formatos de URL:

Política de bucket do S3 para entrega de arquivos

Para permitir que o AWS End User Messaging recupere arquivos do seu bucket do Amazon S3, anexe a seguinte política baseada em recursos ao bucket:

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

Substitua YOUR-BUCKET pelo nome do seu bucket. Para restringir o acesso a um prefixo específico, /* substitua pelo caminho desejado (por exemplo,arn:aws:s3:::YOUR-BUCKET/rcs-media/*).

Tipos de mídia e limites de tamanho suportados

A tabela a seguir lista os tipos de mídia suportados peloFileMessage.

Miniaturas

Você pode fornecer uma imagem em miniatura para mensagens de vídeo e arquivo PDF usando o ThumbnailUrl parâmetro. A miniatura é exibida como uma prévia na conversa antes que o destinatário abra ou baixe o arquivo completo.

Enviando uma mensagem de arquivo

Para enviar uma mensagem de arquivo, chame a SendRcsMessage API com um FileMessage objeto dentro do RcsMessageContent parâmetro. Você especifica a identidade de origem (um pool ou um agente AWS RCS) usando o --origination-identity parâmetro.

O JSON a seguir mostra o RcsMessageContent valor de uma mensagem de arquivo com sugestões:

{
    "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"
            }
        }
    ]
}

Entrega e devolução

Quando você envia uma mensagem de arquivo, o AWS End User Messaging tenta entregá-la pelo canal RCS. Se o dispositivo do destinatário não suportar RCS ou se a mensagem expirar antes da entrega (com base no TimeToLive valor), o serviço poderá voltar para SMS ou MMS, dependendo da configuração de fallback.

Você pode configurar o fallback de SMS ou MMS no nível do pool ou por mensagem. Para obter detalhes sobre o comportamento de fallback, consulteEnviando mensagens ricas de RCS.