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á.

Recebendo mídia RCS de entrada

Os usuários podem enviar mídia (imagens, vídeos, arquivos de áudio e documentos) em conversas RCS com seu agente. Quando você configura o armazenamento de mídia de entrada, o AWS End User Messaging baixa a mídia do provedor RCS, a carrega em seu bucket do Amazon S3 e publica uma notificação em seu tópico bidirecional do Amazon SNS com a localização do S3 e os metadados do arquivo.

Para obter informações gerais sobre o recebimento de mensagens RCS de entrada (respostas de texto, localização e sugestões), consulte. Receber mensagens RCS de entrada Para obter informações sobre o envio de mídia avançada aos usuários, consulteEnviando mensagens ricas de RCS.

Como funciona a mídia de entrada

Quando um usuário envia um arquivo de mídia em uma conversa RCS, o AWS End User Messaging processa a mensagem por meio das seguintes etapas:

Para tipos de SUGGESTION mensagem LOCATION e tipo, nenhum upload do S3 ocorre. O conteúdo é entregue diretamente no corpo de notificação do SNS. Para obter detalhes sobre esses tipos de mensagem, consulteReceber mensagens RCS de entrada.

Configurando o armazenamento de mídia de entrada

Para receber mídia de entrada, configure os seguintes campos em seu agente RCS usando a UpdateRcsAgent API. Two-way as mensagens devem ser habilitadas no agente antes de você configurar o armazenamento de mídia.

O bucket do S3 e a função do IAM são necessários juntos. Se você especificar um, deverá especificar os dois.

Formato de chave S3

Os objetos de mídia são armazenados com o seguinte formato de chave, em que o nome do arquivo original é anexado após um # separador:

{prefix}/rcs/{messageId}#{fileName}

Por exemplo, se você definir o prefixo da chave comoinbound-media, um arquivo de mídia poderá ser armazenado como:

inbound-media/rcs/msg-abc123def456#photo_2026.jpg

Criação da função do IAM para mídia de entrada

Crie uma função do IAM que permita que o serviço AWS End User Messaging faça upload de arquivos de mídia para seu bucket do S3. A função exige uma política de confiança que permita que o serviço a assuma e uma política de permissão que conceda s3:PutObject acesso ao seu bucket.

Política de confiança

A política de confiança a seguir permite que o diretor do serviço de mensagens do usuário AWS final assuma a função. 123456789012Substitua pelo ID AWS da sua conta.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}

Política de permissão

A política de permissão a seguir concede à função acesso para gravar objetos em seu bucket do S3. Substitua my-rcs-media-bucket pelo nome do seu bucket.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject"
            ],
            "Resource": "arn:aws:s3:::my-rcs-media-bucket/*"
        }
    ]
}

Configurando o armazenamento de mídia (CLI)

O comando AWS CLI a seguir configura o armazenamento de mídia de entrada em um agente RCS existente:

aws pinpoint-sms-voice-v2 update-rcs-agent \
    --rcs-agent-id rcs-agent-1234567890abcdef0 \
    --two-way-media-s3-bucket-name my-rcs-media-bucket \
    --two-way-media-s3-key-prefix "inbound-media" \
    --two-way-media-s3-role arn:aws:iam::123456789012:role/RcsInboundMediaRole \
    --region us-east-1

Carga útil de notificação de mídia de entrada

Quando o AWS End User Messaging recebe um arquivo de mídia, ele publica uma notificação em seu tópico bidirecional do SNS. A notificação é um objeto JSON com um messageBody campo que contém um documento JSON em sequência com o status da mídia e, em caso de sucesso, a localização do S3 e os metadados do arquivo.

O exemplo a seguir mostra uma notificação de mídia de entrada bem-sucedida:

{
    "originationNumber": "+14255551234",
    "destinationNumber": "rcs-cb1e6e519e9049fabf8c0ae38e4d876b",
    "messageBody": "{\"mediaStatus\":\"SUCCESS\",\"s3Bucket\":\"my-rcs-media-bucket\",\"s3Key\":\"inbound-media/rcs/msg-abc123def456#photo_2026.jpg\",\"mimeType\":\"image/jpeg\",\"fileName\":\"photo_2026.jpg\",\"fileSizeBytes\":1211843}",
    "inboundMessageId": "8821d750-4bc5-4cb1-a8c3-c3d64a38d019"
}

A notificação de nível superior contém os seguintes campos:

O messageBody JSON contém os seguintes campos:

Tratamento de falhas no download de mídia

Se o AWS End User Messaging não puder baixar ou armazenar mídia do provedor de RCS, o serviço ainda publicará uma notificação para seu tópico bidirecional do SNS. O messageBody carrega uma falha mediaStatus (UPLOAD_FAILEDouROLE_ASSUME_FAILED) e uma mediaStatusMessage descrição da causa, sem campos de localização do S3.

Por exemplo, uma falha na suposição de uma função do IAM produz o seguinte messageBody conteúdo:

{
    "mediaStatus": "ROLE_ASSUME_FAILED",
    "mediaStatusMessage": "Media received but could not assume the configured IAM role",
    "mimeType": "image/heic",
    "fileName": "IMG_7115.heic",
    "fileSizeBytes": 1211843
}

As causas comuns de falhas no download de mídia incluem:

Para solucionar falhas de entrega, verifique se suas políticas de confiança e permissão da função do IAM estão configuradas corretamente e se o bucket do S3 existe e pode ser acessado pelo serviço. Monitore CloudWatch as métricas do seu agente quanto a falhas no upload de mídia.

Tipos de mídia aceitos

AWSO End User Messaging aceita os seguintes tipos de MIME de mídia de entrada:

Práticas recomendadas