Legge til tilpassede meldingskomponenter i en tredjeparts meldingskanal

Når skal tilpassede meddelelseskomponenter bruges

Bruk tilpassede meldingskomponenter når du betjener kunder via eldre Salesforce-chatdistribusjoner eller tredjeparts meldingskanaler – som WhatsApp, Apple-meldinger for firmaer, Facebook Messenger eller LINE – og du vil at agenten skal returnere rike, interaktive komponenter.

Den tilpassbare Meldinger-overflaten beholder de forhåndsdefinerte Meldinger-svarformatene (MessagingChoices, MessagingChoicesWithImages, MessagingRichLink og MessagingTimePicker) og lar deg legge til nye komponenter på toppen av dem.

Merk Hvis du bygger en Forbedret Chat v2-opplevelse (ECv2), bruker du i stedet Tilpassede Lightning. Hvis du bygger en helt ekstern nettklient, bruker du Tilpassede tilkoblinger.

Forhåndskrav

• Service Cloud-meldingskanal: Konfigurer den riktige Service Cloud-meldingskanalen for tidligere chat eller tredjepartskanalen før du konfigurerer den tilpassbare meldingstilkoblingen.
• Metadata API-versjon: Bruk versjon 66.0 eller nyere til henting og distribusjon.
• Bestående agent: En Agentforce-agent som bruker den filbaserte meldingstilkoblingen (SurfaceAction__Messaging).
• Meldinger-komponent: En distribuert meldingskomponent (som et skjema) der du kan referere til ID-en eller utviklernavnet i svarformatet.

Slik virker det

Standard Meldinger-overflaten leveres som en filbasert overflate (SurfaceAction__Messaging) som leveres med fire forhåndsdefinerte svarformater. Hvis du vil legge til en meldingskomponent, erstatter du den filbaserte overflaten med en tilpassbar AiSurface som refererer til de samme fire svarformatene pluss det nye tilpassede formatet.

Etter distribusjon bruker agenten de forhåndsdefinerte svarformatene for valg, rike lenker og tidsvelgere, og velger det tilpassede formatet når beskrivelsen og instruksjonene samsvarer med kundens forespørsel.

Viktig Ikke fjern eller rediger de fire forhåndsdefinerte svarformatene som er oppført i definisjonen av den tilpassbare overflaten. Du kan legge til nye svarformater, men ikke endre de eksisterende.

Konfigurere tilpassede meldingskomponenter

Organiser metadatafilene med denne strukturen, og fullfør deretter trinnene som følger.

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

Trinn 1: Hente agentens GenAiPlannerBundle

Hent agentens GenAiPlannerBundle via Metadata API. Bruk denne package.xml til henting.

<?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>

Hentingen returnerer GenAiPlannerBundle for agenten.

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

Trinn 2: Erstatt den filbaserte meldingsoverflaten

Finn plannerSurfaces-oppføringen med surface SurfaceAction__Messaging i GenAiPlannerBundle. Endre surface til et unikt utviklernavn for den tilpassbare Meldinger-overflaten (for eksempel CustomMessagingSurface). La surfaceType være satt til 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>

Denne endringen fjerner den filbaserte Meldinger-overflaten og legger til den tilpassbare Meldinger-overflaten på plass.

Trinn 3: Opprette den tilpassbare meldingsoverflaten

Opprett en aiSurfaces-mappe i distribusjonspakken. Opprett en fil med navnet {the_unique_dev_name_from_step_2}.aiSurface. Filens utviklernavn må samsvare med surface du angir i trinn 2.

Den tilpassbare overflaten må inkludere alle fire forhåndsdefinerte meldingsvarformater slik at standard meldingsvirkemåte fortsatt fungerer.

<?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>

For hver tilpassede meddelelseskomponent, du ønsker, at agenten skal bruge, skal du tilføje en responseFormats, der refererer til udviklernavnet på din tilpassede AiResponseFormat.

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

Trinn 4: Opprett det tilpassede AiResponseFormat

Opprett en aiResponseFormats-mappe. Opprett en fil med navnet {FormatDevName}.aiResponseFormat i den for hver tilpasset meldingskomponent.

Dette eksemplet definerer en skjemameldingskomponent. input-feltet refererer til en distribuert meldingskomponent etter utviklernavn (eller ID) ved bruk av MessageDefinition-malskjemaet. Angi input_strategy til use_template slik at agenten fyller ut malen i stedet for å generere rå JSON.

<?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>

Skjema for skjemamal

Bruk dette malskjemaet til skjemameldingskomponenter. input-feltet i AiResponseFormat må være en JSON-kodet streng med én linje. Den utvidede versjonen her vises bare for lesbarhet.

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

Trinn 5: Opprett package.xml-filen

Opprett en package.xml-fil ved roten av distribusjonspakken som deklarerer alle tre metadatatypene.

<?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>

Trinn 6: Distribuere

Distribuer metadataene med Salesforce CLI.

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

Du kan også distribuere med det foretrukne Metadata API-verktøyet. Hvis du distribuerer trinnvis, distribuerer du AiResponseFormat-enheter før AiSurface-enheter fordi overflaten refererer til svarformatene.

Se også

• Meldingskomponenttyper og -formater
• Forbedret Web Chat
• Konfigurere en tilpasset tilkobling
• Eksempler på svarformater for tilpassede tilkoblinger