Guida introduttiva: Gestire eventi di messaggistica avanzata

Servizi di comunicazione di Azure ora consente di inviare e ricevere messaggi WhatsApp usando Advanced Messaging SDK. Introduzione alla configurazione degli eventi di Griglia di eventi per la ricezione di report sullo stato di invio/ricezione di messaggi WhatsApp. Le procedure illustrate in questa guida di avvio rapido comportano l'addebito di qualche centesimo (USD) o meno nell'account Azure.

Prerequisiti

Informazioni sulla griglia di eventi

Griglia di eventi è un servizio di gestione degli eventi basato sul cloud. Questo articolo illustra come sottoscrivere gli eventi del servizio di comunicazione e attivare un evento per visualizzare il risultato. In genere, si inviano eventi a un endpoint che elabora i dati dell'evento e intraprende azioni. In questo articolo gli eventi vengono inviati a un'app Web che raccoglie e visualizza i messaggi.

Configurare il Visualizzatore Griglia di eventi

Il Visualizzatore Griglia di eventi è un sito di esempio che consente di visualizzare gli eventi in ingresso da Griglia di eventi.

  1. Passare a questo visualizzatore Griglia di eventi di Azure collegamento - Esempi di codice | Microsoft Learn. Distribuire l'esempio visualizzatore Griglia di eventi facendo clic su Distribuisci in Azure.

    Screenshot che mostra la pagina di esempio del Visualizzatore Griglia di eventi con l'opzione Distribuisci in Azure.

  2. Dopo aver fatto clic su Distribuisci in Azure, compilare i campi obbligatori. Poiché il nome del sito crea una voce DNS, deve essere univoco a livello globale. È consigliabile includere l'alias nel nome per questo passaggio. Anche se questa guida introduttiva non richiede alcuna configurazione speciale per questo passaggio, ecco i suggerimenti per compilare i dettagli della distribuzione:

  • Subscription- Selezionare la sottoscrizione che contiene la risorsa Servizi di comunicazione di Azure. Questa sottoscrizione specifica non è necessaria, ma semplifica la pulizia dopo aver completato l'avvio rapido.

  • Resource Group- Selezionare il gruppo di risorse che contiene la risorsa Servizi di comunicazione di Azure. Questo gruppo di risorse specifico non è obbligatorio, ma semplifica la pulizia dopo aver completato l'avvio rapido.

  • Region- Selezionare il gruppo di risorse che contiene la risorsa Servizi di comunicazione di Azure. Questa area specifica non è obbligatoria, ma è consigliata.

  • Site Name - Creare un nome univoco a livello globale. Questo nome di sito viene usato per creare un dominio per connettersi al Visualizzatore Griglia di eventi.

  • Hosting Plan Name - Creare qualsiasi nome per identificare il piano di hosting.

  • Sku - Lo SKU F1 può essere usato a scopo di sviluppo e test. Se si verificano errori di convalida durante la creazione del Visualizzatore Griglia di eventi che dicono che non è disponibile più capacità per il piano F1, provare a selezionare un'area diversa. Per altre informazioni sugli SKU, vedere prezzi servizio app

    Screenshot che mostra la distribuzione personalizzata dell'app Web Visualizzatore eventi e delle proprietà che è necessario fornire per la corretta distribuzione.

  1. Selezionare quindi Rivedi e crea.

  2. Al termine della distribuzione, selezionare la risorsa servizio app per aprirla.

    Screenshot che mostra l'app Web Visualizzatore eventi.

  3. Nella pagina di panoramica della risorsa selezionare il pulsante Copia accanto alla proprietà Dominio predefinito.

    Screenshot che mostra l'URL dell'app Web Visualizzatore eventi.

  4. L'URL del Visualizzatore Griglia di eventi è il nome del sito usato per creare la distribuzione con il percorso /api/update aggiunto. Ad esempio: "https://{{site-name}}.azurewebsites.net/api/updates". Sarà necessario nel passaggio successivo e durante la creazione dell'app demo.

Sottoscrivere eventi di messaggistica avanzata

  1. Aprire la risorsa servizi di comunicazione nella portale di Azure, passare all'opzione Eventi nel pannello sinistro e selezionare +Sottoscrizione eventi.

    Screenshot che mostra Servizi di comunicazione di Azure opzione sottoscrizione eventi e consente di sottoscrivere eventi di messaggistica avanzata.

  2. Immettere i dettagli per la nuova sottoscrizione di eventi.

    • nome della sottoscrizione.

    • Nome dell'argomento di sistema: immettere un nome univoco, a meno che questo nome non sia già precompilato con un argomento della sottoscrizione.

    • Tipi di evento: selezionare i due eventi di messaggistica avanzata dall'elenco.

      Screenshot che mostra le proprietà di creazione della sottoscrizione di eventi.

    • Facoltativo: selezionare l'evento AdvancedMessageAnalysisCompleted, attualmente in anteprima pubblica, per ricevere gli eventi di Analisi messaggi. Istruzioni su come abilitare l'analisi dei messaggi sono disponibili in Abilitare l'analisi dei messaggi con Azure OpenAI

      Importante

      Questa funzionalità di Servizi di comunicazione di Azure è attualmente in anteprima.

      Le anteprime di API e SDK vengono fornite senza un contratto di servizio. È consigliabile non usarle per carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o risultare limitate.

      Per altre informazioni, vedere le Condizioni per l'utilizzo supplementari delle anteprime di Microsoft Azure.

      Screenshot che mostra come creare le proprietà della sottoscrizione di eventi di Analisi messaggi.

    • Per tipo di endpoint selezionare "Webhook" e immettere l'URL per il Visualizzatore Griglia di eventi creato nel passaggio Setup Event Grid Viewer (Visualizzatore griglia di eventi di installazione) con il percorso /api/updates aggiunto. Ad esempio: https://{{site-name}}.azurewebsites.net/api/updates.

      Screenshot che mostra come aggiornare l'URL del webhook della sottoscrizione di eventi per ricevere gli eventi.

    • Seleziona Crea.

  3. Tornare all'opzione Eventi nel pannello sinistro della risorsa Servizi di comunicazione di Azure. Si noti la nuova sottoscrizione di eventi con eventi di messaggistica avanzata.

    Screenshot che mostra due eventi di messaggistica avanzata sottoscritti.

Pulire le risorse

Se si vuole pulire e rimuovere una sottoscrizione a Servizi di comunicazione, è possibile eliminare la risorsa o il gruppo di risorse. L'eliminazione del gruppo di risorse comporta anche l'eliminazione di tutte le altre risorse associate. Altre informazioni sulla pulizia delle risorse.

Passaggi successivi

Passare all'articolo successivo per imparare a usare Advanced Messaging SDK per la messaggistica WhatsApp.