Olet tässä:
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. | |
Tätä artikkelia sovelletaan:
|
Parannetut WhatsApp-kanavat, yhtenäistetty WhatsApp |
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ä.
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.
-
Avaa Apexiin perustuvan lomakkeiden viestintäkomponentin Kulku-formaatti.
-
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”} -
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ä.

- Kun olet määrittänyt datamallin, tallenna se.
-
Napsauta Kulku-muodossa Datan hallinta määrittääksesi datamallin kaikille FormData-parametristä välitetyille syötetyille tiedoille.
-
Jos haluat käyttää Datamalli-kentän arvoa Kulku-ominaisuudessa, lisää dynaaminen viite.
-
Avaa kulun muoto ja etsi ominaisuus, jolle haluat käyttää dynaamista viitettä.
Voit esimerkiksi lisätä dynaamisen viitteen Tekstiosa-kenttään Tekstiosa-ruutuelementille.
- Valitse Tyyppi-kentästä Dynamic Reference.
-
Valitse datamallin kenttä Valitse viitekenttä -osiosta.

Dynaamiset viitteet voivat noutaa dataa datamallien kentistä tai ruudussa määritetyistä syöttökentistä.
-
Esikatsele dynaamista viitettä esitysalueella.

-
Avaa kulun muoto ja etsi ominaisuus, jolle haluat käyttää dynaamista viitettä.
-
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.
-
Määritä ruutukulkujen muuttujat.
Muuttuja Arvo sessionIdTallentaa viestintäistunnon tietueen tunnuksen. initialDataTallentaa Apexiin perustuvan lomakkeen syöttötiedot. Tämän JSON-merkkijonon kenttien täytyy vastata datamalliin lisäämiäsi kenttien nimiä. initialScreenIdTallentaa Apexiin perustuvan lomakkeen alkuperäisen ruudun tunnuksen. Tämä on ensimmäinen ruutu, jonka viestintän loppukäyttäjä näkee. meuNameTallentaa viestintän loppukäyttäjän nimen. itemsTämä kokoelmamuuttuja sisältää kohteiden luettelon. -
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- jameuName-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; } } -
Lisää ruutukulkuun Ruututoiminto ja vedä Parannettu viesti -komponentti ruutuun.

-
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.
-
Tallenna ja aktivoi ruutukulku.

-
Määritä ruutukulkujen muuttujat.
-
Jos haluat sallia palveluedustajan suorittaa ruutukulku, upota aktiivinen ruutukulku palvelukonsolin sivulle.
Lisää esimerkiksi Kulku-komponentti Messaging-istunnon tietuesivulle.

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.

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



