Loading
Agentforce
Sisällysluettelo
Valitse suodattimet

          Ei tuloksia
          Ei tuloksia
          Tässä on joitain hakuvinkkejä

          Tarkista avainsanojesi oikeinkirjoitus.
          Käytä yleisempiä hakutermejä.
          Laajenna hakua valitsemalla vähemmän suodattimia.

          Hae koko Salesforce-ohjeesta
          Ruutukulkujen käyttäminen syötetyn datan välittämiseksi dynaamiseen WhatsApp-kulkuun

          Ruutukulkujen käyttäminen syötetyn datan välittämiseksi dynaamiseen WhatsApp-kulkuun

          Ruutukulku voi kerätä asiakastietoja ja välittää niitä turvallisesti muuttujiin. Nämä muuttujat voivat sitten toimia input-arvona dynaamiselle WhatsApp-kululle, joka luodaan Apexiin perustuvalla lomakkeiden viestintäkomponentilla. Jos haluat lisätä viestiin henkilökohtaista sisältöä, lisää dynaamisia viitteitä tähän syötettyyn dataan Apexiin perustuvassa lomakkeiden viestintäkomponentissa. Jos haluat esimerkiksi ajoittaa eläinlääkäritapaamisen, ruutukulku kerää tiettyjä tietoja, kuten eläimen tyypin ja ongelman, ja välittää nämä tiedot dynaamisesti Apexiin perustuvaan lomakkeiden viestintäkomponenttiin.

          Vaaditut versiot

          Näytä tuetut Edition-versiot.
          Valintamerkki Tätä artikkelia sovelletaan: Parannetut WhatsApp-kanavat, yhtenäistetty WhatsApp
          X-kuvake Tätä artikkelia ei sovelleta: Parannettu sovelluksen sisäinen chat, parannettu Web-chat, vakiomuotoinen ja parannettu Facebook Messenger, vakiomuotoiset ja parannetut SMS-tekstiviestit, parannetut Apple Messages for Business, parannettu LINE ja Bring Your Own Channel
          Tarvittavat käyttöoikeudet
          Viestintäkomponenttien luominen:

          Sovellusten mukautusoikeus JA määritysten ja kokoonpanon tarkasteluoikeus

          OR

          Järjestelmän pääkäyttäjä

          Viestien lähettäminen ja vastaanottaminen Messaging-ominaisuudessa: Messaging-agentti

          Kun luot Apexiin perustuvan lomakkeiden viestintäkomponentin, nämä vakiomuotoiset input-parametrit ovat oletusarvoisesti käytettävissä.

          Parametri Kuvaus
          FormData Tallentaa kulkuun välitetyt syötetyt tiedot. Data tallennetaan avain-arvojen parien JSON-merkkijonona. Jos haluat viitata tähän dataan, sinun täytyy määrittää datan rakenne datamallissa. Datamallin rakenteen täytyy vastata JSON-tiedoston rakennetta. Voit käyttää näitä tietoja Apexilla tai ruutukululla.
          FormEntryScreenId Tallentaa aloitusruudun tunnuksen, joka on ensimmäinen ruutu, jonka viestintän loppukäyttäjä näkee.

          Löydät nämä oletusarvoiset parametrit Komponentin lisätiedot -osion Parametrit-välilehdestä.Näyttää oletusarvoisesti luodut FormData- ja FormEntryScreenID-parametrit.

          Tutustutaanpa esimerkkiin, joka auttaa sinua ymmärtämään, miten näitä parametrejä ja ruutukulkua käytetään syötettävän datan välittämiseen.

          1. Avaa Apexiin perustuvan lomakkeiden viestintäkomponentin Kulku-formaatti.
            1. Napsauta Kulku-muodossa Datan hallinta määrittääksesi datamallin kaikille FormData-parametristä välitetyille syötetyille tiedoille.

              Esimerkiksi FormData-parametri tallentaa tämän syötettävän datan.

              {“FirstName”:“Albert”,“LastName”:“Costa”,“isStudent”:“true”}

            2. Jos haluat lisätä datamalliin kentän, napsauta Lisää kenttä ja määritä sen ominaisuudet.
              Suorita tämä vaihe jokaiselle FormData-parametrin kentälle. Luo rakenne valitsemalla kentälle Objekti-datatyyppi ja lisäämällä sisäkkäisiä kenttiä.
              Datamallilla on kolme määritettyä kenttää.
            3. Kun olet määrittänyt datamallin, tallenna se.
          2. Jos haluat käyttää Datamalli-kentän arvoa Kulku-ominaisuudessa, lisää dynaaminen viite.
            1. Avaa kulun muoto ja etsi ominaisuus, jolle haluat käyttää dynaamista viitettä.
              Voit esimerkiksi lisätä dynaamisen viitteen Tekstiosa-kenttään Tekstiosa-ruutuelementille.
            2. Valitse Tyyppi-kentästä Dynamic Reference.
            3. Valitse datamallin kenttä Valitse viitekenttä -osiosta.
              Dynaamisena viitteenä voidaan käyttää FirstName-syöttökenttää, LastName-syöttökenttää ja ruudussa 1 valittua eläintyyppiä.

              Dynaamiset viitteet voivat noutaa dataa datamallien kentistä tai ruudussa määritetyistä syöttökentistä.

            4. Esikatsele dynaamista viitettä esitysalueella.
              Dynaaminen viite noutaa dataa FirstName-syöttökentästä.
          3. Jos haluat välittää dataa viestintäkomponenttiin, luo ruutukulku.
            Ruutukulku voi kerätä viestintäistunnosta tietoja ja käyttää niitä Apexiin perustuvassa lomakkeiden viestintäkomponentissa. Alla on esimerkki siitä, miten tämä toimii.
            1. Määritä ruutukulkujen muuttujat.
              Muuttuja Arvo
              sessionId Tallentaa viestintäistunnon tietueen tunnuksen.
              initialData Tallentaa Apexiin perustuvan lomakkeen syöttötiedot. Tämän JSON-merkkijonon kenttien täytyy vastata datamalliin lisäämiäsi kenttien nimiä.
              initialScreenId Tallentaa Apexiin perustuvan lomakkeen alkuperäisen ruudun tunnuksen. Tämä on ensimmäinen ruutu, jonka viestintän loppukäyttäjä näkee.
              meuName Tallentaa viestintän loppukäyttäjän nimen.
              items Tämä kokoelmamuuttuja sisältää kohteiden luettelon.
            2. Lisää ruutukulkuun nämä toiminnot tässä järjestyksessä. Jos haluat noutaa dataa Salesforce-objektista, lisää Nouda tietueita -toiminto. Jos haluat kohdistaa arvoja ruutumuuttujiin, lisää Kohdistus-toiminto.
              Toiminto Kuvaus
              getSession Get Records -toiminto Hanki viestintäistunto istunnon tunnuksen perusteella. Voit noutaa asiaankuuluvia tietoja kyseisestä viestintäistunnosta. Tässä tapauksessa se noutaa ja tallentaa Id- ja MessagingEndUserId-kenttien arvot.
              getMEU Nouda tietueita -toiminto Hanki Messaging-käyttäjä-tietue MessagingEndUserId-arvon perusteella.
              setMEUName Assignment -toiminto Määritä meuName-muuttujaksi Messaging-käyttäjän nimi -kentän arvo Messaging-käyttäjä-tietueesta.
              getDynamicFlowItem Nouda tietueita -toiminto Hanki kaikki DynamicFlowItem-tietueet DynamicFlowItem-objektista tallentamalla tunnus-, ItemId__c- ja itemTitle__c-kentät items-kokoelmamuuttujaan.
              GenerateJson Apex -toiminto Muuntaa items- ja meuName-muuttujien syötetyn datan JSON-muotoon. JSON-objektin kentät kartoitetaan kulun datamallin kenttiin. Tämä toiminto perustuu Apex. Katso esimerkki tämän taulukon jälkeisestä Apex.
              setDatan kohdistus -toiminto Määritä InitialData-muuttujaksi luodun JSON-toiminnon arvo.

              Tämä Apex muuntaa rakenteellisen syötetyn datan — käyttäjän nimen ja Salesforce-tietueiden luettelon — yhdeksi JSON-merkkijonoksi. Tätä JSON-merkkijonoa käytetään sitten syöttötietojen välittämiseen Apexiin perustuvaan lomakkeiden viestintäkomponenttiin.

              public class FlowJSONBuilder {
              
                  // 1. Input parameters
                  public class FlowInput {
                      @InvocableVariable(label='User Name' required=true)
                      public String meuName;
              
                      // CHANGE: Use List<SObject> instead of List<DynamicFlowItems__c> to avoid compile error
                      @InvocableVariable(label='Flow Items' required=true)
                      public List<SObject> items; 
                  }
              
                  // 2. Output parameters
                  public class FlowOutput {
                      @InvocableVariable(label='Generated JSON')
                      public String jsonString;
                  }
              
                  // 3. Internal Wrapper classes
                  public class JSONStructure {
                      public String greeting;
                      public List<ItemWrapper> items;
                  }
              
                  public class ItemWrapper {
                      public String id;
                      public String title;
                  }
              
                  // 4. Main Method
                  @InvocableMethod(label='Generate Custom JSON' description='Builds the JSON string from Flow items')
                  public static List<FlowOutput> generateJson(List<FlowInput> requests) {
                      List<FlowOutput> outputs = new List<FlowOutput>();
              
                      for (FlowInput request : requests) {
                          FlowOutput output = new FlowOutput();
                          
                          JSONStructure jsonRoot = new JSONStructure();
                          jsonRoot.greeting = 'Hello ' + request.meuName + '!';
                          jsonRoot.items = new List<ItemWrapper>();
              
                          if (request.items != null) {
                              // Loop through generic SObjects
                              for (SObject genericRec : request.items) {
                                  // CAST the generic SObject to your specific Custom Object
                                  DynamicFlowItem__c rec = (DynamicFlowItem__c)genericRec;
                                  
                                  ItemWrapper item = new ItemWrapper();
                                  item.id = rec.itemId__c;     
                                  item.title = rec.itemTitle__c; 
                                  jsonRoot.items.add(item);
                              }
                          }
              
                          output.jsonString = JSON.serialize(jsonRoot);
                          outputs.add(output);
                      }
              
                      return outputs;
                  }
              }
            3. Lisää ruutukulkuun Ruututoiminto ja vedä Parannettu viesti -komponentti ruutuun.
              Parannettu viestintä -komponentti kutsuu dynaamista WhatsApp-kulkua ja tarjoaa syötettävää dataa.
            4. Määritä syötettävä data määrittämällä nämä Parannettu viesti -komponentin ominaisuudet alla kuvatulla tavalla.
              Ominaisuus Arvo
              Messaging-istunnon tunnus Valitse sessionId, ruutukulkujen muuttuja, joka sisältää istunnon tunnuksen.
              Viestintäkomponentin nimi Valitse luomasi Apexiin perustuvan lomakkeiden viestintäkomponentin nimi.
              Apex data Valitse initialData, ruutukulkujen muuttuja, joka sisältää syötetyt tiedot.
              Apex ruudun tunnus Valitse initialScreenId, ruutukulkujen muuttuja, joka sisältää alkuperäisen ruudun tunnuksen.

              Suorituksen aikana ruututoiminto kutsuu Apexiin perustuvaa lomakkeiden viestintäkomponenttia ja välittää siihen tämän syötettävän datan.

            5. Tallenna ja aktivoi ruutukulku.
              Parannettu viestintä -komponentti kutsuu dynaamista WhatsApp-kulkua ja tarjoaa syötettävää dataa.
          4. Jos haluat sallia palveluedustajan suorittaa ruutukulku, upota aktiivinen ruutukulku palvelukonsolin sivulle.
            Lisää esimerkiksi Kulku-komponentti Messaging-istunnon tietuesivulle.

            Viestintäistunnon tietuesivu sisältää kululle komponentin.

            Palveluedustaja voi käynnistää ruutukulkuja viestintäistunnon aikana sivulta napsauttamalla Seuraava.

            Palveluedustaja voi napsauttaa Lisää viesti lisätäkseen kulun viestintäkomponentin asiakkaan kanssa käytävään keskusteluun.

            Myyntiedustajat voivat napsauttaa Lisää viesti lähettääkseen sen asiakkaalle.

            Sen jälkeen palveluedustaja voi lähettää viestin asiakkaalle.

           
          Ladataan
          Salesforce Help | Article