Føj tilpassede meddelelseskomponenter til en meddelelseskanal fra tredjepart

Hvornår skal der bruges tilpassede meddelelseskomponenter

Brug tilpassede meddelelseskomponenter, når du betjener kunder gennem forældede Salesforce-chatimplementeringer eller tredjepartsmeddelelseskanaler – f.eks. WhatsApp, Apple Messages for Business, Facebook Messenger eller LINE – og du ønsker, at agenten returnerer avancerede interaktive komponenter.

Overfladen Meddelelser, der kan tilpasses, bevarer de køreklare meddelelsessvarformater (MessagingChoices, MessagingChoicesWithImages, MessagingRichLink og MessagingTimePicker) og giver dig mulighed for at tilføje nye komponenter oven på dem.

Bemærk Hvis du opbygger en forbedret Chat v2-oplevelse (ECv2), skal du i stedet bruge tilpassede Lightning. Hvis du opbygger en fuldt ekstern webklient, skal du bruge tilpassede forbindelser.

Forudsætninger

• Service Cloud-meddelelseskanal: Konfigurer den relevante Service Cloud-meddelelseskanal for den ældre chat eller din tredjepartskanal, før du opsætter den tilpassede meddelelsesforbindelse.
• Metadata API-version: Brug version 66.0 eller nyere til hentning og implementering.
• Eksisterende agent: En Agentforce-agent, der bruger den filbaserede meddelelsesforbindelse (SurfaceAction__Messaging).
• Meddelelseskomponent: En implementeret meddelelseskomponent (f.eks. en formular), hvis id eller udviklernavn du kan henvise til i svarformatet.

Sådan fungerer det

Standardoverfladen Meddelelser leveres som en filbaseret overflade (SurfaceAction__Messaging), der leveres med fire indbyggede svarformater. Hvis du vil tilføje en meddelelseskomponent, skal du erstatte den filbaserede oversigt med en tilpasset AiSurface, der henviser til de samme fire svarformater plus dit nye tilpassede format.

Efter implementeringen bruger agenten de indbyggede svarformater til valg, avancerede links og tidsvælgere og vælger dit tilpassede format, når dets beskrivelse og instruktioner matcher kundens anmodning.

Vigtigt Fjern eller rediger ikke de fire køreklare svarformater, der er angivet i definitionen af overfladen, der kan tilpasses. Du kan tilføje nye svarformater, men rediger ikke de eksisterende.

Opsæt tilpassede meddelelseskomponenter

Organiser dine metadatafiler ved brug af denne struktur, og fuldfør derefter de trin, der følger.

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

Trin 1: Hent agentens GenAiPlannerBundle

Hent agentens GenAiPlannerBundle gennem Metadata API. Brug denne package.xml til hentning.

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

Hent returnerer GenAiPlannerBundle for din agent.

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

Trin 2: Erstat den filbaserede meddelelsesoversigt

I din GenAiPlannerBundle skal du finde den plannerSurfaces, hvis surface er SurfaceAction__Messaging. Skift surface til et entydigt udviklernavn for din meddelelsesoversigt, der kan tilpasses (f.eks. CustomMessagingSurface). Lad surfaceType være indstillet 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 ændring fjerner den filbaserede meddelelsesoverflade og vedhæfter din meddelelsesoverflade, der kan tilpasses, på stedet.

Trin 3: Opret den meddelelsesoversigt, der kan tilpasses

Opret en aiSurfaces i din implementeringspakke. I den skal du oprette en fil ved navn {the_unique_dev_name_from_step_2}.aiSurface. Filens udviklernavn skal matche den surface, du angav i trin 2.

Den tilpassede oversigt skal indeholde alle fire indbyggede meddelelsessvarformater, så standardadfærden i Meddelelser fortsætter med at fungere.

<?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 tilpasset meddelelseskomponent, som agenten skal bruge, skal du tilføje en responseFormats, der henviser til udviklernavnet på din tilpassede AiResponseFormat.

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

Trin 4: Opret den tilpassede AiResponseFormat

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

Dette eksempel definerer en formularmeddelelseskomponent. Feltet input refererer til en implementeret meddelelseskomponent efter udviklernavn (eller id) ved brug af MessageDefinition-skabelonskemaet. Indstil input_strategy til use_template, så agenten udfylder skabelonen i stedet for at 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>

Formularskabelonskema

Brug dette skabelonskema til formularmeddelelseskomponenter. input feltet på AiResponseFormat skal være en enkelt linje JSON-kodet streng. Den udvidede version her vises kun af hensyn til læsbarheden.

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

Trin 5: Opret package.xml-filen

Opret en package.xml-fil ved roden af din implementeringspakke, der erklærer alle tre metadatatyper.

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

Trin 6: Implementer

Implementer metadataene med Salesforce CLI.

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

Du kan også implementere med dit foretrukne Metadata API-værktøj. Hvis du implementerer trinvist, skal du implementere AiResponseFormat-enheder før AiSurface-enheder, da visningen refererer til svarformaterne.

Se også

• Meddelelseskomponenttyper og formater
• Forbedret webchat
• Opsæt en tilpasset forbindelse
• Eksempler på svarformat for tilpassede forbindelser