GETRICHMESSAGE

Deze Help-pagina is bedoeld voor CXone Studio. Deze informatie is ook beschikbaar voor Desktop Studio.

Een tekstballon met lijnen erin en een pijl die omlaag wijst.

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.

  • 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:

Invoereigenschappen

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

Vertakking

Beschrijving

Voeg bijschrift toe

Voer een korte woordgroep in die deze actie in het script uniek identificeert. Het bijschrift verschijnt op het scriptcanvas onder het actiepictogram.

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.

Fout

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.

Geslaagd

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 Result Set-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 .

Script voorbeeld

Dit is een voorbeeld dat toont hoe deze actie kan worden gebruikt in scripts. Het is niet bedoeld als een compleet script. Het kan nodig zijn het script verder te bewerken.

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 Result Set-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.