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.

Recepción de mensajes de RCS entrantes

AWSLa mensajería para el usuario final admite la mensajería RCS bidireccional, lo que le permite recibir mensajes de texto de sus clientes. Los mensajes RCS entrantes siguen el mismo patrón que la mensajería bidireccional SMS: los mensajes entrantes se entregan en un tema de Amazon SNS que usted configure y usted los procesa mediante funciones de Lambda u otros suscriptores de SNS.

En esta sección se explica cómo funciona la mensajería RCS bidireccional, cómo habilitarla para su agente RCS de AWS, el formato de carga útil de los mensajes entrantes y cómo administrar las palabras clave. Para obtener información sobre la administración de los agentes de AWS RCS, consulteAdministración de agentes de RCS. Para obtener información sobre el envío de mensajes de RCS, consulte. Envío de mensajes de RCS

Cómo funciona la mensajería RCS bidireccional

Cuando un cliente envía un mensaje de texto a su agente de AWS RCS, AWS End User Messaging recibe el mensaje y lo publica en un tema de Amazon SNS que usted designe. Desde allí, puede procesar el mensaje con cualquier suscriptor de SNS, como una función Lambda, una cola de Amazon SQS o un punto final. HTTP/HTTPS

El flujo de mensajería RCS bidireccional funciona de la siguiente manera:

Además de los mensajes de texto, los clientes pueden enviar contenido multimedia (imágenes, vídeos, archivos de audio y documentos) a su agente de AWS RCS. Al configurar el almacenamiento multimedia entrante, AWS End User Messaging guarda el contenido multimedia en su bucket de Amazon S3 y publica una notificación en su tema de SNS con la ubicación del archivo y los metadatos. Para obtener más información, consulte Recepción de medios RCS entrantes.

Configurar el destino de mensajería bidireccional

Para recibir y procesar los mensajes RCS entrantes en su aplicación, debe habilitar la mensajería bidireccional y configurar un destino en su agente RCS de AWS. Two-way la mensajería está deshabilitada de forma predeterminada. Al habilitarla, especificas un tema de Amazon SNS en el que AWS End User Messaging entregue los mensajes entrantes. Puede configurar el destino mediante la consola de mensajería para el usuario AWS final o la API.

Console

Para configurar el destino de la mensajería bidireccional mediante la consola

1. Abra la consola de mensajería para el usuario AWS final.

2. En el panel de navegación, elija los agentes de RCS.

3. Elija el agente RCS de AWS que desee configurar.

4. Elija la pestaña Two-way de mensajería.

5. Elija Editar configuración.

6. Activa la opción Habilitar la mensajería bidireccional.

7. Para el tema de SNS, elija un tema de Amazon SNS existente o cree uno nuevo. Este es el tema en el que se publican los mensajes entrantes.

8. Seleccione Save.

AWS CLI

Para configurar tu destino de mensajería bidireccional mediante la API, llama a la UpdateRcsAgent API con los siguientes parámetros:

• two-way-enabled— Configúrelo true para habilitar la mensajería bidireccional.

• two-way-channel-arn— El ARN del tema Amazon SNS donde se publican los mensajes entrantes.

• two-way-channel-role— El ARN de la función de IAM que concede permiso a AWS End User Messaging para publicar mensajes en el tema de SNS.

El siguiente ejemplo configura el destino de mensajería bidireccional mediante la CLIAWS:

aws pinpoint-sms-voice-v2 update-rcs-agent \
    --rcs-agent-id rcs-a1b2c3d4 \
    --two-way-enabled \
    --two-way-channel-arn arn:aws:sns:us-east-1:123456789012:MyRCSInboundTopic \
    --two-way-channel-role arn:aws:iam::123456789012:role/SMSVoiceSNSPublishRole
                    

Permisos de temas de SNS

El tema de Amazon SNS que configure para la mensajería RCS bidireccional debe permitir que AWS End User Messaging publique mensajes en él. Tiene dos opciones para conceder el acceso.

Opción 1: utilizar un rol de IAM

Cree una función de IAM que la mensajería de usuario AWS final pueda asumir para publicar mensajes en su tema de SNS. El rol necesita una política de confianza y una política de permisos.

Esta es la política de confianza para el rol de IAM. accountIdSustitúyalo por el identificador único de suCuenta de AWS.

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

Esta es la política de permisos para el rol de IAM. El SMSVoiceAllowSNSPublish Sid permite publicar temas en Amazon SNS y el SMSVoiceAllowEncryptedSNSTopics Sid es opcional para temas cifrados de Amazon SNS. Realice los siguientes cambios:

{
  "Version": "2012-10-17", 
  "Statement": [
    {
      "Sid": "SMSVoiceAllowSNSPublish",
      "Effect": "Allow",
      "Action": "sns:Publish",
      "Resource": "arn:partition:sns:region:accountId:snsTopicName",
      "Condition": {
        "StringEquals": {
          "aws:ResourceAccount": "accountId"
        }
      }
    },
    {
      "Sid": "SMSVoiceAllowEncryptedSNSTopics",
      "Effect": "Allow",
      "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey*"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:EncryptionContext:aws:sns:topicArn": "arn:partition:sns:region:accountId:snsTopicName",
          "aws:CalledViaLast": "sns.amazonaws.com"
        }
      }
    }
  ]
}

Opción 2: utilice una política de temas de SNS

Como alternativa, puede añadir directamente al tema del SNS una declaración de política que permita a AWS End User Messaging publicar mensajes. snsTopicArnSustitúyalo por el ARN de su tema de SNS.

{
  "Effect": "Allow",
  "Principal": {
    "Service": "sms-voice.amazonaws.com"
  },
  "Action": "sns:Publish",
  "Resource": "snsTopicArn"
}

Formato de carga útil de los mensajes entrantes

Cuando su agente de AWS RCS recibe un mensaje de texto entrante, AWS End User Messaging publica una carga útil JSON en el tema de Amazon SNS configurado. La carga útil de los mensajes entrantes de RCS utiliza el mismo formato que la mensajería bidireccional SMS:

{
  "originationNumber": "+14255550182",
  "destinationNumber": "+12125550101",
  "messageKeyword": "JOIN",
  "messageBody": "EXAMPLE",
  "inboundMessageId": "cae173d2-66b9-564c-8309-21f858e9fb84",
  "previousPublishedMessageId": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
}
        

La carga útil de los mensajes entrantes contiene los siguientes campos:

Tipos de mensajes admitidos

AWSLa mensajería para el usuario final admite los siguientes tipos de mensajes RCS entrantes. Cuando un cliente envía un mensaje a su agente de AWS RCS, AWS End User Messaging envía una notificación al tema de Amazon SNS configurado para su procesamiento.

Gestión de palabras clave para RCS

Las palabras clave le permiten configurar respuestas automáticas cuando los clientes envían palabras o frases específicas a su agente de AWS RCS. Cuando un mensaje entrante coincide con una palabra clave configurada, la mensajería del usuario AWS final devuelve al cliente el mensaje de respuesta automática asociado.

En el caso de RCS, las palabras clave se configuran en el agente de AWS RCS y se aplican a todos los ID de RCS for Business asociados (agente de pruebas y agentes de lanzamiento nacionales). Puede configurar hasta 30 palabras clave por agente de AWS RCS.

Para administrar las palabras clave de su agente RCS de AWS, utilice la consola de mensajería para el usuario AWS final o la API. Para obtener información general sobre la administración de palabras clave, consultePalabras clave en los SMS de mensajería para usuarios AWS finales.

Procesamiento de mensajes entrantes con Lambda

Un patrón común para procesar los mensajes RCS entrantes consiste en suscribir una función Lambda al tema Amazon SNS configurado para la mensajería bidireccional. La función Lambda recibe la carga útil de los mensajes entrantes y puede implementar la lógica de la aplicación, como responder a las consultas de los clientes, procesar comandos o enrutar mensajes a otros sistemas.

El siguiente ejemplo de Python muestra una función Lambda que procesa los mensajes RCS entrantes y envía una respuesta mediante la API: SendTextMessage

import json
import boto3

sms_client = boto3.client('pinpoint-sms-voice-v2')

def lambda_handler(event, context):
    # Parse the SNS message
    for record in event['Records']:
        sns_message = json.loads(record['Sns']['Message'])

        origination_number = sns_message['originationNumber']
        message_body = sns_message['messageBody']
        keyword = sns_message.get('messageKeyword', '')

        print(f"Received message from {origination_number}: {message_body}")

        # Process the message and determine a response
        if keyword.upper() == 'HELP':
            response_text = 'Available commands: HELP, STATUS, STOP'
        elif keyword.upper() == 'STATUS':
            response_text = 'Your account is active. No action needed.'
        else:
            response_text = (
                f'Thanks for your message. '
                f'Reply HELP for available commands.'
            )

        # Send a response back to the customer
        try:
            response = sms_client.send_text_message(
                DestinationPhoneNumber=origination_number,
                OriginationIdentity='pool-a1b2c3d4e5f6g7h8i',
                MessageBody=response_text,
                MessageType='TRANSACTIONAL'
            )
            print(f"Response sent. Message ID: {response['MessageId']}")
        except Exception as e:
            print(f"Failed to send response: {str(e)}")

    return {'statusCode': 200}
        

En este ejemplo, la función Lambda:

Prácticas recomendadas para la mensajería RCS entrante

Siga estas prácticas recomendadas al implementar la mensajería RCS bidireccional: