GETRICHMESSAGE

Geeft rijk bericht JSON door naar de digitale AskCaller -actie of TExtMsg -actie.  Hiermee kunt u rijke berichtsjablonen gebruiken die zijn gemaakt op de pagina Digitaal contactpunt in ACD in uw scripts in plaats van de JSON te bouwen in het script.

Afhankelijkheden

• Deze actie vereist Digital Experience.
• Voordat u met digitale scripts gaat werken, is het van belang dat u de verschillen kent tussen traditionele ACD-scripts en digitale scripts.
• Moet worden gebruikt met een van de volgende acties: AskCaller of TExtMsg.
• Plaats GETRICHMESSAGE vóór AskCaller of TExtMsg in uw script.

• Ondersteuning voor inhoudstype rijke berichten, verschilt per kanaal, zoals weergegeven in de onderstaande lijst.

  Meer informatie

  De volgende tabel toont de soorten rijke content Elementen in digitale berichten, zoals buttons, afbeeldingen, menu's en optiekiezers. die beschikbaar zijn voor elk digitaal kanaal. Bepaalde rijke content gebruikt TORM (Truly Omnichannel Rich Messaging) en kan worden geconfigureerd met Instellingen voor rijke berichten. Rijke content die niet door TORM wordt ondersteund, kan worden geconfigureerd via chat, e-mail, Apple Messages for Business en WhatsApp.

  Kanalen die niet worden vermeld, bieden momenteel geen ondersteuning voor rijke content. Alle rijke content die via andere kanalen wordt verzonden, wordt als platte tekst aangeleverd.

  	Adaptieve kaarten	HTML en opmaaktekst	Rijke link	Snelle antwoorden	Lijstkiezer	Tijdkiezer	Formulierbericht
  Apple Messages for Business
  Digitaal Chat
  E-mail				Gebruikt fallback-tekst
  Facebook Messenger
  WhatsApp
  Google Business Messages

  Ondersteund:

  Niet ondersteund:

  Deze rijke content is beschikbaar voor gebruik door API's, bots, virtuele agents en live agents. Niet alle rijke content wordt echter ondersteund voor gebruik door live (menselijke) agents. In de volgende tabel wordt aangegeven welke rijke content in het gedeelte Klantenkaart in MAX zichtbaar is voor live agents. Rijke content die niet door TORM wordt ondersteund, is voor live agents toegankelijk via Berichtsjablonen > kies sjabloon. Rijke content die wel door TORM wordt ondersteund, is voor live agents toegankelijk via Rijke berichten > Rijk bericht.

  	Adaptieve kaarten	HTML en opmaaktekst	Rijke link	Snelle antwoorden	Lijstkiezer	Tijdkiezer	Formulierbericht
  Apple Messages for Business
  Digitaal Chat
  E-mail
  Facebook Messenger
  WhatsApp
  Google Business Messages

  Ondersteund:

  Niet ondersteund:

• Maak rijke berichtsjablonen die moeten worden gebruikt met deze actie op de pagina Digitale contactpunten in CXone. U kunt sjablonen maken voor lijstkiezers, tijdkiezers, rijke koppelingen en snelle antwoorden. Als u andere rijke media moet gebruiken, kunt u GETRICHMESSAGE niet gebruiken. In plaats daarvan moet u de JSON bouwen in een Snippet-actie en onmiddellijk doorgeven naar AskCaller of TExtMsg. Zie het gedeelte Afhankelijkheden in de online help voor die acties voor meer informatie.

Ondersteunde scripttypen

Digitaal

Soortgelijke acties vergelijken

De volgende acties hebben vergelijkbare functies, maar met enkele belangrijke verschillen:

• AskCaller: vraag informatie van een contact op een digitaal op chat gebaseerd kanaal. Kan inhoud van rijke berichten Elementen in digitale berichten, zoals buttons, afbeeldingen, menu's en optiekiezers. weergeven.
• GetRichMessage: haalt rijke berichtsjablonen op van de configuraties van het kanaal in CXone
• Textmsg: verzendt een op tekst gebaseerd bericht naar een contact. Kan inhoud van rijke berichten weergeven.

Invoereigenschappen

Deze eigenschappen definiëren gegevens die de actie gebruikt bij het uitvoeren.

Vertakking	Beschrijving
bijschrift toe	Voer een korte woordgroep in die deze actie in het script uniek identificeert. Het bijschrift verschijnt op het scriptcanvas onder het actiepictogram. The default is the action name.
channelID	Selecteer het digitale kanaal dat dit script gebruikt voor het verzenden van berichten.

Uitvoereigenschappen

Deze eigenschappen bevatten variabelen die gegevens bevatten die worden geretourneerd na het uitvoeren van de actie. Ze zijn beschikbaar voor referentie en gebruik wanneer de actie wordt voltooid.

Vertakking	Beschrijving
resultSet	Bevat de JSON die is geretourneerd van CXone Geef de inhoud van deze variabele door naar Askcaller of TExtmsg als een JSON-string.

Resultaatvertakkingsvoorwaarden

Met Resultaatvertakkingsvoorwaarden kunt u vertakkingen maken in uw script om verschillende resultaten te behandelen wanneer de actie wordt uitgevoerd.

Voorwaarde	Beschrijving
Default	Het pad dat altijd wordt gevolgd, behalve als het script voldoet aan een voorwaarde die vereist dat het een van de andere vertakkingen volgt. Dit pad wordt ook gevolgd als de andere vertakkingen van de actie niet zijn gedefinieerd.
OnError	Het pad dat wordt gevolgd als de actie niet correct is uitgevoerd. Als er bijvoorbeeld een onverwacht probleem is, zoals een slechte verbinding, syntaxfouten enz. De _ERR-variabele, met één onderstrepingsteken, moet een beknopte beschrijving van het probleem bevatten.
OnSucess	Het pad dat wordt gevolgd als de actie zonder fouten is voltooid en eventuele API-aanroepen of geretourneerde gegevens succesvol waren (2xx responscodes).

Vereiste fragmentcode

Deze actie kan een Snippet actie vereisen met code die de rijke mediasjablonen behandelen die de GETRICHMESSAGE-actie retourneert vanaf het digitale contactpunt. Als het contactpunt slechts één sjabloon heeft, hebt u geen snippetcode nodig. U kunt de variabele gebruiken die in de resultId-eigenschap is opgegeven. Voor contactpunten die meer dan één sjabloon hebben, hebt u een snippetcode nodig.

1. Maak een sjabloon op de pagina Digitale contactpunten in de ACD-applicatie en wijs die toe aan het contactpunt waarmee u het wilt gebruiken. U hebt mogelijk hulp nodig van een CXone-beheerder om deze stap te voltooien.

2. Maak een script met het digitale mediatype.

3. Voeg een GETRICHMESSAGE -actie toe en ofwel een ASKCALLER -actie of een TeXTMSG-actie. Als het contactpunt meer dan één sjabloon heeft, hebt u ook een SNIPPET -actie nodig.
4. Configureer de ChannelId-eigenschap in GETRICHMESSAGE met het contactpunt waaraan u de sjabloon hebt toegewezen.
5. Voeg de geschikte code toe aan de SNIPPET-actie:

   • Als u slechts één sjabloon hebt of als u slechts één sjabloon wilt verzenden met dit script, gebruikt u code zoals:

     DYNAMIC json1 
     ASSIGN json1.data[1] = resultset.data[1]

   • Als u meerdere sjablonen hebt en er meer dan één wilt verzenden met dit script, gebruikt u code zoals:

     DYNAMIC json1
     DYNAMIC json2
     DYNAMIC json3
     				 
     ASSIGN json1.data[1] = resultset.data[1]
     ASSIGN json2.data[1] = resultset.data[2]
     ASSIGN json3.data[1] = resultset.data[3]

6. Wijzig het indexnummer dat de sjabloon identificeert die u wilt verzenden. In de voorbeeldcode van de vorige stap, zou u de indexnummers wijzigen in de resultset.data[x]-variabele. Wijzig de index niet in de variabele waaraan u de sjabloon toewijst. In de voorbeeldcode is de variabele jsonY.data[Z], en zou u Y kunnen wijzigen, maar niet Z. Elke jsonY-variabele bevat één sjabloon.
7. Wijzig de namen van de variabelen als u dat wenst. Als u dat doet, wijzigt u de namen van de variabelen zoals nodig in de andere acties in het script. resultSet is bijvoorbeeld de standaardnaam van de variabele in de eigenschap resultSet van GETRICHMESSAGe. De jsonY-variabelen worden gebruikt in de eigenschap Bericht van AskCaller en Textmsg.
8. Configureer AskCaller of Textmsg: 
   1. Stel de eigenschap MessageFormat in op JSON.
   2. Configureer Bericht met de naam van de variabele die de JSON van de sjabloon bevat. Dit moet worden verzonden als een JSON-string. In dit veld kunt u het vervangen van een variabele gebruiken. Als u dat doet, voegt u de code toe aan een Snippet om de sjabloon te kiezen die moet worden verzonden en de juiste variabele door te geven.
   3. Configureer andere eigenschappen van de acties zoals nodig, inclusief het verbinden van de vertakkingen. Raadpleeg de online help voor de actie ASKCALLER  of TeXTMSG .

Voorbeeld van een script

Dit voorbeeld toont de GETRICHMESSAGE-actie die verbonden is met een SNIPPET-actie die verbonden is met TeXTMSG. Dit kan ook worden aangesloten op ASKCALLER. Wanneer het script wordt uitgevoerd, haalt GETRICHMESSAGE de beschikbare rijke tekstsjablonen op voor het digitale kanaal dat is opgegeven in channelId. Ze worden opgeslagen in de variabele die is opgegeven in de resultId-eigenschap. In dit voorbeeld is de variabele resultId. De snippetcode bevat een dynamische gegevensobject dat een specifieke JSON van een rijke tekstsjabloon zal bevatten en geeft deze door aan TeXTMSG.

Download dit script.