Condividi tramite

Gestire gli eventi SMS

Inizia con Servizi di comunicazione di Azure utilizzando Azure Event Grid per gestire gli eventi SMS di Servizi di comunicazione. Dopo aver sottoscritto eventi SMS, ad esempio messaggi in ingresso e report di recapito, è possibile generare e ricevere questi eventi.

Il completamento di questo articolo comporta un piccolo costo di alcuni centesimi di dollaro o meno sul tuo 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 relativa all'idoneità alla sottoscrizione.

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. Questo articolo descrive come inviare gli eventi a un'app Web che raccoglie e visualizza i messaggi.

Configurare l'ambiente

Per configurare l'ambiente per generare e ricevere eventi, completare le sezioni seguenti.

Registrare un provider di risorse Event Grid

Se non si usa Griglia di eventi nella sottoscrizione di Azure, è necessario registrare il provider di risorse di Griglia di eventi. Per registrare il provider, seguire questa procedura:

  1. Vai 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 Event Grid

Per questo esempio, usare un visualizzatore Griglia di eventi per visualizzare gli eventi quasi in tempo reale. Questo visualizzatore fornisce all'utente l'esperienza di un feed in tempo reale. Inoltre, il payload di ogni evento dovrebbe essere disponibile per ispezione.

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

Abbonati agli eventi SMS tramite webhook

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

  1. Nel portale, vai alla risorsa Servizi di Comunicazione che hai creato.

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

  3. Selezionare Aggiungere una sottoscrizione di eventi.

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

  4. Nella pagina Crea sottoscrizione evento immettere un nome per la sottoscrizione all'evento.

  5. In Tipi di eventiselezionare gli eventi a cui si desidera sottoscrivere. 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 eventi. In Tipi di evento, vengono selezionati SMS ricevuto e Report di recapito SMS ricevuto.

  7. Per Tipo di endpoint selezionare Webhook.

    Screenshot che mostra un dettaglio della finestra di dialogo Crea sottoscrizione evento. Nell'elenco Tipo di endpoint è selezionato Webhook.

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

    In questo caso, viene usato l'URL del Visualizzatore di Griglia di eventi configurato in precedenza nell'avvio rapido. L'URL per l'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, completare la procedura seguente.

Attivare eventi SMS

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

  • SMS Received gli eventi vengono generati quando il numero di telefono di 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. Prova 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.

Consultare l'elenco completo degli eventi supportati dai Servizi di comunicazione.

Ricevere eventi SMS

Dopo aver generato un evento, verifica che gli eventi SMS Received e SMS Delivery Report Received vengano inviati al tuo endpoint. Questi eventi sono visualizzati nel Visualizzatore di Griglia di eventi configurato all'inizio dell'avvio rapido. Per visualizzare l'intero payload, selezionare l'icona a forma di occhio accanto all'evento. 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 di report di recapito SMS.

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

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 elimina anche tutte le altre risorse associate. Altre informazioni sulla pulizia delle risorse.

Passaggi successivi

Invia SMS