Publicer en agent til WhatsApp

Efter du har offentliggjort din agent, kan du gøre den tilgængelig for dine WhatsApp-brugere. Dine WhatsApp-brugere kan ikke interagere med agenten, før du har offentliggjort agenten.

Konfigurer din agent til at bruge WhatsApp

1. Sæt din agents autentificering til enten ingen autentificering eller autentificer manuelt.

2. Publicer din agent. Se Publicer det nyeste indhold.

3. Gå til siden Kanaler for din agent.

4. Vælg WhatsApp. Konfigurationspanelet vises.

5. Vælg Fortsæt på den første side i konfigurationspanelet.

6. Vælg din Azure-abonnements- og Azure Communication Services-ressource (ACS), og vælg derefter Fortsæt.

7. Vælg det telefonnummer, du vil have din agent til at forbinde til, og vælg derefter Deploy.

   Note

   Når du har valgt Deploy, kan Copilot Studio tage et øjeblik, før du viser en QR-kode.

8. Brug din WhatsApp-enhed til at scanne QR-koden og begynd at chatte med agenten over WhatsApp. Du kan også vælge Download for at downloade QR-kodebilledet. Alle med denne QR-kode, der opfylder alle godkendelseskriterier, kan chatte med agenten via WhatsApp.

Brug understøttede Adaptive kort i din agents emner

Som med alle agenter i Copilot Studio bruger agenter, der er udrullet til WhatsApp, emner til at definere, hvordan en agentsamtale skrider frem. Adaptive kort giver dig mulighed for at skrive platformagnostiske brugergrænsefladestykker i JSON, der fortolkes til oprindelig brugergrænseflade, når de leveres til bestemte apps. WhatsApp-agenter understøtter følgende tre typer adaptive kort:

• Adaptivt kort til interaktive handlinger ("type": "Action.Submit")

  

• Valg af adaptivt kort ("type": "Input.ChoiceSet")

  

• Åbn adaptivt URL-kort ("type": "Action.OpenUrl")

  

Som maker, hvis du vil implementere en agent på en WhatsApp-kanal, skal du begrænse din brug af adaptive kort til denne undergruppe af korttyper. Du kan få flere oplysninger om brugen af adaptive kort i Copilot Studio under Brug af adaptive kort i Copilot Studio.

Eksempel: Interaktive handlinger - adaptivt kort

Brug det tilpassede kort Interaktive handlinger til at give slutbrugerne mulighed for at vælge en af op til tre indstillinger i form af knapper. Denne metode til valg af flere indstillinger er hurtigere for slutbrugeren med færre trin end den alternative metode til valg på en liste over indstillinger (metoden Valg af adaptivt kort). Men det adaptive kort til interaktive handlinger kan dog ikke bruges til mere end tre knapper. Producenter kan aktivere dette adaptive kort ved at bruge funktionen Ask with Adaptive Card .

1. Gå til det ønskede emne, og tilføj en adaptiv kortnode.

2. Kopiér og indsæt følgende JSON-kode i editoren til kortnyttedata i designeren af adaptive kort:

   {
   "type": "AdaptiveCard",
   "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
   "version": "1.5",
   "body": [
     {
       "type": "TextBlock",
       "text": "Do you want to go to a weather web site for a specific country?",
       "wrap": true
     },
     {
       "type": "ActionSet",
       "actions": [
         {
           "type": "Action.Submit",
           "title": "Yes",
           "id": "yesButtonId"
         },
         {
           "type": "Action.Submit",
           "title": "No",
           "id": "noButtonId"
         }
       ]
    }
   ]
   }
   

3. I JSON-filen, i afsnittet med en type-nøgle med værdien ActionSet, under "actions":, skal du sørge for at have det rigtige antal handlinger.

   Hvis du f.eks. har brug for tre knapper under "actions":, skal der være tre sæt handlinger, hvor hvert sæt består af nøglen type, titleog id .

4. Foretag følgende yderligere ændringer af JSON:

   Forskydning	Til
   Værdi af "text": (under "type": "TextBlock")	Den ønskede tekst, der beder slutbrugerne om at foretage et valg blandt knapperne
   Værdi af "title": (under den første "type": "Action.Submit" nøgle)	Den ønskede tekst på den første knap
   Værdi af "id": (under den første "type": "Action.Submit" nøgle)	Det ønskede id for den første knap
   Værdi af "title": (under den anden "type": "Action.Submit" nøgle)	Den ønskede tekst på den anden knap
   Værdi af "id": (under den anden "type": "Action.Submit" nøgle)	Det ønskede id for den anden knap

5. Vælg Gem i designeren til adaptivt kort, og vælg derefter Luk.

   Forfatterlærredet for dette emne kan ligne følgende skærmbillede:

   Skærmbillede af redigeringslærred, som viser det samtaleflow, der gør det muligt for brugerne at vælge en af op til tre knapper.

6. Gem dit tema.

7. Når du er færdig med alle ændringer af agenten, skal du publicere din agent igen.

Eksempel: Valg af adaptivt kort

Brug det tilpassede valgkort til at give slutbrugerne mulighed for at vælge én indstilling fra op til 10, der vises som en liste. Dette adaptive kort bruger en tekstblok, som slutbrugeren af WhatsApp skal vælge, som derefter viser valgsættet af indstillinger. Slutbrugeren skal derefter vælge en af indstillingerne og derefter vælge Send. Udviklere kan aktivere dette adaptive kort med funktionen Spørg med adaptivt kort .

1. I forfatterlærredet for det emne, du vil tilføje dette adaptive kort til, vælger du ikonet Tilføj node på det ønskede sted, og vælg derefter Spørg med adaptivt kort.

2. Vælg den nye Adaptive Card-node for at bringe den i fokus. Vælg Mere-ikonet for noden og vælg Egenskaber.

3. I ruden Egenskaber for adaptiv kortnode skal du vælge Rediger adaptivt kort.

4. Kopiér og indsæt følgende JSON-kode i editoren til kortnyttedata i designeren af adaptive kort:

   {
   "type": "AdaptiveCard",
   "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
   "version": "1.5",
   "body": [
     {
       "type": "TextBlock",
       "text": "Pick a country:",
       "wrap": true
     },
     {
       "type": "Input.ChoiceSet",
       "choices": [
         {
           "title": "Falkland Islands",
           "value": "Falkland Islands"
         },
         {
           "title": "Singapore",
           "value": "Singapore"
         },
         {
           "title": "Norway",
           "value": "Norway"
         },
         {
           "title": "South Africa",
           "value": "South Africa"
         }
       ],
       "placeholder": "Select Country",
       "id": "countryChoice"
     },
     {
       "type": "ActionSet",
       "actions": [
         {
           "type": "Action.Submit",
           "title": "Submit Response",
           "id": "submitResponseId"
         }
       ]
     }
   ]
   }
   

5. Kontrollér, at du har det rette antal valgmuligheder under i afsnittet med en type nøgle af typen værdi Input.ChoiceSeti "choices":JSON.

   Hvis du f.eks. har brug for syv (7) valg, der kan vælges, på en liste under "choices":skal der være syv sæt valgmuligheder, hvor hvert sæt består af en title og value -nøgle.

6. Foretag følgende yderligere ændringer af JSON:

   Forskydning	Til
   Værdi af "text": (under "type": "TextBlock")	Den ønskede tekst, der beder slutbrugerne om at få vist en liste over indstillinger
   Værdien af "title": (for hvert valg under "type": "Input.ChoiceSet" nøgle)	Den ønskede tekst, der beskriver eller navngiver den angivne indstilling
   Værdien af "value": (for hvert valg under "type": "Input.ChoiceSet" nøgle)	Den værdi, der er tildelt til Input.ChoiceSet.value, som derefter bruges til yderligere behandling
   Værdi af "id": (under "type": "Input.ChoiceSet")	Id-værdien for variablen for valgsæt (med navnet countryChoicei eksemplet). Denne id-værdi bruger den registrerede value værdi, der angiver brugerens valg på listen. Bemærk! Denne værdi skal være i det formelle camelCase-format .

7. Vælg Gem i designeren til adaptivt kort, og vælg derefter Luk.

   Forfatterlærredet for dette emne kan ligne følgende skærmbillede:

   

8. Vælg Gem på oprettelseslærredet for at bekræfte ændringerne af dit tilpassede kort i emnet.

9. Når du er færdig med alle ændringer i agenten, genudgiver du agenten.

Eksempel: Åbn adaptivt URL-kort

Brug kortet Åbn tilpasset URL-adresse til at sende en slutbruger til et websted. I modsætning til de to andre adaptive kort kan adaptive open URL-kort ikke aktiveres ved hjælp af Ask med adaptivt kort funktionalitet i Copilot Studio. I stedet skal du vedhæfte dette adaptive kort til en besked, der er oprettet ved hjælp af funktionen Send en besked .

1. I forfatterlærredet for emnet, hvor du vil tilføje dette adaptive kort, skal du vælge ikonet Tilføj node på det ønskede sted, og derefter vælge Send en besked.

2. I den nye node Meddelelse skal du vælge Tilføj>Adaptivt kort.

3. Vælg det nye medieområde på beskednoden. Vælg derefter Mere-ikonet for noden og vælg Egenskaber.

   Note

   Vælg det nye medieområde i meddelelsesnoden igen, hvis knappen Rediger adaptivt kort ikke vises i ruden Egenskaber for adaptivt kort .

4. I ruden Egenskaber for adaptivt kort skal du vælge Rediger adaptivt kort.

5. Kopiér og indsæt følgende JSON-kode i editoren til kortnyttedata i designeren af adaptive kort:

   {
   "type": "AdaptiveCard",
   "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
   "version": "1.5",
   "body": [
     {
       "type": "TextBlock",
        "text": "Click 'Ok' for weather information for Singapore.",
        "wrap": true
     },
     {
       "type": "ActionSet",
       "actions": [
          {
            "type": "Action.OpenUrl",
            "title": "Ok",
            "url": "https://www.msn.com/en-za/weather/forecast/in-Singapore"
          }
       ]
     }
   ]
   }
   

6. Foretag følgende ændringer af JSON:

   Forskydning	Til
   Værdi af "text": (under "type": "TextBlock")	Den ønskede tekst, der beder slutbrugerne om at åbne webstedet
   Værdi af "title": (under "type": "ActionSet" nøgle)	Den ønskede tekst, der kan vælges, og som åbner webstedet i en browser, når den vælges
   Værdi af "url": (under "type": "ActionSet" nøgle)	Den ønskede værdi af webstedets url-adresse (uniform resource locator)

7. Vælg Gem i designeren til adaptivt kort, og vælg derefter Luk.

   Forfatterlærredet for dette emne kan ligne følgende skærmbillede:

   

8. Vælg Gem på oprettelseslærredet for at bekræfte ændringerne af dit tilpassede kort i emnet.

9. Når du er færdig med alle ændringer i agenten, genudgiver du agenten.

Konfigurér brugergodkendelse ved at bruge telefonnumre i WhatsApp

Når du offentliggør en agent til WhatsApp, kan du vælge, om du vil autentificere brugere. Hvis du vælger ikke at autentificere brugere, behøver du ikke tage yderligere skridt.

Hvis du vælger at autentificere brugere, har du følgende muligheder:

• Godkend manuelt (se Godkend manuelt)

• Autentificer ved at bruge et telefonnummer som et anerkendt WhatsApp-ID (se Eksempel: Autentificer med et telefonnummer)

• Godkend manuelt og ved hjælp af genkendelse af telefonnummer. Autentificer ved at bruge begge metoder for øget sikkerhed.

  Vigtig

  WhatsApp-kanalen understøtter ikke autentificering med Microsoft.

Eksempel: Godkend med et telefonnummer

WhatsApp bruger telefonnumre som identifikatorer (id'er). Når en udvikler vælger godkendelse af telefonnummer, kontrollerer en backend-API, at brugerens WhatsApp-telefonnummer er på listen over godkendte numre i databasen. Konfigurer en udløser i Copilot Studio for at sende en HTTP-anmodning til API'en, definere svarskemaet og angive betingelser for at styre samtaleflowet baseret på brugerregistreringsstatus.

I dette eksempel leverer serveren følgende API:

URI: /exists/_{phoneNumber}_

Svar:

  {
      phone: string
      exists: boolean 
  }

1. Gå til siden Emner for din agent.

2. Vælg Tilføj et emne>fra bunden.

3. Vælg ikonet Skift udløser for noden Udløser, og vælg derefter En meddelelse modtages.

   

4. Vælg ikonet Tilføj node under udløsernoden, og vælg Variabelstyring>Angiv en variabelværdi.

5. Vælg feltet Angiv variabel i noden Angiv variabelværdi.

6. I vinduet Vælg en variabel skal du vælge Opret ny.

7. I noden Angiv variabelværdi skal du vælge variabelnavnet i feltet Angiv variabel og derefter omdøbe variabelnavnet i ruden Variabelegenskaber .

8. Vælg de tre prikker (...) i feltet Til-værdi i noden Angiv variabelværdi.

9. I vinduet Angiv formel skal du vælge fanen Formel .

10. Kopiér følgende formel til formelfeltet, og substituer <<BaseUri>> med API'ens URI (Uniform Resource Identifier), og vælg derefter Insert.

    <BaseUri>/exists/"&System.Activity.From.Id

    

11. Vælg ikonet Tilføj node under noden Angiv variabelværdi , og vælg Avanceret>Send HTTP-anmodning.

12. Vælg Optag under Svardatatype.

13. Vælg Rediger skema, og angiv svarskemaet.

    kind: Record
    properties:
      exists: Boolean
      phone: String
    

14. Opret en ny variabel med navnet for apiResponse.

15. Vælg ikonet Tilføj node under noden HTTP-anmodning , og vælg Tilføj en betingelse.

16. Vælg Vælg en variabel> i noden Betingelse.

17. Vælg Er lig med i det andet inputfelt.

18. Under Angiv eller vælg en værdi skal du skrive true.

19. Vælg ikonet Tilføj node under noden Alle andre betingelser , og vælg Send en meddelelse.

20. Skriv en meddelelse, der skal vises til ikke-registrerede brugere.

    Note

    Du kan tilpasse den meddelelse, der sendes til ikke-registrerede brugere. I dette eksempel er Sorry, you are not registeredmeddelelsen .

21. Vælg ikonet Tilføj node under noden Meddelelse , og vælg Emneadministration>Afslut alle emner.

22. Vælg ikonet Tilføj node under noden Afslut alle emner , og vælg Emneadministration>Afslut samtale.

    

23. Vælg Gem på oprettelseslærredet for at bekræfte dine ændringer i emnet.

24. Når du er færdig med alle ændringer i agenten, genudgiver du agenten.

    Når du har publiceret ændringen, kontrollerer systemet det telefonnummer, der er knyttet til brugerens WhatsApp-enhed. Hvis tallet ikke findes i databasen, viser systemet den meddelelse, du har konfigureret som meddelelsen om ikke-registreret.

    

Afbryd forbindelsen mellem en agent og et telefonnummer

Hvis du vil afbryde forbindelsen mellem din agent og det telefonnummer, der er konfigureret for WhatsApp-kanalen, skal du åbne konfigurationspanelet og vælge Afbryd forbindelsen.

Begrænsninger

WhatsApp-kanalen understøtter ikke upload eller download af filer.