¿Cómo puedo crear una aplicación de plataforma Android en Amazon SNS para enviar notificaciones de inserción?

Breve descripción

Si quiere crear una aplicación de plataforma en Amazon SNS para enviar notificaciones push a dispositivos Android, realice una de las siguientes acciones:

• Utilice la consola de Amazon SNS para crear una aplicación de plataforma Android.
• Ejecute el comando create-platform-application de la Interfaz de la línea de comandos de AWS (AWS CLI) para crear una aplicación de plataforma Android.

Solución

Nota: Las notificaciones push de Amazon SNS no están disponibles en todas las regiones de AWS. Para obtener más información, consulte Supported Regions for mobile applications.

Requisitos previos

Debe tener un proyecto de Firebase y una aplicación de Android válida registrada en Firebase. Para obtener instrucciones, consulte Paso 1: crea un proyecto de Firebase y registra tu aplicación en la documentación de Firebase.

También debe tener credenciales válidas de Firebase Cloud Messaging (FCM), lo que incluye una clave de API de proyecto de FCM válida (clave de servidor). Para obtener más información, consulte Mensajería en la nube de Firebase en la documentación de Firebase.

Nota: Actualmente Amazon SNS no admite la API de FCM (v1). Para acceder a la clave del servidor, utilice la API de FCM (heredada).

Para recuperar la clave de API de su proyecto de FCM (clave de servidor)

1.    En la consola de Firebase, elija su proyecto.

2.    En el panel de navegación de la izquierda, seleccione el icono con forma de engranaje. A continuación, seleccione Configuración del proyecto.

3.    Elija la pestaña Cloud Messaging.

4.    En las credenciales del proyecto, busque la clave del servidor. Este token es la clave de API de su proyecto de FCM. Cópielo en el portapapeles.

Utilización de la consola de Amazon SNS para crear una aplicación de plataforma Android

1.    Abra la consola de Amazon SNS.

2.    En el panel de navegación, seleccione Móvil. Luego, elija Notificaciones push.

3.    En la página Notificaciones de inserción en móviles, junto a Aplicaciones de la plataforma, seleccione Crear una aplicación de la plataforma.

4.    En la página Crear una aplicación de la plataforma, en Detalles, haga lo siguiente:
En Nombre de la aplicación, introduzca el nombre de la aplicación.
En Plataforma de notificación de inserción, elija Firebase Cloud Messaging (FCM).
En Credenciales de Firebase Cloud Messaging, en Clave de API, introduzca la clave de API de su proyecto de FCM (clave del servidor).

5.    (Recomendación) Configure notificaciones de eventos y un registro del estado de entrega.

6.    Elija Crear una aplicación de la plataforma.

Ejecución del comando create-platform-application de la AWS CLI para crear una aplicación de plataforma Android

Nota: Si se muestran errores al ejecutar comandos de AWS CLI, compruebe si está utilizando la versión más reciente de AWS CLI.

1.    Copie y pegue lo siguiente en un editor de texto. Luego, guárdelo como un archivo JSON llamado FCMAPIKey.json:

Importante: Sustituya Your_FCM_API_Key por su clave de API de FCM (clave del servidor).

{
    "PlatformCredential": "Your_FCM_API_Key"
}

2.    Ejecute el comando create-platform-application de la AWS CLI:

Importante: Sustituya Your_Application_Name por el nombre de la aplicación. Asegúrese de ejecutar el comando en el mismo directorio del archivo FCMAPIKey.json.

aws sns create-platform-application --name Your_Application_Name --platform GCM --attributes file://FCMAPIKey.json

El nombre de recurso de Amazon (ARN) de la aplicación de plataforma aparece en el resultado del comando.

Ejemplo de resultado del comando create-platform-application

{
    "PlatformApplicationArn": "arn:aws:sns:us-east-1:XXXXXXXXXXXX:app/GCM/Your_Application_Name"
}

3.    (Recomendación) Configure notificaciones de eventos y un registro del estado de entrega.

Nota: Para enviar notificaciones push mediante la aplicación de plataforma Android, siga las instrucciones de Mobile push notifications.

Para obtener más información, consulte CreatePlatformApplication en la referencia de la API de Amazon SNS.

Información relacionada

¿Cómo creo una aplicación de plataforma APN para enviar notificaciones push en Amazon SNS mediante la AWS CLI?

Adding device tokens or registration IDs

Publishing to a mobile device

Publishing to a topic

Platform response codes