Come configurare notifiche e modelli di posta elettronica in Gestione API di AzureHow to configure notifications and email templates in Azure API Management

Gestione API consente di configurare notifiche per eventi specifici nonché di configurare modelli di posta elettronica da usare per comunicare con gli amministratori e gli sviluppatori di un'istanza di Gestione API.API Management provides the ability to configure notifications for specific events, and to configure the email templates that are used to communicate with the administrators and developers of an API Management instance. In questo argomento viene illustrato come configurare notifiche per gli eventi disponibili e viene offerta una panoramica sulla configurazione di modelli di posta elettronica usati per tali eventi.This topic shows how to configure notifications for the available events, and provides an overview of configuring the email templates used for these events.

Configurare le notifiche dell'editore Configure publisher notifications

Per configurare le notifiche, fare clic su Portale di pubblicazione nel portale di Azure per il servizio Gestione API.To configure notifications, click Publisher portal in the Azure Portal for your API Management service. Verrà visualizzato il portale di pubblicazione di Gestione API.This takes you to the API Management publisher portal.

Portale di pubblicazione

Nota

Se non è stata creata un'istanza del servizio Gestione API, vedere Creare un'istanza di Gestione API nell'esercitazione Introduzione a Gestione API di Azure.If you have not yet created an API Management service instance, see Create an API Management service instance in the Get started with Azure API Management tutorial.

Fare clic su Notifiche dal menu Gestione API a sinistra per visualizzare le notifiche disponibili.Click Notifications from the API Management menu on the left to view the available notifications.

Notifiche dell'editore

L'elenco di eventi seguente può essere configurato per le notifiche.The following list of events can be configured for notifications.

  • Richieste di sottoscrizione (che richiedono approvazione) - I destinatari e gli utenti di posta elettronica specificati riceveranno notifiche tramite posta elettronica sulle richieste di sottoscrizione per prodotti API che richiedono approvazione.Subscription requests (requiring approval) - The specified email recipients and users will receive email notifications about subscription requests for API products requiring approval.
  • Nuove sottoscrizioni - I destinatari e gli utenti di posta elettronica specificati riceveranno notifiche tramite posta elettronica sulle nuove sottoscrizioni a prodotti API.New subscriptions - The specified email recipients and users will receive email notifications about new API product subscriptions.
  • Richieste relative alla raccolta di applicazioni - I destinatari e gli utenti di posta elettronica specificati riceveranno notifiche tramite posta elettronica quando nuove applicazioni vengono inviate alla raccolta di applicazioni.Application gallery requests - The specified email recipients and users will receive email notifications when new applications are submitted to the application gallery.
  • BCC - I destinatari e gli utenti di posta elettronica specificati riceveranno copie per conoscenza nascosta di tutti i messaggi di posta elettronica inviati agli sviluppatori.BCC - The specified email recipients and users will receive email blind carbon copies of all emails sent to developers.
  • Nuovo problema o commento - I destinatari e gli utenti di posta elettronica specificati riceveranno notifiche tramite posta elettronica quando un nuovo problema o commento viene inviato al portale per sviluppatori.New issue or comment - The specified email recipients and users will receive email notifications when a new issue or comment is submitted on the developer portal.
  • Messaggio di chiusura account - I destinatari e gli utenti di posta elettronica specificati riceveranno notifiche tramite posta elettronica quando un account viene chiuso.Close account message - The specified email recipients and users will receive email notifications when an account is closed.
  • Raggiungimento limite quota sottoscrizione - I destinatari e gli utenti di posta elettronica specificati riceveranno notifiche tramite posta elettronica quando l'uso della sottoscrizione si avvicina al limite di quota di utilizzo.Approaching subscription quota limit - The following email recipients and users will receive email notifications when subscription usage gets close to usage quota.

Per ogni evento, è possibile specificare i destinatari di posta elettronica usando la casella di testo per l'indirizzo di posta elettronica oppure è possibile selezionare gli utenti da un elenco.For each event, you can specify email recipients using the email address text box or you can select users from a list.

Per specificare gli indirizzi di posta elettronica a cui inviare le notifiche, immettere tali indirizzi nella casella di testo relativa all'indirizzo di posta elettronica.To specify the email addresses to be notified, enter them in the email address text box. Se ci sono più indirizzi di posta elettronica, separarli usando delle virgole.If you have multiple email addresses, separate them using commas.

Destinatari delle notifiche

Per specificare gli utenti a cui inviare le notifiche, fare clic su Aggiungi destinatario, selezionare la casella di controllo corrispondente all'utente desiderato, quindi fare clic su OK.To specify the users to be notified, click add recipient, check the box beside the users to be notified, and click OK.

Nota

Solo gli amministratori vengono visualizzati nell'elenco.Only administrators are displayed in the list.

Dopo avere configurato i destinatari delle notifiche, fare clic su Salva per rendere effettivi i destinatari delle notifiche aggiornati.After configuring the notification recipients, click Save to apply the updated notification recipients.

Nota

Se si esce dalla scheda Notifiche dell'editore , il portale di pubblicazione visualizza un avviso in caso di modifiche non salvate.If you navigate away from the Publisher Notifications tab the publisher portal alerts you if there are unsaved changes.

Configurare modelli di posta elettronica Configure email templates

Gestione API fornisce modelli di posta elettronica per i messaggi che vengono inviati durante l'amministrazione e l'uso del servizio.API Management provides email templates for the email messages that are sent in the course of administering and using the service. Sono forniti i modelli di posta elettronica indicati di seguito.The following email templates are provided.

  • Invio alla raccolta di applicazioni approvatoApplication gallery submission approved
  • Lettera di commiato sviluppatoreDeveloper farewell letter
  • Notifica raggiungimento limite quota sviluppatoreDeveloper quota limit approaching notification
  • Invito utenteInvite user
  • Nuovo commento aggiunto a problemaNew comment added to an issue
  • Nuovo problema ricevutoNew issue received
  • Nuova sottoscrizione attivataNew subscription activated
  • Conferma rinnovo sottoscrizioneSubscription renewed confirmation
  • Richiesta sottoscrizione rifiutataSubscription request declines
  • Richiesta sottoscrizione ricevutaSubscription request received

Questi modelli possono essere modificati a piacimento.These templates can be modified as desired.

Per visualizzare e configurare i modelli di posta elettronica per la propria istanza di Gestione API, fare clic su Notifiche dal menu Gestione API a sinistra, quindi selezionare la scheda Modelli di posta elettronica.To view and configure the email templates for your API Management instance, click Notifications from the API Management menu on the left, and select the Email Templates tab.

Modelli di posta elettronica

Per visualizzare o modificare un modello specifico, selezionarlo dall'elenco a discesa Modelli .To view or modify a specific template, select it from the Templates drop-down list.

Elenco modelli di posta elettronica

Ogni modello di posta elettronica ha un oggetto in testo normale e una definizione di corpo in formato HTML.Each email template has a subject in plain text, and a body definition in HTML format. Ogni elemento può essere personalizzato a piacimento.Each item can be customized as desired.

Editor dei modelli di posta elettronica

L'elenco Parametri contiene un elenco di parametri che, quando inserito nell'oggetto o nel corpo, verrà sostituito dal valore designato quando viene inviato il messaggio di posta elettronica.The Parameters list contains a list of parameters, which when inserted into the subject or body, will be replaced the designated value when the email is sent. Per inserire un parametro, posizionare il cursore dove si vuole inserire il parametro, quindi fare clic sulla freccia a sinistra del nome del parametro.To insert a parameter, place the cursor where you wish the parameter to go, and click the arrow to the left of the parameter name.

Fare clic su Anteprima o Invia test per verificare l'aspetto del messaggio o per inviare un messaggio di prova.Click Preview or Send a test to see how the email will look or send a test email.

Nota

I parametri non vengono sostituiti con valori effettivi quando si visualizzano anteprime o si inviano messaggi di prova.The parameters are not replaced with actual values when previewing or sending a test.

Per salvare le modifiche al modello di posta elettronica, fare clic su Salva oppure, per annullare le modifiche, fare clic su Annulla.To save the changes to the email template, click Save, or to cancel the changes click Cancel.