Mukautettujen viestintäkomponenttien lisääminen kolmannen osapuolen viestintäkanavaan

Milloin käyttää mukautettuja Messaging-komponentteja?

Käytä mukautettuja viestintäkomponentteja, kun palvelet asiakkaita Salesforcen vanhojen chat-käyttöönottojen tai kolmansien osapuolten viestintäkanavien kautta — kuten WhatsApp, Apple Messages for Business, Facebook Messenger tai LINE — ja haluat agentin palauttavan muotoiltuja, interaktiivisia komponentteja.

Mukautettava Messaging-pinta-ala säilyttää käyttövalmiit Messaging-vastausformaatit (MessagingChoices, MessagingChoicesWithImages, MessagingRichLink ja MessagingTimePicker) ja sallii sinun lisätä niiden päälle uusia komponentteja.

Huomautus Jos olet rakentamassa parannettua Chat-versiota 2 (ECv2), käytä sen sijaan mukautettuja Lightning. Jos olet rakentamassa täysin ulkoista verkkosovellusta, käytä mukautettuja yhteyksiä.

Edellytykset

• Service Cloud -viestintäkanava: Määritä asianmukainen Service Cloud -viestintäkanava vanhalle chatille tai kolmansien osapuolten kanavalle ennen mukautettavan viestintäyhteyden määrittämistä.
• Metadata API -versio: Käytä noutamiseen ja käyttöönottoon versiota 66.0 tai uudempaa.
• Olemassa oleva agentti: Agentforce-agentti, joka käyttää tiedostoon perustuvaa viestintäyhteyttä (SurfaceAction__Messaging).
• Messaging-komponentti: Käytössä oleva viestintäkomponentti (kuten lomake), jonka tunnukseen tai kehitysnimeseen voit viitata vastauksen muodossa.

Miten se toimii?

Oletusarvoinen Messaging-pinta-ala toimitetaan tiedostoihin perustuvana pinnana (SurfaceAction__Messaging), joka tarjoaa neljä käyttövalmista vastausformaattia. Jos haluat lisätä viestintäkomponentin, korvaa tiedostopohjainen pinta mukautetulla AiSurface, joka viittaa samoihin neljään vastausformaattiin sekä uuteen mukautettuun muotoosi.

Käyttöönoton jälkeen agentti käyttää käyttövalmiita vastausformaatteja valintavaihtoehdoille, muotoilluille linkeille ja ajan valitsimille ja valitsee mukautetun formaattisi, kun sen kuvaukset ja ohjeet vastaavat asiakkaan pyyntöä.

Tärkeää Älä poista tai muokkaa neljää käyttövalmista vastausformaattia, jotka sisältyvät mukautettavaan pinta-alan määritelmään. Voit lisätä uusia vastausformaatteja, mutta älä muokata olemassa olevia.

Mukautettujen Messaging-komponenttien määrittäminen

Organisoi metadatatiedostosi käyttämällä tätä rakennetta ja suorita sitten seuraavat vaiheet.

metadataToDeploy/
├── package.xml
├── aiResponseFormats/
│   └── Messaging_Form_Messaging_Component.aiResponseFormat
├── aiSurfaces/
│   └── {CustomMessagingSurface}.aiSurface
└── genAiPlannerBundles/
    └── {YourAgentDevName}.genAiPlannerBundle

Vaihe 1: Agentin GenAiPlannerBundlen noutaminen

Nouda agenttisi GenAiPlannerBundle Metadata API:n kautta. Käytä tätä package.xml noudolle.

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>*</members>
        <name>GenAiPlannerBundle</name>
    </types>
    <version>66.0</version>
</Package>

Nouda palauttaa agenttisi GenAiPlannerBundle-arvon.

metadataToDeploy/
└── genAiPlannerBundles/
    └── {YourAgentDevName}.genAiPlannerBundle

Vaihe 2: Tiedostoon perustuvan Messaging-ominaisuuden korvaaminen

Etsi GenAiPlannerBundle-kentästä plannerSurfaces-arvo, jonka surface-arvo on SurfaceAction__Messaging. Muuta surface käyttämään yksilöllistä kehitysnimeä mukautettavalle Messaging-ympäristöllesi (esimerkiksi CustomMessagingSurface). Jätä surfaceType-arvoksi Messaging.

<?xml version="1.0" encoding="UTF-8"?>
<GenAiPlannerBundle xmlns="http://soap.sforce.com/2006/04/metadata">
    <!-- Other agent configuration -->

    <plannerSurfaces>
        <adaptiveResponseAllowed>true</adaptiveResponseAllowed>
        <callRecordingAllowed>false</callRecordingAllowed>
        <surface>CustomMessagingSurface</surface>
        <surfaceType>Messaging</surfaceType>
    </plannerSurfaces>
</GenAiPlannerBundle>

Tämä muutos irrottaa tiedostoihin perustuvan Messaging-pinta-alan ja liittää mukautettavan Messaging-pinta-alan sen tilalle.

Vaihe 3: Mukautettava Messaging-pinta-alan luominen

Luo käyttöönottopaketissasi aiSurfaces-kansio. Luo siihen tiedosto nimeltään {the_unique_dev_name_from_step_2}.aiSurface. Tiedoston kehitysnimen täytyy vastata vaiheessa 2 määrittämääsi surface-arvoa.

Mukautettavan näytön täytyy sisältää kaikki neljä käyttövalmista Messaging-vastausformaattia, jotta Messaging-vakiotoiminnot toimivat edelleen.

<?xml version="1.0" encoding="UTF-8"?>
<AiSurface xmlns="http://soap.sforce.com/2006/04/metadata">
    <description>Customizable Messaging connection</description>
    <instructions>
        <instruction>Do not use any of the SURFACE_ACTION__* response formats when none of the instructions below are met.</instruction>
        <sortOrder>1</sortOrder>
    </instructions>
    <instructions>
        <instruction>Do not use the below instructions when the response contains more than 10 choices.</instruction>
        <sortOrder>2</sortOrder>
    </instructions>
    <instructions>
        <instruction>Do not use any of the SURFACE_ACTION__Messaging* type formatting when the response contains only a single, text-only choice and does not include images or URLs.</instruction>
        <sortOrder>3</sortOrder>
    </instructions>
    <masterLabel>Messaging</masterLabel>
    <responseFormats>
        <enabled>true</enabled>
        <responseFormat>SurfaceAction__MessagingChoices</responseFormat>
    </responseFormats>
    <responseFormats>
        <enabled>true</enabled>
        <responseFormat>SurfaceAction__MessagingChoicesWithImages</responseFormat>
    </responseFormats>
    <responseFormats>
        <enabled>true</enabled>
        <responseFormat>SurfaceAction__MessagingRichLink</responseFormat>
    </responseFormats>
    <responseFormats>
        <enabled>true</enabled>
        <responseFormat>SurfaceAction__MessagingTimePicker</responseFormat>
    </responseFormats>
    <source>SurfaceAction__Messaging</source>
    <surfaceType>Messaging</surfaceType>
</AiSurface>

Lisää jokaiselle mukautetulle viestintäkomponentille, jota haluat agentin käyttävän, responseFormats-arvo, joka viittaa mukautetun AiResponseFormat kehittäjänimeen.

<responseFormats>
    <enabled>true</enabled>
    <responseFormat>Messaging_Form_Messaging_Component</responseFormat>
</responseFormats>

Vaihe 4: Mukautetun AiResponseFormatin luominen

Luo aiResponseFormats-kansio. Luo jokaiselle mukautetulle viestintäkomponentille tiedosto nimeltään {FormatDevName}.aiResponseFormat.

Tämä esimerkki määrittää lomakkeiden viestintäkomponentin. input-kenttä viittaa käyttöönotettuun viestintäkomponenttiin kehittäjän nimen (tai tunnuksen) perusteella käyttämällä MessageDefinition-mallin skeemaa. Määritä input_strategy arvoon use_template, jotta agentti täyttää mallin sen sijaan, että hän luo raakoja JSON-tiedostoja.

<?xml version="1.0" encoding="UTF-8"?>
<AiResponseFormat xmlns="http://soap.sforce.com/2006/04/metadata">
    <description>A response action. Use this when the user wants to create a case. The user is presented with rich UI.</description>
    <input>{"template":{"messageType":"FormMessage","id":"{{ uuid4() }}","form":{"formatType":"MessageDefinition","messageDefinitionNameOrId":"Create_Case_Form"}},"input_strategy":"use_template"}</input>
    <instructions>
        <instruction>Always use this response format to create a case.</instruction>
        <sortOrder>1</sortOrder>
    </instructions>
    <masterLabel>Messaging Form Messaging Component</masterLabel>
</AiResponseFormat>

Lomakemallin skeema

Käytä tätä mallin skeemaa lomakkeiden viestintäkomponenteille. AiResponseFormat input-kentän täytyy olla yhden rivin JSON-koodattu merkkijono. Tässä laajennettu versio näytetään vain luettavuutta varten.

{
  "template": {
    "messageType": "FormMessage",
    "id": "{{ uuid4() }}",
    "form": {
      "formatType": "MessageDefinition",
      "messageDefinitionNameOrId": "Create_Case_Form"
    }
  },
  "input_strategy": "use_template"
}

Vaihe 5: luo package.xml-tiedosto

Luo käyttöönottopaketin juuripolulle package.xml-tiedosto, joka esittää kaikki kolme metadatatyyppiä.

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>*</members>
        <name>AiResponseFormat</name>
    </types>
    <types>
        <members>*</members>
        <name>AiSurface</name>
    </types>
    <types>
        <members>*</members>
        <name>GenAiPlannerBundle</name>
    </types>
    <version>66.0</version>
</Package>

Vaihe 6: Käyttöönotto

Ota metadata käyttöön Salesforce CLI:lla.

sf project deploy start --manifest metadataToDeploy/package.xml

Voit ottaa sen käyttöön myös haluamallasi Metadata API -työkalulla. Jos otat käyttöön vaiheittain, ota käyttöön AiResponseFormat-entiteetit ennen AiSurface-entiteettejä, koska pinta viittaa vastausten formaatteihin.

Katso myös

• Viestintäkomponenttien tyypit ja muodot
• Parannettu verkko-chat
• Mukautetun yhteyden määrittäminen
• Esimerkkivastausmuodot mukautetuille yhteyksille