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.

Cómo empezar con Notify

En este tutorial, se explica cómo crear una configuración de Notify y cómo enviar el primer mensaje OTP. Puede completar este tutorial en unos 5 minutos.

Requisitos previos

La siguiente política de IAM concede permisos para enviar mensajes y buscar plantillas:

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sms-voice:SendNotifyTextMessage",
                "sms-voice:SendNotifyVoiceMessage",
                "sms-voice:DescribeNotifyTemplates",
                "sms-voice:DescribeNotifyConfigurations",
                "sms-voice:ListNotifyCountries",
                "sms-voice:PutMessageFeedback"
            ],
            "Resource": "*"
        }
    ]
}

La siguiente política otorga todos los permisos de administración de Notify:

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sms-voice:CreateNotifyConfiguration",
                "sms-voice:UpdateNotifyConfiguration",
                "sms-voice:DeleteNotifyConfiguration",
                "sms-voice:DescribeNotifyConfigurations",
                "sms-voice:DescribeNotifyTemplates",
                "sms-voice:ListNotifyCountries",
                "sms-voice:SendNotifyTextMessage",
                "sms-voice:SendNotifyVoiceMessage",
                "sms-voice:SetNotifyMessageSpendLimitOverride",
                "sms-voice:DeleteNotifyMessageSpendLimitOverride",
                "sms-voice:PutMessageFeedback"
            ],
            "Resource": "*"
        }
    ]
}

Para restringir los permisos a una configuración de Notify específica, utilice el ARN de configuración para las acciones a nivel de recursos (comoSendNotifyTextMessage,, SendNotifyVoiceMessage DescribeNotifyConfigurationsCreateNotifyConfiguration, UpdateNotifyConfiguration y). DeleteNotifyConfiguration Las acciones que no admiten permisos a nivel de recursos (comoDescribeNotifyTemplates, ListNotifyCountriesSetNotifyMessageSpendLimitOverride, DeleteNotifyMessageSpendLimitOverride y) son obligatorias. PutMessageFeedback "Resource": "*"

Paso 1: Crear una configuración de Notify

Console

1. Abra la consola SMS de mensajería para el usuario AWS final en https://console.aws.amazon.com/sms-voice/.

2. En el panel de navegación, en Notificar, elija Notificar configuraciones.

3. Seleccione Crear configuración de notificación.

4. En Nombre para mostrar, introduzca el nombre de su marca (por ejemplo,AcmeCorp).

5. En el caso de uso, la verificación del código se selecciona automáticamente.

6. Para los canales, selecciona SMS, VOZ o ambos.

7. (Opcional) Amplíe la configuración avanzada para seleccionar países, una plantilla predeterminada, un grupo asociado o habilite la protección contra la eliminación.

8. Seleccione Crear configuración de notificación.

La configuración se crea en estado Pendiente mientras el sistema valida la cuenta. Una vez validada, el estado cambia a Activo y puede empezar a enviar mensajes.

nota

La creación de la configuración incluye la validación automática de la cuenta y la comprobación del nombre de la marca. La mayoría de las configuraciones se activan en cuestión de segundos. Si el nombre de tu marca requiere verificación, el estado será Requiere verificación.

AWS CLI

aws pinpoint-sms-voice-v2 create-notify-configuration \
    --display-name "AcmeCorp" \
    --use-case CODE_VERIFICATION \
    --enabled-channels SMS

Estados de configuración:

Paso 2: Busca las plantillas disponibles

Antes de enviarlas, comprueba qué plantillas están disponibles para tu nivel y canal:

aws pinpoint-sms-voice-v2 describe-notify-templates \
    --filters '[{"Name":"channels","Values":["SMS"]},{"Name":"tier-access","Values":["BASIC"]}]'

Paso 3: envía un mensaje de prueba

Console

1. En la lista de configuraciones de Notify, elija su configuración.

2. Elija la pestaña Prueba.

3. Seleccione una plantilla de la tabla de plantillas.

4. En Número de teléfono de destino, introduzca un número de teléfono en formato E.164 (por ejemplo,+12065550100).

5. Rellene las variables de la plantilla (por ejemplo, introduzca 123456 la variable de código).

6. Seleccione Enviar.

AWS CLI

aws pinpoint-sms-voice-v2 send-notify-text-message \
    --notify-configuration-id "nc-1234567890abcdef0" \
    --destination-phone-number "+12065550100" \
    --template-id "notify-code-verification-english-001" \
    --template-variables '{"code":"123456"}'

Python (boto3)

import boto3

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

response = client.send_notify_text_message(
    NotifyConfigurationId='nc-1234567890abcdef0',
    DestinationPhoneNumber='+12065550100',
    TemplateId='notify-code-verification-english-001',
    TemplateVariables={
        'code': '123456'
    }
)

print(f"Message ID: {response['MessageId']}")
print(f"Resolved body: {response['ResolvedMessageBody']}")

Paso 4: Comprueba los países disponibles

ListNotifyCountriesÚsalo para ver qué países están disponibles para tu nivel y canal:

aws pinpoint-sms-voice-v2 list-notify-countries \
    --channels SMS \
    --tier BASIC

Siguientes pasos