Guida introduttiva: Gestire gli eventi del report sms e recapito

  • Articolo

Introduzione all'uso dei Servizi di comunicazione di Azure con Griglia di eventi di Azure per gestire gli eventi SMS dei servizi di comunicazione. Dopo aver effettuato la sottoscrizione a eventi SMS, ad esempio messaggi in ingresso e report di recapito, è possibile generare e ricevere questi eventi. Le procedure illustrate in questa guida di avvio rapido comportano l'addebito di qualche centesimo (USD) o meno nell'account Azure.

Importante

Le funzionalità SMS e PSTN dipendono dal numero di telefono usato e dal paese/area geografica in cui si opera come determinato dall'indirizzo di fatturazione di Azure. Per altre informazioni, vedere la documentazione sull'idoneità della sottoscrizione .

Prerequisiti

Informazioni su Griglia di eventi

Griglia di eventi è un servizio di eventi basato sul cloud. In questo articolo si apprenderà 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 l'ambiente

Per configurare l'ambiente che verrà usato per generare e ricevere eventi, seguire questa procedura nelle sezioni seguenti.

Registrare un provider di risorse di Griglia di eventi

Se Griglia di eventi non è stata usata in precedenza nella sottoscrizione di Azure, potrebbe essere necessario registrare il provider di risorse di Griglia di eventi. Per registrare il provider, seguire questa procedura:

  1. Accedere al portale di Azure.
  2. Nel menu a sinistra selezionare Sottoscrizioni.
  3. Selezionare la sottoscrizione usata per Griglia di eventi.
  4. Nel menu sinistro, in Impostazioni, scegliere Provider di risorse.
  5. Cercare Microsoft.EventGrid.
  6. Se il provider di risorse non è registrato, selezionare Registra.

La registrazione può richiedere qualche secondo. Selezionare Aggiorna per aggiornare lo stato. Quando Registrato viene visualizzato in Stato, si è pronti per continuare.

Distribuire il visualizzatore griglia di eventi

Per questa guida introduttiva si userà un visualizzatore Griglia di eventi per visualizzare gli eventi quasi in tempo reale. Il visualizzatore fornisce all'utente l'esperienza di un feed in tempo reale. Inoltre, il payload di ogni evento deve essere disponibile per l'ispezione.

Per configurare il visualizzatore, seguire la procedura descritta in Griglia di eventi di Azure Viewer.

Sottoscrivere eventi SMS tramite web hook

È possibile sottoscrivere eventi specifici per fornire a Griglia di eventi informazioni sulla posizione in cui inviare gli eventi da tenere traccia.

  1. Nel portale passare alla risorsa servizi di comunicazione creata.

  2. All'interno della risorsa Servizi di comunicazione, nel menu a sinistra della pagina Servizi di comunicazione selezionare Eventi.

  3. Selezionare Aggiungi sottoscrizione di eventi.

    Screenshot che mostra la pagina Eventi di una risorsa Servizi di comunicazione di Azure. Viene visualizzato il pulsante Sottoscrizione eventi.

  4. Nella pagina Crea sottoscrizione di eventi immettere un nome per la sottoscrizione di eventi.

  5. In Tipi di eventi selezionare gli eventi a cui si vuole effettuare la sottoscrizione. Per SMS, è possibile scegliere SMS Received e SMS Delivery Report Received.

  6. Se viene chiesto di specificare un valore per Nome dell'argomento del sistema, è possibile fornire una stringa univoca. Questo campo non ha effetto sull'esperienza utente e viene usato solo a scopi di telemetria interna.

    Screenshot che mostra la finestra di dialogo Crea sottoscrizione di eventi. In Tipi di evento vengono selezionati SMS Received (Sms Received) e SMS Delivery Report Received (Report di recapito SMS ricevuti).

  7. Per Tipo di endpoint selezionare Web Hook.

    Screenshot che mostra un dettaglio della finestra di dialogo Crea sottoscrizione di eventi. Nell'elenco Tipo di endpoint è selezionato Web Hook.

  8. Per Endpointselezionare Selezionare un endpoint e quindi immettere l'URL dell'app Web.

    In questo caso, si userà l'URL del visualizzatore Griglia di eventi configurato in precedenza nella guida introduttiva. L'URL dell'esempio ha questo formato: https://{{site-name}}.azurewebsites.net/api/updates

  9. Selezionare Confermare la selezione.

    Screenshot che mostra la finestra di dialogo Seleziona web hook. La casella Endpoint sottoscrittore contiene un U R L e un pulsante Conferma selezione è visibile.

Visualizzare gli eventi SMS

Per generare e ricevere eventi SMS, seguire questa procedura nelle sezioni seguenti.

Attivare eventi SMS

Per visualizzare i trigger di eventi, è necessario generare alcuni eventi.

  • Gli eventi SMS Received vengono generati quando il numero di telefono dei Servizi di comunicazione riceve un SMS. Per attivare un evento, inviare un messaggio dal telefono al numero di telefono collegato alla risorsa di Servizi di comunicazione.
  • SMS Delivery Report Received gli eventi vengono generati quando si invia un SMS a un utente usando un numero di telefono di Servizi di comunicazione. Per attivare un evento, è necessario attivare l'opzione Delivery Reportdell'SMS inviato. Provare a inviare un messaggio al telefono con Delivery Report attivato. Il completamento di queste operazioni comporta l'addebito di alcuni centesimi (EUR) sull'account Azure.

Vedere l'elenco completo degli eventi supportati da Servizi di comunicazione.

Ricevere eventi SMS

Dopo aver generato un evento, si noterà che SMS Received gli eventi e SMS Delivery Report Received vengono inviati all'endpoint. Questi eventi vengono visualizzati nel visualizzatore griglia di eventi configurato all'inizio di questa guida introduttiva. Selezionare l'icona a forma di occhio accanto all'evento per visualizzare l'intero payload. Gli eventi dovrebbero essere simili ai dati seguenti:

Screenshot del visualizzatore Griglia di eventi di Azure che mostra lo schema di Griglia di eventi per un evento ricevuto tramite SMS.

Screenshot del visualizzatore Griglia di eventi di Azure che mostra lo schema di Griglia di eventi per un evento del report di recapito SMS.

Altre informazioni sugli schemi di eventi e altri concetti relativi agli eventi.

Pulire le risorse

Per pulire e rimuovere una sottoscrizione di Servizi di comunicazione, è possibile eliminare la risorsa o il gruppo di risorse. Eliminando il gruppo di risorse vengono eliminate anche tutte le altre risorse associate. Vedere altre informazioni sulla pulizia delle risorse.

Passaggi successivi

In questo avvio rapido si è appreso come utilizzare gli eventi SMS. È possibile ricevere messaggi SMS creando una sottoscrizione di Griglia di eventi.

Invia SMS

È anche possibile: