Visualización de informes de uso de SMS diarios

Puede monitorear sus entregas de SMS si se suscribe a los informes de uso diarios desde Amazon SNS. Todos los días que envía, como mínimo, un SMS, Amazon SNS entrega un informe de uso en formato CSV al bucket de Amazon S3 especificado. El informe de uso del SMS tarda 24 horas en estar disponible en el bucket de S3.

Información del informe de uso diario

El informe de uso contiene la siguiente información de cada mensaje SMS que envíe desde su cuenta.

Tenga en cuenta que el informe no incluye los mensajes que se envían a los destinatarios que han desactivado la recepción de mensajes.

• Hora de publicación del mensaje (en UTC)

• ID de mensaje

• Número de teléfono de destino.

• Tipo de mensaje.

• Estado de entrega.

• Precio del mensaje (en USD).

• Número de parte (un mensaje se divide en varias partes si es demasiado largo para un único mensaje).

• Número total de partes.

nota

Si Amazon SNS no recibió el número de parte, establecemos su valor en cero.

Suscripción a informes de uso diario

Para suscribirse a informes de uso diario, debe crear un bucket de Amazon S3 con los permisos pertinentes.

Si quiere crear un bucket de Amazon S3 para sus informes de uso diario, siga estos pasos:

1. Desde la Cuenta de AWS que envía mensajes SMS, inicie sesión en la consola de Amazon S3.

2. Seleccione la opción Create Bucket (Crear bucket).

3. En Bucket Name (Nombre del bucket), le recomendamos que escriba un nombre único para su cuenta y su organización. Por ejemplo, use el patrón <my-bucket-prefix>-<account_id>-<org-id>.

   Para obtener información sobre las convenciones y restricciones de los nombres de bucket, consulte Reglas para la nomenclatura de bucket en la Guía del usuario de Amazon Simple Storage Service.

4. Seleccione Create (Crear).

5. En la tabla Todos los buckets, elija el bucket.

6. En la pestaña Permisos, elija Política de bucket.

7. En la ventana Editor de políticas de bucket, indique una política que permita al principal del servicio de Amazon SNS escribir en el bucket. Para ver un ejemplo, consulte Ejemplo de política de bucket.

   Si utiliza la política de ejemplo, recuerde reemplazar my-s3-bucket por el nombre del bucket que eligiera en el paso 3.

8. Seleccione Save.

Para suscribirse a los informes de uso diario

1. Inicie sesión en la consola de Amazon SNS.

2. En el panel de navegación, elija Text messaging (SMS) (Mensajería de texto (SMS)).

3. En la página Mensajería de texto (SMS), en la sección Preferencias de mensajería de texto, elija Editar.

   

4. En la página Edit text messaging preferences (Editar preferencias de mensajería de texto), en la sección Details (Detalles), especifique el Amazon S3 bucket name for usage reports (Nombre del bucket de Amazon S3 para los informes de uso).

   

5. Elija Save changes.

Ejemplo de política de bucket

Con la siguiente política, la entidad principal del servicio de Amazon SNS puede ejecutar las acciones s3:PutObject, s3:GetBucketLocation y s3:ListBucket.

AWS proporciona herramientas para todos los servicios con entidades principales de servicio a las que se les ha concedido acceso a los recursos de su cuenta. Cuando la entidad principal de una declaración de política de bucket de Amazon S3 es una entidad principal de servicio de AWS, puede utilizar las claves de condición global aws:SourceArn o aws:SourceAccount para protegerse contra el problema del suplente confuso. Para limitar la región y la cuenta desde las que el bucket puede recibir informes de uso diarios, utilice aws:SourceArn tal como se muestra en el siguiente ejemplo. Si no desea limitar las regiones que pueden generar estos informes, utilice aws:SourceAccount para establecer límites en función de qué cuenta esté generando los informes. Si no conoce el ARN del recurso, utilice aws:SourceAccount.

Utilice el siguiente ejemplo que incluye protección contra suplente confuso cuando cree un bucket de Amazon S3 para recibir informes de uso diario de SMS desde Amazon SNS.

{
	"Version": "2008-10-17",
	"Statement": [{
			"Sid": "AllowPutObject",
			"Effect": "Allow",
			"Principal": {
				"Service": "sns.amazonaws.com"
			},
			"Action": "s3:PutObject",
			"Resource": "arn:aws:s3:::my-s3-bucket/*",
			"Condition": {
				"StringEquals": {
					"aws:SourceAccount": "account_id"
				},
				"ArnLike": {
					"aws:SourceArn": "arn:aws:sns:region:account_id:*"
				}
			}
		},
		{
			"Sid": "AllowGetBucketLocation",
			"Effect": "Allow",
			"Principal": {
				"Service": "sns.amazonaws.com"
			},
			"Action": "s3:GetBucketLocation",
			"Resource": "arn:aws:s3:::my-s3-bucket",
			"Condition": {
				"StringEquals": {
					"aws:SourceAccount": "account_id"
				},
				"ArnLike": {
					"aws:SourceArn": "arn:aws:sns:region:account_id:*"
				}
			}
		},
		{
			"Sid": "AllowListBucket",
			"Effect": "Allow",
			"Principal": {
				"Service": "sns.amazonaws.com"
			},
			"Action": "s3:ListBucket",
			"Resource": "arn:aws:s3:::my-s3-bucket",
			"Condition": {
				"StringEquals": {
					"aws:SourceAccount": "account_id"
				},
				"ArnLike": {
					"aws:SourceArn": "arn:aws:sns:region:account_id:*"
				}
			}
		}
	]
}

nota

Puede publicar informes de uso en buckets de Amazon S3 que sean propiedad de la Cuenta de AWS que se especifica en el elemento Condition en la política de Amazon S3. Para publicar informes de uso en un bucket de Amazon S3 propiedad de otra Cuenta de AWS, consulte ¿Cómo puedo copiar objetos S3 de otra Cuenta de AWS?.

Ejemplo de informe de uso diario

Después de suscribirse a informes de uso diario, cada día Amazon SNS pone un archivo CSV con datos de uso en la siguiente ubicación:

<my-s3-bucket>/SMSUsageReports/<region>/YYYY/MM/DD/00x.csv.gz

Cada archivo puede contener hasta 50 000 registros. Si los registros de un día superan esta cuota, Amazon SNS agregará varios archivos.

A continuación se muestra un informe de ejemplo:

PublishTimeUTC,MessageId,DestinationPhoneNumber,MessageType,DeliveryStatus,PriceInUSD,PartNumber,TotalParts
2016-05-10T03:00:29.476Z,96a298ac-1458-4825-a7eb-7330e0720b72,1XXX5550100,Promotional,Message has been accepted by phone carrier,0.90084,0,1
2016-05-10T03:00:29.561Z,1e29d394-d7f4-4dc9-996e-26412032c344,1XXX5550100,Promotional,Message has been accepted by phone carrier,0.34322,0,1
2016-05-10T03:00:30.769Z,98ba941c-afc7-4c51-ba2c-56c6570a6c08,1XXX5550100,Transactional,Message has been accepted by phone carrier,0.27815,0,1