Integration Hub

Met Integration Hub kunt u processen automatiseren door een gecentraliseerde bron te bieden voor het bouwen, beheren en uitvoeren van integraties van CXone in platforms van derden. U kunt gekoppelde sjablonen maken die voor meerdere integraties in dezelfde applicatie kunnen worden gebruikt. U kunt connectors in de bibliotheek Verbindingen ophalen en deze dan naar wens aanpassen. U kunt uw eigen sjablonen maken of u kunt een sjabloon uit de bibliotheek Verbindingen gebruiken en deze toevoegen aan Mijn verbindingen. Wanneer u deze toevoegt aan Mijn verbindingen, kunt u de integratie naar wens configureren.

Integration Hub starten in CXone

1. Klik in CXone op de app-kiezer en selecteer Automatisering & AI.

2. Klik op Integration Hub om het te openen.

Integration Hub starten in Desktop Studio

1. Desktop Studio starten

2. Klik in het tabblad Tools op Automatisering en AI.

3. Sleep de actie Auth verbinden naar een script.

4. Dubbelklik op Auth verbinden in het script om Integration Hub te openen.

Integration Hub starten in CXone Studio

1. Klik in CXone op de app-kiezer en ga naar Omnichannel routering > Studio.

2. Klik op Nieuw script en selecteer Generiek.

3. Klik op Acties .

4. Typ in de zoekbalk Connect Auth.

5. Sleep de actie Connect Auth naar het script.

6. Klik op Editor openen.

Een gekoppeld sjabloon maken

Een gekoppelde sjabloon is een integratieoverzicht met de beschrijvingen en vereisten voor het integreren met een applicatie van een externe partij.

Afbeelding weergeven

1. Start Integration Hub en klik op + Sjabloon toevoegen.

2. Voer in het tabblad Details Naam, Applicatie, Integratiemethode, Authenticatietype en Beschrijving in.

   Meer informatie over de velden in deze stap

   Veld	Details
   Naam	De naam die aan het sjabloon is gegeven. Deze naam is de naam die wordt getoond in de bibliotheek Verbindingen.
   Applicatie	De naam van de applicatie waarvoor dit sjabloon is gebouwd om mee te integreren.
   Integratiemethode	REST is momenteel de enige integratiemethode die wordt ondersteund.
   Authenticatietype	OAuth 2.0 en Geen auth zijn momenteel de enige ondersteunde authenticatietypen. Als u Geen auth selecteert, maakt u een integratie zonder authenticatie.
   Beschrijving	U kunt een beschrijving invoeren. Deze beschrijving is zichtbaar voor overige gebruikers wanneer zij het sjabloon selecteren in de bibliotheek Verbindingen.

3. U kunt een pictogram toevoegen door een afbeelding ernaartoe te slepen of door op Bestanden bladeren te klikken. Dit pictogram is de afbeelding die voor het sjabloon wordt weergegeven in de bibliotheek Verbindingen.
4. Selecteer op het tabblad Configuratie de methoden die worden ondersteund voor de applicatie die u probeert te integreren. De REST-werkwoorden die worden vermeld, verschillen in de applicatie van de externe partij waarmee u wilt integreren.

5. Klik op + Aangepaste koptekst toevoegen om de kopteksten te definiëren.

   U kunt opgeven dat de koptekst vereist moet zijn door Vereist? in te schakelen. U kunt op X klikken wanneer u de koptekst wilt verwijderen. Laat dit veld leeg als u geen kopteksten wilt toevoegen.

6. Klik op Opslaan om het aan de bibliotheek Verbindingen toe te voegen. Klik op Opslaan + Mijn verbindingen om het aan de bibliotheek Verbindingen en Mijn verbindingen toe te voegen.

Connectors beheren

Een connector is een opgeslagen sjabloon en kan naar wens worden aangepast.

1. Start Integration Hub en selecteer in de bibliotheek Verbindingen aan de linkerkant het sjabloon dat u wilt gebruiken en klik op + Mijn verbinding.

2. In het veld Connectornaam invoeren geeft u uw connector een naam. Deze naam wordt getoond in het venster Mijn verbindingen.

3. Klik op Opslaan.

4. Ga naar de connector in Mijn verbindingen.

5. Voer op het tabblad Authenticatie de URL, Methode en Kopteksten in. Indien u Geen auth als Authenticatietype hebt geselecteerd, beschikt u niet over het tabblad Authenticatie.

   Meer informatie over de velden in deze stap

   Veld	Details
   URL	De URL die voor het authenticatieverzoek wordt gebruikt.
   Methode	De specifieke REST-methode die in het authenticatieverzoek wordt gebruikt.
   Kopteksten	Verwijst naar de kopteksten die zijn gedefinieerd toen het sjabloon werd gemaakt. Als er geen koptekst werd gedefinieerd toen het sjabloon werd gemaakt, wordt er geen koptekst verwacht om te authenticeren met de applicatie. Aanvullende velden worden weergegeven wanneer kopteksten worden gedefinieerd.

6. Klik op het tabblad Inhoud en parameters op +Parameter zoekopdracht toevoegen en vul Naam zoekopdrachtparameter en Waarde zoekopdrachtparameter in. Dit zijn sleutelwaardeparen die met het authenticatieverzoek worden verzonden. Indien u Geen auth als Authenticatietype hebt geselecteerd, beschikt u niet over het tabblad Inhoud en parameters.

7. Kies bij het invoeren van de Inhoud een Mediatype uit de vervolgkeuzelijst.

   Meer informatie over de velden in deze stap

   Veld	Details
   ApplicationJson	Selecteer ApplicationJson in de vervolgkeuzelijst en voer de tekst voor uw Inhoud in. De inhoudstekst wordt samen met het authenticatieverzoek verstuurd.
   ApplicationJsonPatch	Selecteer ApplicationJsonPatch in de vervolgkeuzelijst en voer de tekst voor uw Inhoud in. De inhoudstekst wordt samen met het authenticatieverzoek verstuurd.
   FormURLEncoded	Selecteer FormURLEncoded in de vervolgkeuzelijst en klik op + Formulierparameter toevoegen. Voer de Parameternaam formulier en de Parameterwaarde formulier in. Dit zijn reeksen van sleutel/waarde-paren die bij het authenticatieverzoek worden verzonden. Dit mediatype stuurt aanvragen met veelvoorkomende URL-notaties.
   TextHtml	Selecteer TextHtml in de vervolgkeuzelijst en voer de tekst voor uw Inhoud in HTML in. De inhoudstekst wordt samen met het authenticatieverzoek verstuurd.
   TextPlain	Selecteer TextPlain in de vervolgkeuzelijst en voer de tekst voor uw Inhoud in. De inhoudstekst wordt samen met het authenticatieverzoek verstuurd.
   TextXml	Selecteer TextXml in de vervolgkeuzelijst en voer de tekst voor uw Inhoud in XML in. De inhoudstekst wordt samen met het authenticatieverzoek verstuurd.

8. Vul het veld Time-out ms* in op het tabblad Configuratie. Dit veld heeft betrekking op de tijd die moet zijn verstreken voordat het product een foutbericht over time-out verzendt. De tijd wordt uitgedrukt in milliseconden.

9. Klik in het tabblad Geheimen + Geheim toevoegen en voer een Naam van geheim en Waarde van geheim in. Dit zijn sleutelwaardeparen die zijn versleuteld en waarnaar kan worden verwezen binnen andere onderdelen van de connector, zoals zoekopdrachtparameters, kopteksten of inhoud. Verwijs naar geheimen door dubbele haakjes te gebruiken.

10. In het tabblad Verzoeken kunt u zoeken naar bestaande verzoeken door het veld Verzoeken zoeken te gebruiken. Selecteer het selectievakje naast het verzoek om het te gebruiken met de connector. Klik op OK. Eenmaal geselecteerd worden de eigenschappen van die CONNECTREQUEST Studio-actie automatisch ingevuld. Wanneer er geen bestaande verzoeken zijn, moet u verzoeken maken.

11. Klik op Opslaan.

12. U kunt op Testen klikken om de authenticatie van een connector met een applicatie van een externe partij te testen.

Verzoeken maken

Verzoeken zijn sets webservice-oproepen die voor bepaalde doeleinden zijn geconfigureerd. Deze worden onder de connector gemaakt. Een connector ondersteunt in totaal 20 verzoeken; 10 actief en 10 inactief. Wanneer u al verzoeken hebt gemaakt en geen verzoeken meer hoeft te maken, kunt u deze stappen overslaan.

1. Start Integration Hub en selecteer een verbinding in Mijn verbindingen aan de linkerkant.

2. Ga naar het tabblad Verzoeken en klik op + Verzoek toevoegen.

3. Voer een Verzoeknaam in.

4. Selecteer een Triggertype:

   • Handmatig: een handmatige trigger wordt rechtstreeks via de Integration Hub-applicatie getest en heeft een consistente set met data die niet wordt gewijzigd. Dit triggertype kan worden getest door op Testen in de Integration Hub-applicatie te klikken.

   • Studio: een Studio-trigger wordt getest door de Studio-applicatie met de actie CONNECTREQUEST. Deze trigger heeft een dynamische set met data omdat deze input ontvangt van CXone ACD en IVR Interactive Voice Response: een telefoonmenu waarmee bellers via telefoontoetsen en/of gesproken opdrachten keuzes kunnen maken en/of informatie kunnen invoeren.. Dit triggertype kan alleen worden getest in Studio.

5. Configureer het verzoek afhankelijk van het Triggertype dat u hebt geselecteerd.

   • Bij Handmatig geeft u URL, Methode, Kopteksten, Parameters zoekopdracht en Mediatype op.

     Meer informatie over de velden in deze stap

     Veld	Details
     URL	De URL die voor het authenticatieverzoek wordt gebruikt.
     Methode	De specifieke REST-methode die in het authenticatieverzoek wordt gebruikt.
     Kopteksten	Klik op + Koptekst toevoegen en voer de Naam koptekst en Koptekstwaarde in.
     Parameters zoekopdracht	Klik op +Parameter zoekopdracht toevoegen en voer de Parameternaam zoekopdracht en Parameterwaarde zoekopdracht in. Dit zijn sleutelwaardeparen die met het authenticatieverzoek worden verzonden.
     Mediatype	ApplicationJson: Selecteer ApplicationJson in de vervolgkeuzelijst en voer de tekst voor uw Inhoud in. De inhoudstekst wordt samen met het authenticatieverzoek verstuurd. ApplicationJsonPatch: Selecteer ApplicationJsonPatch in de vervolgkeuzelijst en voer de tekst voor uw Inhoud in. De inhoudstekst wordt samen met het authenticatieverzoek verstuurd. FormURLEncoded: Selecteer FormURLEncoded in de vervolgkeuzelijst en klik op + Formulierparameter toevoegen. Voer de Parameternaam formulier en de Parameterwaarde formulier in. Dit zijn sleutelwaardeparen die met het authenticatieverzoek worden verzonden. Dit mediatype stuurt aanvragen met veelvoorkomende URL-notaties. Hiermee kunt u bovendien verwijzen naar Geheimen. Het mediatype is ook beschikbaar in handmatige en door studio getriggerde aanvragen. TextHtml: Selecteer TextHtml in de vervolgkeuzelijst en voer de tekst voor uw Inhoud in HTML in. De inhoudstekst wordt samen met het authenticatieverzoek verstuurd. TextPlain: Selecteer TextPlain in de vervolgkeuzelijst en voer de tekst voor uw Inhoud in. De inhoudstekst wordt samen met het authenticatieverzoek verstuurd. TextXml: Selecteer TextXml in de vervolgkeuzelijst en voer de tekst voor uw Inhoud in XML in. De inhoudstekst wordt samen met het authenticatieverzoek verstuurd.

   • Voor Studio moet een JSON-pakket worden gemaakt om de data op te geven die nodig zijn om het verzoek te kunnen maken.

     Zie een voorbeeld van een verzoekpayload

     {

     "URL": "[[INSTANCEURI]]/INCONTACTAPI/SERBICES/V26.0/AGENTS",

     "HTTPMETHOD": "POST",

     "HEADERS": [

     {

     "CONTENT-TYPE": "APPLICATION/X-WWW-FORM-URL-ENCODED",

     "AUTHORIZATION": "BEARER[[BEARERTOKEN]]"

     }

     ],

     "QUERYPARAMETERS": [

     {

     "ANI": "[[ANI]]",

     "ACCOUNTID": "123456"

     }

     ],

     "BODY": [

     {

     "ANI": "[[ANI]]",

     "ACCOUNTID": "123456",

     "ACCOUNTNAME": "TESTACCOUNT"

     }

     ]

     }

6. In de rechterbovenhoek selecteert u of het verzoek Actief of Inactief is.

7. Klik op Bevestigen.

Wanneer u de integratie hebt geconfigureerd, klikt op het vinkje naast de integratie in de lijst Mijn verbindingen. Vervolgens selecteert u Nee of Ja om deze te gebruiken met de Studio-actie.