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
+ Un Cuenta de AWS.
+ Permisos de IAM para las operaciones de mensajería SMS de los usuarios AWS finales. Para obtener más información, consulte [Administración de identidad y acceso para la mensajería SMS de usuario AWS final](security-iam.md).
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 (como`SendNotifyTextMessage`,, `SendNotifyVoiceMessage` `DescribeNotifyConfigurations``CreateNotifyConfiguration`, `UpdateNotifyConfiguration` y). `DeleteNotifyConfiguration` Las acciones que no admiten permisos a nivel de recursos (como`DescribeNotifyTemplates`, `ListNotifyCountries``SetNotifyMessageSpendLimitOverride`, `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/](https://console.aws.amazon.com/sms-voice/).
1. En el panel de navegación, en **Notificar**, elija **Notificar configuraciones**.
1. Seleccione **Crear configuración de notificación**.
1. En **Nombre para mostrar**, introduzca el nombre de su marca (por ejemplo,`AcmeCorp`).
1. **En el caso de uso**, la **verificación del código** se selecciona automáticamente.
1. Para **los canales**, selecciona **SMS**, **VOZ** o ambos.
1. (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.
1. 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:
PENDIENTE
La configuración se está validando.
ACTIVE
Listo para enviar mensajes.
REQUIERE VERIFICACIÓN
El nombre de la marca requiere verificación antes de la activación.
REJECTED
Se rechazó la configuración. Compruebe `RejectionReason` los detalles.
## 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.
1. Elija la pestaña **Prueba**.
1. Seleccione una plantilla de la tabla de plantillas.
1. En **Número de teléfono de destino**, introduzca un número de teléfono en formato E.164 (por ejemplo,`+12065550100`).
1. Rellene las variables de la plantilla (por ejemplo, introduzca `123456` la variable **de código**).
1. 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
+ [Administración de configuraciones de Notify](notify-configurations.md)— Obtén información sobre todas las opciones de configuración.
+ [Trabajar con plantillas de Notify](notify-templates.md)— Explore y comprenda las plantillas disponibles.
+ [Notificar niveles](notify-tiers.md)— Obtenga información sobre los niveles y cómo actualizar a Avanzado.
+ [Notificar los límites de gasto](notify-spend-limits.md)— Administra tus límites de gasto de Notify.