This email was sent using the " + "\n Amazon Pinpoint API " + "\n using the AWS SDK for .NET" + "\n
" + "\n" + "\n"; // The character encoding the you want to use for the subject line and // message body of the email. string charset = "UTF-8"; var sendRequest = new SendMessagesRequest { ApplicationId = appId, MessageRequest = new MessageRequest { Addresses = new DictionaryThis email was sent with the Amazon Pinpoint API using the AWS SDK for JavaScript in Node.js.
`; // The character encoding the you want to use for the subject line and // message body of the email. var charset = "UTF-8"; // Specify that you're using a shared credentials file. var credentials = new AWS.SharedIniFileCredentials({ profile: "default" }); AWS.config.credentials = credentials; // Specify the region. AWS.config.update({ region: aws_region }); //Create a new Pinpoint object. var pinpoint = new AWS.Pinpoint(); // Specify the parameters to pass to the API. var params = { ApplicationId: appId, MessageRequest: { Addresses: { [toAddress]: { ChannelType: "EMAIL", }, }, MessageConfiguration: { EmailMessage: { FromAddress: senderAddress, SimpleEmail: { Subject: { Charset: charset, Data: subject, }, HtmlPart: { Charset: charset, Data: body_html, }, TextPart: { Charset: charset, Data: body_text, }, }, }, }, }, }; //Try to send the email. pinpoint.sendMessages(params, function (err, data) { // If something goes wrong, print an error message. if (err) { console.log(err.message); } else { console.log( "Email sent! Message ID: ", data["MessageResponse"]["Result"][toAddress]["MessageId"] ); } }); ``` ------ #### [ Python ] Utilizza questo esempio per l'invio di e-mail tramite l’[AWS SDK per Python (Boto3)](https://aws.amazon.com/sdk-for-python/). Questo esempio si basa sul presupposto che SDK per Python (Boto3) sia già stato installato e configurato. Per ulteriori informazioni, consulta [Quickstart](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) nella *documentazione di riferimento delle API SDK AWS per Python (Boto3)*. ``` import logging import boto3 from botocore.exceptions import ClientError logger = logging.getLogger(__name__) def send_email_message( pinpoint_client, app_id, sender, to_addresses, char_set, subject, html_message, text_message, ): """ Sends an email message with HTML and plain text versions. :param pinpoint_client: A Boto3 Pinpoint client. :param app_id: The Amazon Pinpoint project ID to use when you send this message. :param sender: The "From" address. This address must be verified in Amazon Pinpoint in the AWS Region you're using to send email. :param to_addresses: The addresses on the "To" line. If your Amazon Pinpoint account is in the sandbox, these addresses must be verified. :param char_set: The character encoding to use for the subject line and message body of the email. :param subject: The subject line of the email. :param html_message: The body of the email for recipients whose email clients can display HTML content. :param text_message: The body of the email for recipients whose email clients don't support HTML content. :return: A dict of to_addresses and their message IDs. """ try: response = pinpoint_client.send_messages( ApplicationId=app_id, MessageRequest={ "Addresses": { to_address: {"ChannelType": "EMAIL"} for to_address in to_addresses }, "MessageConfiguration": { "EmailMessage": { "FromAddress": sender, "SimpleEmail": { "Subject": {"Charset": char_set, "Data": subject}, "HtmlPart": {"Charset": char_set, "Data": html_message}, "TextPart": {"Charset": char_set, "Data": text_message}, }, } }, }, ) except ClientError: logger.exception("Couldn't send email.") raise else: return { to_address: message["MessageId"] for to_address, message in response["MessageResponse"]["Result"].items() } def main(): app_id = "ce796be37f32f178af652b26eexample" sender = "sender@example.com" to_address = "recipient@example.com" char_set = "UTF-8" subject = "Amazon Pinpoint Test (SDK for Python (Boto3))" text_message = """Amazon Pinpoint Test (SDK for Python) ------------------------------------- This email was sent with Amazon Pinpoint using the AWS SDK for Python (Boto3). For more information, see https://aws.amazon.com/sdk-for-python/ """ html_message = """This email was sent with Amazon Pinpoint using the AWS SDK for Python (Boto3).
""" print("Sending email.") message_ids = send_email_message( boto3.client("pinpoint"), app_id, sender, [to_address], char_set, subject, html_message, text_message, ) print(f"Message sent! Message IDs: {message_ids}") if __name__ == "__main__": main() ``` È inoltre possibile utilizzare modelli di messaggi per inviare messaggi e-mail, come illustrato nell'esempio seguente: ``` import logging import boto3 from botocore.exceptions import ClientError logger = logging.getLogger(__name__) def send_templated_email_message( pinpoint_client, project_id, sender, to_addresses, template_name, template_version ): """ Sends an email message with HTML and plain text versions. :param pinpoint_client: A Boto3 Pinpoint client. :param project_id: The Amazon Pinpoint project ID to use when you send this message. :param sender: The "From" address. This address must be verified in Amazon Pinpoint in the AWS Region you're using to send email. :param to_addresses: The addresses on the "To" line. If your Amazon Pinpoint account is in the sandbox, these addresses must be verified. :param template_name: The name of the email template to use when sending the message. :param template_version: The version number of the message template. :return: A dict of to_addresses and their message IDs. """ try: response = pinpoint_client.send_messages( ApplicationId=project_id, MessageRequest={ "Addresses": { to_address: {"ChannelType": "EMAIL"} for to_address in to_addresses }, "MessageConfiguration": {"EmailMessage": {"FromAddress": sender}}, "TemplateConfiguration": { "EmailTemplate": { "Name": template_name, "Version": template_version, } }, }, ) except ClientError: logger.exception("Couldn't send email.") raise else: return { to_address: message["MessageId"] for to_address, message in response["MessageResponse"]["Result"].items() } def main(): project_id = "296b04b342374fceb661bf494example" sender = "sender@example.com" to_addresses = ["recipient@example.com"] template_name = "My_Email_Template" template_version = "1" print("Sending email.") message_ids = send_templated_email_message( boto3.client("pinpoint"), project_id, sender, to_addresses, template_name, template_version, ) print(f"Message sent! Message IDs: {message_ids}") if __name__ == "__main__": main() ``` Questi esempi presuppongono che tu stia utilizzando un file di credenziali condivise per specificare la chiave di accesso e la chiave di accesso segreta per un utente esistente. Per informazioni dettagliate, consulta [Credentials](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html) nella *documentazione di riferimento delle API AWS SDK per Python (Boto3)*. ------ # Aggiungi intestazioni di annullamento dell'iscrizione alle e-mail utilizzando Amazon Pinpoint **Nota** Prima di poter utilizzare le intestazioni delle e-mail, è necessario impostare un ruolo di invio dell'orchestrazione delle e-mail se si inviano e-mail da una campagna o da un percorso. Per l'invio diretto di e-mail, devi disporre delle autorizzazioni per e. `ses:SendEmail` `ses:SendRawEmail` Per ulteriori informazioni, consulta [Creazione di un ruolo di invio per l'orchestrazione delle e-mail nella Guida](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-orchestration-sending-role.html) per l'utente di [Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/userguide/). L'inclusione di un link di annullamento dell'iscrizione nell'e-mail rappresenta una best practice e in alcuni paesi è un requisito legale. Per aggiungere un link di annullamento dell'iscrizione con un clic, aggiungi le seguenti intestazioni: 1. Imposta il **nome** dell'intestazione `List-Unsubscribe` e imposta il **valore** sul link di annullamento dell'iscrizione. Il link deve supportare le richieste HTTP POST per elaborare la richiesta di annullamento dell’iscrizione del destinatario. 1. **Imposta il **nome** dell'intestazione su `List-Unsubscribe-Post` e imposta Value su.** `List-Unsubscribe=One-Click` Puoi aggiungere fino a 15 intestazioni a un messaggio di posta elettronica. Per un elenco delle intestazioni supportate, consulta i [campi di intestazione di Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/header-fields.html) nella [Amazon Simple Email Service Developer Guide](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/). L'esempio seguente mostra come inviare un messaggio e-mail con intestazioni di annullamento dell'iscrizione utilizzando il. AWS Command Line Interface[Per ulteriori informazioni sulla configurazione di AWS CLI, vedere [Configure the AWS CLI nella Guida per l'](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)utente.AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/) Nel comando seguente, effettuate le seguenti operazioni: + Sostituisci *AppId* con l'ID dell'applicazione. + Sostituisci *richard\$1roe@example.com* con l'indirizzo e-mail del destinatario. + *https://example.com/unsub*Sostituiscilo con il tuo link di annullamento dell'iscrizione. + *example123456*Sostituiscilo con un identificativo univoco per il destinatario. ``` aws pinpoint send-messages --application-id AppId --message-request '{ "Addresses": { "richard_roe@example.com": { "ChannelType": "EMAIL" } }, "MessageConfiguration": { "EmailMessage": { "Substitutions": { "url": [ "https://example.com/unsub" ], "id1": [ "/example123456" ] }, "SimpleEmail": { "TextPart": { "Data": "Sample email message with an subscribe header", "Charset": "UTF-8" }, "Subject": { "Data": "Hello", "Charset": "UTF-8" }, "Headers": [ { "Name": "List-Unsubscribe", "Value": "{{url}}{{id1}}" }, { "Name": "List-Unsubscribe-Post", "Value": "List-Unsubscribe=One-Click" } ] } } } }' ``` # Inviare messaggi SMS transazionali utilizzando Amazon Pinpoint Puoi utilizzare l'API Amazon Pinpoint per inviare messaggi SMS (messaggi di testo) a numeri di telefono o endpoint specifici. IDs Questa sezione contiene esempi di codice completi che puoi utilizzare per inviare messaggi SMS tramite l'API Amazon Pinpoint utilizzando un AWS SDK. Il tuo account deve essere in produzione e disporre di un'identità di origine attiva in grado di inviare messaggi SMS. [Per altri esempi di codice su endpoint, segmenti e canali, consulta Esempi di codice.](https://docs.aws.amazon.com/pinpoint/latest/developerguide/service_code_examples.html) ------ #### [ C\$1 ] Utilizza questo esempio per inviare un messaggio SMS tramite l'[AWS SDK per .NET](https://aws.amazon.com/sdk-for-net/). Questo esempio si basa sul presupposto che l' SDK per .NET sia già stato installato e configurato. Per ulteriori informazioni, consulta l'argomento relativo alle [nozioni di base](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config.html) nella *Guida per gli sviluppatori di AWS SDK per .NET *. Questo esempio presuppone che tu stia utilizzando un file di credenziali condivise per specificare la chiave di accesso e la chiave di accesso segreta per un utente IAM esistente. Per ulteriori informazioni, consulta l'argomento relativo alla [configurazione delle credenziali AWS](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/creds-idc.html) nella *Guida per gli sviluppatori di AWS SDK per .NET *. ``` using Amazon; using Amazon.Pinpoint; using Amazon.Pinpoint.Model; using Microsoft.Extensions.Configuration; namespace SendSmsMessage; public class SendSmsMessageMainClass { public static async Task Main(string[] args) { var configuration = new ConfigurationBuilder() .SetBasePath(Directory.GetCurrentDirectory()) .AddJsonFile("settings.json") // Load test settings from .json file. .AddJsonFile("settings.local.json", true) // Optionally load local settings. .Build(); // The AWS Region that you want to use to send the message. For a list of // AWS Regions where the Amazon Pinpoint API is available, see // https://docs.aws.amazon.com/pinpoint/latest/apireference/ string region = "us-east-1"; // The phone number or short code to send the message from. The phone number // or short code that you specify has to be associated with your Amazon Pinpoint // account. For best results, specify long codes in E.164 format. string originationNumber = configuration["OriginationNumber"]!; // The recipient's phone number. For best results, you should specify the // phone number in E.164 format. string destinationNumber = configuration["DestinationNumber"]!; // The Pinpoint project/ application ID to use when you send this message. // Make sure that the SMS channel is enabled for the project or application // that you choose. string appId = configuration["AppId"]!; // The type of SMS message that you want to send. If you plan to send // time-sensitive content, specify TRANSACTIONAL. If you plan to send // marketing-related content, specify PROMOTIONAL. MessageType messageType = MessageType.TRANSACTIONAL; // The registered keyword associated with the originating short code. string? registeredKeyword = configuration["RegisteredKeyword"]; // The sender ID to use when sending the message. Support for sender ID // varies by country or region. For more information, see // https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-countries.html string? senderId = configuration["SenderId"]; try { var response = await SendSmsMessage(region, appId, destinationNumber, originationNumber, registeredKeyword, senderId, messageType); Console.WriteLine($"Message sent to {response.MessageResponse.Result.Count} recipient(s)."); foreach (var messageResultValue in response.MessageResponse.Result.Select(r => r.Value)) { Console.WriteLine($"{messageResultValue.MessageId} Status: {messageResultValue.DeliveryStatus}"); } } catch (Exception ex) { Console.WriteLine("The message wasn't sent. Error message: " + ex.Message); } } public static async Task* For more information, see the following documentation topic: *
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class SendVoiceMessage {
// The Amazon Polly voice that you want to use to send the message. For a list
// of voices, see https://docs.aws.amazon.com/polly/latest/dg/voicelist.html
static final String voiceName = "Matthew";
// The language to use when sending the message. For a list of supported
// languages, see
// https://docs.aws.amazon.com/polly/latest/dg/SupportedLanguage.html
static final String languageCode = "en-US";
// The content of the message. This example uses SSML to customize and control
// certain aspects of the message, such as by adding pauses and changing
// phonation. The message can't contain any line breaks.
static final String ssmlMessage = "