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 da mídia 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 no nível da mensagem, como chips de resposta ou botões de ação, às mensagens do 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://amzn-s3-demo-bucket/campaigns/welcome-image.png",
            "ThumbnailUrl": "s3://amzn-s3-demo-bucket/thumbnails/welcome-thumb.jpg"
        }
    },
    "Suggestions": []
}

Fontes de URL de arquivos

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 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:::amzn-s3-demo-bucket/*",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}

123456789012Substitua pelo ID da conta do seu Conta da AWS. amzn-s3-demo-bucketSubstitua pelo nome do seu bucket do S3. Para restringir o acesso a um prefixo específico no bucket, /* substitua pelo caminho — por exemplo,. arn:aws:s3:::amzn-s3-demo-bucket/rcs-media/*

Tipos de mídia compatíveis e limites de tamanho

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 arquivos 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 exemplo de JSON a seguir mostra o RcsMessageContent valor de uma mensagem de arquivo com sugestões.

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

Entrega e recuo

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 a mensagem expirar antes da entrega (com base no TimeToLive valor), o serviço poderá recorrer a SMS ou MMS, dependendo da sua configuração alternativa.

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