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 articolo 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 article shows how to configure notifications for the available events, and provides an overview of configuring the email templates used for these events.

prerequisitiPrerequisites

Se non si dispone di un'istanza del servizio Gestione API, completare la guida introduttiva seguente: Creare un'istanza di Gestione API di Azure.If you do not have an API Management service instance, complete the following quickstart: Create an Azure API Management instance.

Configurare le notifiche Configure notifications

  1. Selezionare l'istanza del servizio Gestione API in esecuzione.Select your API MANAGEMENT instance.
  2. Fare clic su Notifiche per visualizzare le notifiche disponibili.Click Notifications 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.

  3. 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

  4. Fare clic su Aggiungi.Press Add.

Configurare i modelli di notifica Configure notification templates

Gestione API fornisce modelli di notifica per i messaggi di posta elettronica che vengono inviati durante l'amministrazione e l'uso del servizio.API Management provides notification 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 messaggio di posta elettronica per l'istanza di Gestione API, fare clic su Modelli di notifica.To view and configure the email templates for your API Management instance, click Notifications templates.

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.

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 apportate al modello di posta elettronica, fare clic su Salva oppure, per annullare le modifiche, fare clic su Ignora.To save the changes to the email template, click Save, or to cancel the changes click Discard.