Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Envío de mensajes de archivos RCS

Puedes usar el tipo de FileMessage contenido de la SendRcsMessage API para enviar imágenes, vídeos, archivos de audio y archivos PDF como mensajes independientes a tus destinatarios. Los mensajes de archivo aparecen como contenido multimedia integrado en la aplicación de mensajería del destinatario.

Los mensajes de archivo son distintos de los de las tarjetas enriquecidas. Un mensaje de archivo contiene un único elemento multimedia como todo el contenido del mensaje, mientras que las tarjetas enriquecidas combinan el contenido multimedia con texto y acciones sugeridas. Para obtener información sobre las tarjetas enriquecidas, consulteEnvío de tarjetas RCS Rich.

Puede adjuntar sugerencias a nivel de mensaje, como chips de respuesta o botones de acción, a los mensajes de archivo. Para obtener más información sobre las sugerencias, consulte. Configuración de sugerencias de RCS

FileMessage estructura

El FileMessage objeto está anidado dentro del Content campo del RcsMessageContent parámetro. Message-levelSuggestionsson hermanos de Content (no están anidados dentro de él).

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

Fuentes de URL de archivos

El FileUrl parámetro acepta dos formatos de URL:

Política de buzones de S3 para la entrega de archivos

Para permitir que la mensajería de usuario AWS final recupere archivos de tu bucket de S3, adjunta al bucket la siguiente política basada en los recursos:

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

123456789012Sustitúyalo por el identificador de cuenta de su. Cuenta de AWSamzn-s3-demo-bucketSustitúyelo por el nombre de tu bucket de S3. Para restringir el acceso a un prefijo específico del bucket, /* sustitúyalo por la ruta (por ejemplo,. arn:aws:s3:::amzn-s3-demo-bucket/rcs-media/*

Límites de tamaño y tipos de medios compatibles

En la tabla siguiente se enumeran los tipos de medios compatiblesFileMessage.

Miniaturas

Puede proporcionar una imagen en miniatura para los mensajes de vídeo y archivos PDF mediante el ThumbnailUrl parámetro. La miniatura se muestra como una vista previa en la conversación antes de que el destinatario abra o descargue el archivo completo.

Enviar un mensaje de archivo

Para enviar un mensaje de archivo, llama a la SendRcsMessage API con un FileMessage objeto dentro del RcsMessageContent parámetro. La identidad de origen (un grupo o un agente de AWS RCS) se especifica mediante el --origination-identity parámetro.

El siguiente ejemplo de JSON muestra el RcsMessageContent valor de un mensaje de archivo con sugerencias.

{
    "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 y respaldo

Cuando envías un mensaje de archivo, la mensajería de usuario AWS final intenta entregarlo a través del canal RCS. Si el dispositivo del destinatario no admite el RCS o el mensaje caduca antes de la entrega (según el TimeToLive valor), el servicio puede recurrir a SMS o MMS, según la configuración alternativa que tengas.

Puedes configurar la alternativa de SMS o MMS a nivel de grupo o por mensaje. Para obtener más información sobre el comportamiento alternativo, consulte. Envío de mensajes RCS enriquecidos