Comunicazione: creazione di una risorsa di Servizi di comunicazione di Azure

2025-06-13

Una comunicazione efficace è essenziale per applicazioni aziendali personalizzate di successo. Usando Servizi di comunicazione di Azure (ACS), è possibile aggiungere funzionalità come telefonate, chat in tempo reale, audio/videochiamate e messaggi di posta elettronica e SMS alle applicazioni. In precedenza si è appreso come Azure OpenAI può generare completamenti per i messaggi di posta elettronica e SMS. A questo punto, si apprenderà come inviare i messaggi. Insieme, ACS e OpenAI possono migliorare le applicazioni semplificando la comunicazione, migliorando le interazioni e aumentando la produttività aziendale.

In questo esercizio si eseguiranno le seguenti operazioni:

Creare una risorsa Servizi di comunicazione di Azure (ACS).
Aggiungere un numero di telefono verde con funzionalità di chiamata e SMS.
Connettere un dominio di posta elettronica.
Aggiornare il file con estensione env del progetto con i valori della risorsa ACS.

Panoramica dello scenario di Microsoft Cloud

Creare una risorsa Servizi di comunicazione di Azure

Visitare il portale di Azure nel browser e accedere se non è già stato fatto.
Digitare servizi di comunicazione nella barra di ricerca nella parte superiore della pagina e selezionare Servizi di comunicazione dalle opzioni visualizzate.
Selezionare Crea sulla barra degli strumenti.
Eseguire le attività seguenti:
- Seleziona la tua sottoscrizione di Azure.
- Selezionare il gruppo di risorse da usare (crearne uno nuovo se non esiste).
- Immettere un nome di risorsa ACS. Deve essere un valore univoco.
- Selezionare un percorso dati.
Selezionare Rivedi e crea seguito da Crea.
È stata creata una nuova risorsa Servizi di comunicazione di Azure. Successivamente, si abiliteranno le funzionalità di chiamata telefonica e SMS. Si connetterà anche un dominio di posta elettronica alla risorsa.

Abilitare le funzionalità chiamate telefoniche e SMS

Aggiungere un numero di telefono e assicurarsi che il numero di telefono abbia funzionalità di chiamata abilitate. Questo numero di telefono verrà usato per chiamare un telefono dall'app.
- Selezionare Telefonia e SMS -->Numeri di telefono dal menu Risorsa.
- Selezionare + Ottieni sulla barra degli strumenti (o selezionare il pulsante Ottieni un numero ) e immettere le informazioni seguenti:
  - Paese o area geografica: United States
  - Tipo di numero: Toll-free
  Annotazioni
  
  Per creare il numero verde, è necessaria una carta di credito nella sottoscrizione di Azure. Se non si dispone di una scheda su file, è possibile ignorare l'aggiunta di un numero di telefono e passare alla sezione successiva dell'esercizio che connette un dominio di posta elettronica. Puoi comunque usare l'app, ma non potrai chiamare un numero di telefono.
  - Numero: selezionare Aggiungi al carrello per uno dei numeri di telefono elencati.
Selezionare Avanti, esaminare i dettagli del numero di telefono e selezionare Acquista ora.

Annotazioni

La verifica tramite SMS per i numeri verdi è ora obbligatoria nei Stati Uniti e canada. Per abilitare la messaggistica SMS, è necessario inviare la verifica dopo l'acquisto del numero di telefono. Anche se questa esercitazione non eseguirà questo processo, è possibile selezionare Telefonia e SMS -->Documenti normativi dal menu delle risorse e aggiungere la documentazione di convalida necessaria.
Dopo aver creato il numero di telefono, selezionarlo per accedere al pannello Funzionalità . Assicurarsi che i valori seguenti siano impostati (devono essere impostati per impostazione predefinita):
- Nella sezione Chiamata selezionare Make calls.
- Nella sezione SMS selezionare Send and receive SMS.
- Seleziona Salva.
Copiare il valore del numero di telefono in un file per usarlo in un secondo momento. Il numero di telefono deve seguire questo modello generale: +12345678900.

Connettere un dominio di posta elettronica

Eseguire le attività seguenti per creare un dominio di posta elettronica connesso per la risorsa ACS in modo da poter inviare un messaggio di posta elettronica. Verrà usato per inviare messaggi di posta elettronica dall'app.
- Selezionare Posta elettronica -->Domini dal menu Risorsa.
- Selezionare Connetti dominio sulla barra degli strumenti.
- Selezionare la sottoscrizione e il gruppo di risorse.
- Nell'elenco a discesa Servizio di posta elettronica selezionare Add an email service.
- Assegnare al servizio di posta elettronica un nome, acs-demo-email-servicead esempio .
- Selezionare Rivedi e crea seguito da Crea.
- Al termine della distribuzione, selezionare e selezionare Go to resource1-click add per aggiungere un sottodominio di Azure gratuito.
- Dopo aver aggiunto il sottodominio (la distribuzione richiederà alcuni istanti), selezionarla.
- Una volta visualizzata la schermata AzureManagedDomain , selezionare Servizi di posta elettronica -->MailDa indirizzi dal menu Risorsa.
- Copiare il valore MailFrom in un file. Verrà usato in un secondo momento durante l'aggiornamento del file con estensione env .
- Tornare alla risorsa di Servizi di comunicazione di Azure e selezionare Posta elettronica -->Domini dal menu delle risorse.
- Selezionare Add domain e immettere il MailFrom valore del passaggio precedente (assicurarsi di selezionare la sottoscrizione, il gruppo di risorse e il servizio di posta elettronica corretti). Seleziona il pulsante Connect.

Aggiornare il `.env` file

Ora che il numero di telefono ACS (con chiamate e SMS abilitati) e il dominio di posta elettronica sono pronti, aggiornare le chiavi/valori seguenti nel file con estensione env nel progetto:
```
ACS_CONNECTION_STRING=<ACS_CONNECTION_STRING>
ACS_PHONE_NUMBER=<ACS_PHONE_NUMBER>
ACS_EMAIL_ADDRESS=<ACS_EMAIL_ADDRESS>
CUSTOMER_EMAIL_ADDRESS=<EMAIL_ADDRESS_TO_SEND_EMAIL_TO>
CUSTOMER_PHONE_NUMBER=<UNITED_STATES_BASED_NUMBER_TO_SEND_SMS_TO>
```
- ACS_CONNECTION_STRING connection string: valore della sezione Chiavi della risorsa ACS.
- ACS_PHONE_NUMBER: assegnare il numero verde al ACS_PHONE_NUMBER valore .
- ACS_EMAIL_ADDRESS: assegnare il valore dell'indirizzo di posta elettronica "MailTo".
- CUSTOMER_EMAIL_ADDRESS: assegnare un indirizzo di posta elettronica a cui inviare un messaggio di posta elettronica dall'app (poiché i dati dei clienti nel database dell'app sono solo dati di esempio). È possibile usare un indirizzo di posta elettronica personale.
- CUSTOMER_PHONE_NUMBER: è necessario specificare un numero di telefono basato sugli Stati Uniti (a partire da oggi) a causa di una verifica aggiuntiva necessaria in altri paesi/aree geografiche per l'invio di messaggi SMS. Se non si dispone di un numero basato sugli Stati Uniti, è possibile lasciarlo vuoto.

Avviare/riavviare le applicazioni e i server API

Eseguire uno dei passaggi seguenti in base agli esercizi completati fino a questo punto:

Se il database, il server API e il server Web sono stati avviati in un esercizio precedente, è necessario arrestare il server API e il server Web e riavviarli per selezionare le modifiche apportate al file con estensione env . È possibile lasciare in esecuzione il database.

Individuare le finestre del terminale che eseguono il server API e il server Web e premere CTRL+C per arrestarli. Avviarli di nuovo digitando npm start in ogni finestra del terminale e premendo INVIO. Continuare con l'esercizio successivo.
Se il database, il server API e il server Web non sono ancora stati avviati, completare i passaggi seguenti:
1. Nei passaggi seguenti verranno create tre finestre del terminale in Visual Studio Code.
2. Fare clic con il pulsante destro del mouse sul file con estensione env nell'elenco dei file di Visual Studio Code e scegliere Apri nel terminale integrato. Assicurarsi che il terminale si trova nella radice del progetto, openai-acs-msgraph , prima di continuare.
3. Scegliere una delle opzioni seguenti per avviare il database PostgreSQL:
  - Se Docker Desktop è installato e in esecuzione, eseguire docker-compose up nella finestra del terminale e premere INVIO.
  - Se si dispone di Podman con podman-compose installato e in esecuzione, eseguire podman-compose up nella finestra del terminale e premere INVIO.
  - Per eseguire il contenitore PostgreSQL direttamente usando Docker Desktop, Podman, nerdctl o un altro runtime del contenitore installato, eseguire il comando seguente nella finestra del terminale:
    - Mac, Linux o sottosistema Windows per Linux (WSL):
```
[docker | podman | nerdctl] run --name postgresDb -e POSTGRES_USER=web -e POSTGRES_PASSWORD=web-password -e POSTGRES_DB=CustomersDB -v $(pwd)/data:/var/lib/postgresql/data -p 5432:5432 postgres
```
    - Windows con PowerShell:
```
[docker | podman] run --name postgresDb -e POSTGRES_USER=web -e POSTGRES_PASSWORD=web-password -e POSTGRES_DB=CustomersDB -v ${PWD}/data:/var/lib/postgresql/data -p 5432:5432 postgres
```
4. Dopo l'avvio del contenitore di database, premere l'icona + nella barra degli strumenti del terminale di Visual Studio Code per creare una seconda finestra del terminale.
5. cd nella cartella server/typescript ed eseguire i comandi seguenti per installare le dipendenze e avviare il server API.
  - npm install
  - npm start
6. Premere di nuovo l'icona + nella barra degli strumenti del terminale di Visual Studio Code per creare una terza finestra del terminale.
7. cd nella cartella client ed eseguire i comandi seguenti per installare le dipendenze e avviare il server Web.
  - npm install
  - npm start
8. Verrà avviato un browser e si passerà a http://localhost:4200.

Passaggio successivo

Comunicazione: effettuare una telefonata

Condividi tramite