Publicación en un teléfono móvil

Puede utilizar Amazon SNS para enviar mensajes SMS de forma directa a un teléfono móvil sin suscribir el número de teléfono a un tema de Amazon SNS.

nota

Suscribir números de teléfono a un tema es útil si quiere enviar un mensaje a varios números de teléfono a la vez. Para obtener instrucciones sobre cómo publicar un mensaje SMS en un tema, consulte Publicación de un tema.

Cuando se envía un mensaje, se puede controlar si el mensaje se optimiza en función del costo o de la fiabilidad de la entrega. También puede especificar un ID de remitente o número de origen. Si envía el mensaje mediante programación mediante la API de Amazon SNS o AWS los SDK, puede especificar un precio máximo para la entrega del mensaje.

Cada mensaje SMS puede contener hasta 140 bytes y la cuota de caracteres depende del esquema de codificación. Por ejemplo, un mensaje SMS puede contener:

• 160 caracteres GSM

• 140 caracteres ASCII

• 70 caracteres UCS-2

Si publica un mensaje que exceda la cuota de tamaño, Amazon SNS lo envía como varios mensajes, cada uno de los cuales respetará la cuota. Los mensajes no se dividen en mitad de una palabra, sino en el espacio entre palabras. La cuota de tamaño total de una acción de publicación SMS es 1600 bytes.

Al enviar un mensaje SMS, especifique el número de teléfono mediante el formato E.164, una estructura de numeración de teléfono estándar utilizada para las telecomunicaciones internacionales. Los números de teléfono que siguen este formato pueden tener un máximo de 15 dígitos junto con el prefijo de un signo más (+) y el código del país. Por ejemplo, un número de teléfono de los EE. UU. en formato E.164 se muestra como +1XXX5550100.

Envío de un mensaje (consola)

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

2. En el menú de la consola, elija una región que admita la mensajería SMS de AWS.

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

4. En la página Mensajería de texto móvil (SMS), elija Publicar mensaje de texto.

5. En la página Publicar mensaje SMS, para el tipo de mensaje., elija una de las siguientes opciones:

   • Promotional: mensajes que no son de importancia, como mensajes de marketing.

   • Transactional: mensajes de importancia que admiten transacciones del cliente, como claves de acceso de un solo uso para la autenticación multifactor.

   nota

   Esta opción de nivel de mensaje anula el tipo de mensaje predeterminado de nivel de cuenta. Puede establecer un tipo de mensaje predeterminado a nivel de cuenta desde la sección Preferencias de mensajes de texto de la página Mensajería de texto móvil (SMS).

   Para obtener información sobre los mensajes promocionales y transaccionales, consulte Precios de SMS en todo el mundo.

6. En Número de teléfono de destino, ingrese el número de teléfono al que desea enviar el mensaje.

7. En Mensaje, ingrese el mensaje que va a enviar.

8. (Opcional) En Identidades de origen, especifique cómo identificarse ante sus destinatarios:

   • Para especificar un ID de remitente, ingrese un ID personalizado que contenga 3 a 11 caracteres alfanuméricos, incluida al menos una letra y sin espacios. El ID de remitente se muestra como el remitente del mensaje en el dispositivo receptor. Por ejemplo, puede utilizar la marca de su negocio para facilitar el reconocimiento del origen del mensaje.

     La compatibilidad con los ID de remitente varía según el país o la región. Por ejemplo, los mensajes que se entregan a números de teléfono de los EE. UU. no mostrarán el ID de remitente. En el caso de los países y regiones que admiten el ID de remitente, consulte Regiones y países admitidos.

     Si no especifica un ID de remitente, se mostrará una de las siguientes características como identidad de origen:

     • En los países que admiten códigos largos, se muestra el código largo.

     • En los países en los que solo se admiten los ID de remitente, aparece AVISO.

     Este ID de remitente de nivel de mensaje anula el ID de remitente predeterminado, que se establece en la página Text messaging preferences (Preferencias de la mensajería de texto).

   • Para especificar un número de origen, ingrese una cadena de 5 a 14 números que se mostrará como número de teléfono del remitente en el dispositivo del receptor. Esta cadena debe coincidir con un número de origen que esté configurado en su Cuenta de AWS para el país de destino. El número de origen puede ser un número de 10 DLC, un número gratuito, un código largo o un código corto. person-to-person Para obtener más información, consulte Identidades de origen de los mensajes SMS.

     Si no especifica un número de origen, Amazon SNS seleccionará un número de origen para usarlo en el mensaje de texto SMS, en función de su configuración. Cuenta de AWS

9. Si envía mensajes SMS a destinatarios en India, expanda Atributos específicos del país y especifique los atributos siguientes:

   • ID de la identidad: ID entidad o ID de entidad principal (PE) para enviar mensajes SMS a destinatarios en la India. Este ID es una cadena única de 1 a 50 caracteres que la Autoridad Reguladora de las Telecomunicaciones de la India (TRAI) proporciona para identificar la entidad que ha registrado en la TRAI.

   • ID de plantilla: ID de plantilla para enviar mensajes SMS a destinatarios en la India. Este ID es una cadena única de 1 a 50 caracteres que proporciona la TRAI para identificar la plantilla que registró en la TRAI. El ID de plantilla debe estar asociado al ID de remitente que especificó para el mensaje.

   Para obtener más información sobre cómo enviar mensajes SMS a destinatarios en la India, consulte Requisitos de registro del identificador de remitente para la India.

10. Elija Publish message (Publicar mensaje).

sugerencia

Para enviar mensajes SMS desde un número de origen, también puede elegir números de origen en el panel de navegación de la consola de Amazon SNS. Elija un número de origen que incluya SMS en la columna Capacidades y, a continuación, elija Publicar mensajes de texto.

Envío de un mensaje (SDK)AWS

Para enviar un mensaje SMS mediante uno de los AWS SDK, utilice la operación de API de ese SDK que corresponda a la Publish solicitud de la API de Amazon SNS. Con esta solicitud, puede enviar un mensaje SMS directamente a un número de teléfono. También puede utilizar el parámetro MessageAttributes para establecer valores para los siguientes nombres de atributo:

AWS.SNS.SMS.SenderID

Un ID personalizado que contiene entre 3 y 11 caracteres alfanuméricos o guiones (-), entre ellos al menos una letra, y ningún espacio. El ID de remitente aparece como el remitente del mensaje en el dispositivo receptor. Por ejemplo, puede utilizar la marca de su negocio para facilitar el reconocimiento del origen del mensaje.

La compatibilidad con los ID de remitente varía según el país o la región. Por ejemplo, los mensajes que se entregan a números de teléfono de los EE. UU. no muestra el ID de remitente. Para obtener una lista de los países y regiones que admiten el ID de remitente, consulte Regiones y países admitidos.

Si no especifica un ID de remitente, aparece un código largo como ID de remitente en los países o regiones admitidos. Para los países o regiones que requieren un ID de remitente alfabético, aparece AVISO como ID de remitente.

Este atributo de nivel de mensaje anula el atributo de nivel de cuenta DefaultSenderID, que se puede establecer mediante la solicitud SetSMSAttributes.

AWS.MM.SMS.OriginationNumber

Una cadena personalizada de 5 a 14 números, que puede incluir un signo más inicial opcional (+). Esta cadena de números aparece como el número de teléfono del remitente en el dispositivo receptor. La cadena debe coincidir con un número de origen que esté configurado en su AWS cuenta para el país de destino. El número de origen puede ser un número de 10 DLC, un número gratuito, un código largo person-to-person (P2P) o un código corto. Para obtener más información, consulte Números de origen.

Si no especificas un número de origen, Amazon SNS elegirá un número de origen en AWS función de la configuración de tu cuenta.

AWS.SNS.SMS.MaxPrice

El precio máximo en USD que estás dispuesto a gastar para enviar el mensaje SMS. Si Amazon SNS determina que el envío del mensaje supondría un costo superior a su precio máximo, no lo envía.

Este atributo no tiene efecto si los costes de los month-to-date SMS ya han superado la cuota establecida para el atributo. MonthlySpendLimit Puede establecer el atributo MonthlySpendLimit con la solicitud SetSMSAttributes.

Si envía el mensaje a un tema de Amazon SNS, el precio máximo se aplica a cada entrega de mensaje a cada número de teléfono que esté suscrito al tema.

AWS.SNS.SMS.SMSType

El tipo de mensaje que envía:

• Promotional (predeterminado): mensajes que no son de importancia, como mensajes de marketing.

• Transactional: mensajes de importancia que admiten transacciones del cliente, como claves de acceso de un solo uso para la autenticación multifactor.

Este atributo de nivel de mensaje anula el atributo de nivel de cuenta DefaultSMSType, que se puede establecer mediante la solicitud SetSMSAttributes.

AWS.MM.SMS.EntityId

Este atributo solo es necesario para enviar mensajes SMS a destinatarios en la India.

Se trata del ID entidad o ID de entidad principal (PE) para enviar mensajes SMS a destinatarios en la India. Este ID es una cadena única de 1 a 50 caracteres que la Autoridad Reguladora de las Telecomunicaciones de la India (TRAI) proporciona para identificar la entidad que ha registrado en la TRAI.

AWS.MM.SMS.TemplateId

Este atributo solo es necesario para enviar mensajes SMS a destinatarios en la India.

Se trata de la plantilla para enviar mensajes SMS a destinatarios en la India. Este ID es una cadena única de 1 a 50 caracteres que proporciona la TRAI para identificar la plantilla que registró en la TRAI. El ID de plantilla debe estar asociado al ID de remitente que especificó para el mensaje.

Envío de un mensaje

En los siguientes ejemplos de código, se muestra cómo publicar mensajes SMS mediante Amazon SNS.

.NET

AWS SDK for .NET

nota

Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS.

namespace SNSMessageExample
{
    using System;
    using System.Threading.Tasks;
    using Amazon;
    using Amazon.SimpleNotificationService;
    using Amazon.SimpleNotificationService.Model;

    public class SNSMessage
    {
        private AmazonSimpleNotificationServiceClient snsClient;

        /// <summary>
        /// Initializes a new instance of the <see cref="SNSMessage"/> class.
        /// Constructs a new SNSMessage object initializing the Amazon Simple
        /// Notification Service (Amazon SNS) client using the supplied
        /// Region endpoint.
        /// </summary>
        /// <param name="regionEndpoint">The Amazon Region endpoint to use in
        /// sending test messages with this object.</param>
        public SNSMessage(RegionEndpoint regionEndpoint)
        {
            snsClient = new AmazonSimpleNotificationServiceClient(regionEndpoint);
        }

        /// <summary>
        /// Sends the SMS message passed in the text parameter to the phone number
        /// in phoneNum.
        /// </summary>
        /// <param name="phoneNum">The ten-digit phone number to which the text
        /// message will be sent.</param>
        /// <param name="text">The text of the message to send.</param>
        /// <returns>Async task.</returns>
        public async Task SendTextMessageAsync(string phoneNum, string text)
        {
            if (string.IsNullOrEmpty(phoneNum) || string.IsNullOrEmpty(text))
            {
                return;
            }

            // Now actually send the message.
            var request = new PublishRequest
            {
                Message = text,
                PhoneNumber = phoneNum,
            };

            try
            {
                var response = await snsClient.PublishAsync(request);
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Error sending message: {ex}");
            }
        }
    }
}

• Para obtener información sobre la API, consulte Publicar en la Referencia de la API de AWS SDK for .NET .

C++

SDK para C++

nota

Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS.

/**
 * Publish SMS: use Amazon Simple Notification Service (Amazon SNS) to send an SMS text message to a phone number.
 * Note: This requires additional AWS configuration prior to running example. 
 * 
 *  NOTE: When you start using Amazon SNS to send SMS messages, your AWS account is in the SMS sandbox and you can only
 *  use verified destination phone numbers. See https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html.
 *  NOTE: If destination is in the US, you also have an additional restriction that you have use a dedicated
 *  origination ID (phone number). You can request an origination number using Amazon Pinpoint for a fee.
 *  See https://aws.amazon.com/blogs/compute/provisioning-and-using-10dlc-origination-numbers-with-amazon-sns/ 
 *  for more information. 
 * 
 *  <phone_number_value> input parameter uses E.164 format. 
 *  For example, in United States, this input value should be of the form: [phone]
 */

//! Send an SMS text message to a phone number.
/*!
  \param message: The message to publish.
  \param phoneNumber: The phone number of the recipient in E.164 format.
  \param clientConfiguration: AWS client configuration.
  \return bool: Function succeeded.
 */
bool AwsDoc::SNS::publishSms(const Aws::String &message,
                             const Aws::String &phoneNumber,
                             const Aws::Client::ClientConfiguration &clientConfiguration) {
    Aws::SNS::SNSClient snsClient(clientConfiguration);

    Aws::SNS::Model::PublishRequest request;
    request.SetMessage(message);
    request.SetPhoneNumber(phoneNumber);

    const Aws::SNS::Model::PublishOutcome outcome = snsClient.Publish(request);

    if (outcome.IsSuccess()) {
        std::cout << "Message published successfully with message id, '"
                  << outcome.GetResult().GetMessageId() << "'."
                  << std::endl;
    }
    else {
        std::cerr << "Error while publishing message "
                  << outcome.GetError().GetMessage()
                  << std::endl;
    }

    return outcome.IsSuccess();
}

• Para obtener información sobre la API, consulte Publicar en la Referencia de la API de AWS SDK for C++ .

Java

SDK para Java 2.x

nota

Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS.

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.PublishRequest;
import software.amazon.awssdk.services.sns.model.PublishResponse;
import software.amazon.awssdk.services.sns.model.SnsException;

/**
 * Before running this Java V2 code example, set up your development
 * environment, including your credentials.
 *
 * For more information, see the following documentation topic:
 *
 * https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
 */
public class PublishTextSMS {
    public static void main(String[] args) {
        final String usage = """

                Usage:    <message> <phoneNumber>

                Where:
                   message - The message text to send.
                   phoneNumber - The mobile phone number to which a message is sent (for example, +1XXX5550100).\s
                """;

        if (args.length != 2) {
            System.out.println(usage);
            System.exit(1);
        }

        String message = args[0];
        String phoneNumber = args[1];
        SnsClient snsClient = SnsClient.builder()
                .region(Region.US_EAST_1)
                .build();
        pubTextSMS(snsClient, message, phoneNumber);
        snsClient.close();
    }

    public static void pubTextSMS(SnsClient snsClient, String message, String phoneNumber) {
        try {
            PublishRequest request = PublishRequest.builder()
                    .message(message)
                    .phoneNumber(phoneNumber)
                    .build();

            PublishResponse result = snsClient.publish(request);
            System.out
                    .println(result.messageId() + " Message sent. Status was " + result.sdkHttpResponse().statusCode());

        } catch (SnsException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
    }
}

• Para obtener información sobre la API, consulte Publicar en la Referencia de la API de AWS SDK for Java 2.x .

Kotlin

SDK para Kotlin

nota

Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS.

suspend fun pubTextSMS(messageVal: String?, phoneNumberVal: String?) {

    val request = PublishRequest {
        message = messageVal
        phoneNumber = phoneNumberVal
    }

    SnsClient { region = "us-east-1" }.use { snsClient ->
        val result = snsClient.publish(request)
        println("${result.messageId} message sent.")
    }
}

• Para obtener información sobre la API, consulte Publish en la Referencia de la API de AWS SDK para Kotlin.

PHP

SDK para PHP

nota

Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS.

require 'vendor/autoload.php';

use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;


/**
 * Sends a text message (SMS message) directly to a phone number using Amazon SNS.
 *
 * This code expects that you have AWS credentials set up per:
 * https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials.html
 */

$SnSclient = new SnsClient([
    'profile' => 'default',
    'region' => 'us-east-1',
    'version' => '2010-03-31'
]);

$message = 'This message is sent from a Amazon SNS code sample.';
$phone = '+1XXX5550100';

try {
    $result = $SnSclient->publish([
        'Message' => $message,
        'PhoneNumber' => $phone,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    error_log($e->getMessage());
}

• Para obtener información, consulte la Guía para desarrolladores de AWS SDK for PHP.

• Para obtener información sobre la API, consulte Publicar en la Referencia de la API de AWS SDK for PHP .

Python

SDK para Python (Boto3)

nota

Hay más información GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS.

class SnsWrapper:
    """Encapsulates Amazon SNS topic and subscription functions."""

    def __init__(self, sns_resource):
        """
        :param sns_resource: A Boto3 Amazon SNS resource.
        """
        self.sns_resource = sns_resource


    def publish_text_message(self, phone_number, message):
        """
        Publishes a text message directly to a phone number without need for a
        subscription.

        :param phone_number: The phone number that receives the message. This must be
                             in E.164 format. For example, a United States phone
                             number might be [phone].
        :param message: The message to send.
        :return: The ID of the message.
        """
        try:
            response = self.sns_resource.meta.client.publish(
                PhoneNumber=phone_number, Message=message
            )
            message_id = response["MessageId"]
            logger.info("Published message to %s.", phone_number)
        except ClientError:
            logger.exception("Couldn't publish message to %s.", phone_number)
            raise
        else:
            return message_id

• Para obtener información sobre la API, consulte Publicar en la Referencia de la API de AWS SDK para Python (Boto3).