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 ofrece un único elemento multimedia como contenido completo del mensaje, mientras que las tarjetas enriquecidas combinan contenido multimedia con texto y sugerencias de acciones. Para obtener información sobre las tarjetas enriquecidas, consulteEnvío de tarjetas RCS Rich.

Puede adjuntar sugerencias a nivel de mensaje (como fichas 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://my-media-bucket/campaigns/welcome-image.png",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/welcome-thumb.jpg"
        }
    },
    "Suggestions": []
}

Fuentes de URL de archivos

El FileUrl parámetro acepta dos formatos de URL:

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

Para permitir que AWS End User Messaging recupere archivos de su bucket de Amazon S3, adjunte la siguiente política basada en recursos al bucket:

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

Reemplace YOUR-BUCKET con el nombre del bucket. Para restringir el acceso a un prefijo específico, /* sustitúyalo por la ruta deseada (por ejemplo,). arn:aws:s3:::YOUR-BUCKET/rcs-media/*

Tipos de soportes y límites de tamaño admitidos

En la siguiente tabla se enumeran los tipos de medios compatibles conFileMessage.

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 de 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 JSON muestra el RcsMessageContent valor de un mensaje de archivo con sugerencias:

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

Al enviar un mensaje de archivo, la mensajería del usuario AWS final intenta entregarlo a través del canal RCS. Si el dispositivo del destinatario no es compatible con RCS o si el mensaje caduca antes de la entrega (según el TimeToLive valor), el servicio puede recurrir a SMS o MMS en función de la configuración alternativa.

Puede configurar la opción 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