Kommunikation: Skapa en Azure Communication Services-resurs

2025-06-13

Effektiv kommunikation är avgörande för lyckade anpassade affärsprogram. Genom att använda Azure Communication Services (ACS) kan du lägga till funktioner som telefonsamtal, livechatt, ljud-/videosamtal och e-post- och SMS-meddelanden i dina program. Tidigare har du lärt dig hur Azure OpenAI kan generera slutföranden för e-post och SMS. Nu får du lära dig hur du skickar meddelandena. Tillsammans kan ACS och OpenAI förbättra dina program genom att förenkla kommunikationen, förbättra interaktionerna och öka affärsproduktiviteten.

I den här övningen ska du:

Skapa en Azure Communication Services-resurs (ACS).
Lägg till ett avgiftsfritt telefonnummer med samtals- och SMS-funktioner.
Anslut en e-postdomän.
Uppdatera projektets .env-fil med värden från acs-resursen.

Översikt över Microsoft Cloud-scenario

Skapa en Azure Communication Services-resurs

Besök Azure Portal i webbläsaren och logga in om du inte redan har gjort det.
Skriv kommunikationstjänster i sökfältet överst på sidan och välj Kommunikationstjänster bland de alternativ som visas.
Välj Skapa i verktygsfältet.
Utför följande uppgifter:
- Välj din Azure-prenumeration.
- Välj den resursgrupp som ska användas (skapa en ny om den inte finns).
- Ange ett ACS-resursnamn. Det måste vara ett unikt värde.
- Välj en dataplats.
Välj Granska + Skapa följt av Skapa.
Du har skapat en ny Azure Communication Services-resurs! Därefter aktiverar du funktioner för telefonsamtal och SMS. Du ansluter också en e-postdomän till resursen.

Aktivera funktioner för telefonsamtal och SMS

Lägg till ett telefonnummer och se till att telefonnumret har samtalsfunktioner aktiverade. Du använder det här telefonnumret för att ringa till en telefon från appen.
- Välj Telefoni och SMS -->Telefonnummer på resursmenyn.
- Välj + Hämta i verktygsfältet (eller välj knappen Hämta ett nummer ) och ange följande information:
  - Land eller region: United States
  - Nummertyp: Toll-free
  Anmärkning
  
  Ett kreditkort krävs i din Azure-prenumeration för att skapa det avgiftsfria numret. Om du inte har ett kort i filen kan du hoppa över att lägga till ett telefonnummer och gå vidare till nästa avsnitt i övningen som ansluter en e-postdomän. Du kan fortfarande använda appen, men kommer inte att kunna ringa upp till ett telefonnummer.
  - Nummer: Välj Lägg till i kundvagn för ett av de telefonnummer som visas.
Välj Nästa, granska telefonnummerinformationen och välj Köp nu.

Anmärkning

SMS-verifiering för avgiftsfria nummer är nu obligatoriskt i USA och Kanada. Om du vill aktivera SMS-meddelanden måste du skicka verifiering efter köpet av telefonnumret. Även om den här självstudien inte går igenom den processen kan du välja Telefoni och SMS –->Regeldokument på resursmenyn och lägga till den valideringsdokumentation som krävs.
När telefonnumret har skapats väljer du det för att komma till panelen Funktioner . Kontrollera att följande värden har angetts (de ska anges som standard):
- I avsnittet Samtal väljer du Make calls.
- I avsnittet SMS väljer du Send and receive SMS.
- Välj Spara.
Kopiera värdet för telefonnummer till en fil för senare användning. Telefonnumret bör följa det här allmänna mönstret: +12345678900.

Ansluta en e-postdomän

Utför följande uppgifter för att skapa en ansluten e-postdomän för din ACS-resurs så att du kan skicka e-post. Detta används för att skicka e-post från appen.
- Välj E-post –>Domäner på resursmenyn.
- Välj Anslut domän i verktygsfältet.
- Välj din prenumeration och resursgrupp.
- Under listrutan E-posttjänst väljer du Add an email service.
- Ge e-posttjänsten ett namn som acs-demo-email-service.
- Välj Granska + skapa följt av Skapa.
- När distributionen är klar väljer du Go to resourceoch väljer 1-click add för att lägga till en kostnadsfri Azure-underdomän.
- När underdomänen har lagts till (det tar en stund att distribuera den) väljer du den.
- När du är på skärmen AzureManagedDomain väljer du E-posttjänster – > från resursmenyn.
- Kopiera värdet MailFrom till en fil. Du kommer att använda den senare när du uppdaterar .env-filen .
- Gå tillbaka till din Azure Communication Services-resurs> och välj E-post – Domäner på resursmenyn.
- Välj Add domain och ange MailFrom värdet från föregående steg (se till att du väljer rätt prenumeration, resursgrupp och e-posttjänst). Välj knappen Connect.

`.env` Uppdatera filen

Nu när ditt ACS-telefonnummer (med samtal och SMS aktiverat) och e-postdomänen är klara uppdaterar du följande nycklar/värden i .env-filen i projektet:
```
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: Värdet connection string från avsnittet Nycklar i din ACS-resurs.
- ACS_PHONE_NUMBER: Tilldela ditt avgiftsfria nummer till ACS_PHONE_NUMBER värdet.
- ACS_EMAIL_ADDRESS: Tilldela adressvärdet e-post "MailTo".
- CUSTOMER_EMAIL_ADDRESS: Tilldela en e-postadress som du vill att e-post ska skickas till från appen (eftersom kunddata i appens databas endast är exempeldata). Du kan använda en personlig e-postadress.
- CUSTOMER_PHONE_NUMBER: Du måste ange ett usa-baserat telefonnummer (från och med idag) på grund av ytterligare verifiering som krävs i andra länder/regioner för att skicka SMS. Om du inte har ett USA-baserat nummer kan du lämna det tomt.

Starta/starta om programmet och API-servrarna

Utför något av följande steg baserat på de övningar som du har slutfört fram till den här punkten:

Om du startade databasen, API-servern och webbservern i en tidigare övning måste du stoppa API-servern och webbservern och starta om dem för att hämta filändringarna i .env . Du kan låta databasen köras.

Leta upp terminalfönstren som kör API-servern och webbservern och tryck på CTRL + C för att stoppa dem. Starta dem igen genom att npm start skriva i varje terminalfönster och trycka på Retur. Fortsätt till nästa övning.
Om du inte har startat databasen, API-servern och webbservern ännu utför du följande steg:
1. I följande steg skapar du tre terminalfönster i Visual Studio Code.
2. Högerklicka på .env-filen i Visual Studio Code-fillistan och välj Öppna i integrerad terminal. Kontrollera att terminalen finns i roten av projektet – openai-acs-msgraph – innan du fortsätter.
3. Välj något av följande alternativ för att starta PostgreSQL-databasen:
  - Om du har Docker Desktop installerat och körs kör du docker-compose up i terminalfönstret och trycker på Retur.
  - Om du har Podman med podman-compose installerat och körs kör podman-compose up du i terminalfönstret och trycker på Retur.
  - Kör följande kommando i terminalfönstret om du vill köra PostgreSQL-containern direkt med antingen Docker Desktop, Podman, nerdctl eller någon annan containerkörning som du har installerat:
    - Mac, Linux eller Windows-undersystem för 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 med 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. När databascontainern startar trycker du på + ikonen i verktygsfältet i Visual Studio Code-terminalen för att skapa ett andra terminalfönster.
5. cd i mappen server/typescript och kör följande kommandon för att installera beroendena och starta API-servern.
  - npm install
  - npm start
6. Tryck på + ikonen igen i verktygsfältet i Visual Studio Code-terminalen för att skapa ett tredje terminalfönster.
7. cdi klientmappen och kör följande kommandon för att installera beroendena och starta webbservern.
  - npm install
  - npm start
8. En webbläsare startas och du tas till http://localhost:4200.

Nästa steg

Kommunikation: Ringa ett telefonsamtal

Dela via