inQuba Journey (Vorschau)
Veröffentlichen Sie daten nahtlos in die inQuba Customer Journey-APIs und verfolgen Sie Ihre Kundenreisen effektiv.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | inQuba Support |
| URL | https://inquba.com |
| support@inquba.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Inquba Customer Intelligence Pty Ltd |
| Webseite | https://inquba.com/ |
| Datenschutzrichtlinie | https://www.inquba.com/data-privacy/ |
| Kategorien | Daten; Kommunikation |
Der inQuba Journey Connector ermöglicht eine nahtlose Integration zwischen Ihren vorhandenen Systemen und der inQuba Journey-Plattform. Senden Sie daten einfach über den Connector, um Ihre Kundenreisen schnell zu visualisieren und Einblicke in das, was Ihre Kunden sagen und tun, zu gewinnen. Der Connector bietet einfach zu verwendende REST-APIs, mit denen Sie Kundenreisen und Ereignisse veröffentlichen können, die von der inQuba-Plattform genutzt werden.
Voraussetzungen
Sie benötigen Folgendes, um den inQuba Journey Connector zu nutzen:
- Eine registrierte inQuba Journey-Instanz bereitgestellt
- Ein aktives Azure-Abonnement
- Ein Microsoft Power Apps- oder Power Automate-Plan mit benutzerdefiniertem Connectorfeature;
Sie können ein Abonnement erwerben, indem Sie den Azure Market Place besuchen oder die InQuba-Website besuchen und sich an den Verkauf wenden.
So erhalten Sie Anmeldeinformationen
Die Autorisierung ist für alle inQuba-APIs erforderlich. Nachdem Sie den InQuba-Registrierungsprozess abgeschlossen haben, wenden Sie sich an Ihren Kontomanager oder inQuba-Support , um Ihre API-Anmeldeinformationen abzurufen. Diese Anmeldeinformationen werden dann für alle API-Vorgänge im Journey-Connector verwendet.
Erste Schritte mit Ihrem Connector
Der inQuba Journey Connector erfordert eine Autorisierung für alle Aktionen. Beginnen Sie immer mit der Verwendung der Aktion "Zugriffstoken erwerben", bevor Sie die Aktionen "Ereignis erstellen" oder "Transaktion erstellen" verwenden.
Rufen Sie Ihre Ereignis- oder Transaktionsattributedefinitionen und Anmeldeinformationen aus inQuba ab. Diese Attributdefinitionen geben die erforderlichen Attribute für die Interaktion mit Ihren Kunden an oder verfolgen ihre Kundenreise. Sie können sich an Ihren Kontomanager oder den InQuba-Support wenden, um die relevanten Definitionen und Anmeldeinformationen zu erhalten.
Verwenden Sie Ihre bereitgestellten Details in der Aktion "
Verwenden Sie entweder die Aktion "Ereignis erstellen" oder "Transaktion erstellen". Verwenden Sie dynamische Inhalte aus der Aktion "Zugriffstoken abrufen", um das Feld "Authroization Token" zu aktualisieren. Fügen Sie den Wert "Bearer" hinzu, und wählen Sie dann dynamische Inhalte mithilfe des Autorisierungstokenwerts aus dem vorherigen Schritt aus, wie unten dargestellt.
Danach können Sie die erforderlichen Details zum Formular der Aktion ausfüllen und mit der InQuba-Plattform integrieren.
Ein Beispiel für einen beliebten Fluss mit Dynamics ist unten dargestellt. Der folgende Fluss löst aus, wenn ein Flussschritt in Dynamics ausgeführt wird:
Bekannte Probleme und Einschränkungen
Das Create-Ereignis und das Erstellen der Transaktions-API unterstützen derzeit nur einzelne Ereignis- und Transaktionsnutzlasten pro Anforderung. Für mehrere Ereignisse und Transaktionen wird empfohlen, viele iterierte Anforderungen zu initiieren.
Häufige Fehler und Abhilfemaßnahmen
Antwort enthält einen HTTP 401-Fehler
Vergewissern Sie sich, dass Ihre Anmeldeinformationen korrekt sind und den von inQuba bereitgestellten Anmeldeinformationen entsprechen. Sie können sich an den InQuba-Support wenden, um Ihre Anmeldeinformationen zu überprüfen.
Antwort enthält einen HTTP 404-Fehler
Stellen Sie sicher, dass Sie den richtigen Mandantennamen und die richtige Host-URL wie inQuba angegeben verwenden. Sie können sich an den InQuba-Support wenden, um Ihren Mandantennamen zu überprüfen.
Antwort enthält einen HTTP 500-Fehler
Stellen Sie sicher, dass das Array der Ereignis- oder Transaktionsattribute korrekt definiert ist, indem Sie entweder die Attribute arrayeingabe verwenden oder überprüfen, ob die rohen Attribute korrekt sind. Sie können sich an den InQuba-Support wenden, um Ihre Konfiguration zu überprüfen.
Häufig gestellte Fragen
Wie viele Anforderungen kann ich über den Ereignis- oder Transaktionsendpunkt senden? Es gibt keine harte Beschränkung für die Anzahl der Anforderungen, die gesendet werden können, aber die Verarbeitung von Reisen und Ereignissen ist durch Ihre kostenpflichtige Abonnementebene beschränkt. Abonnementpreise finden Sie hier.
Wo finde ich die Open-API-Definitionen für Ereignisse und Transaktionen? Die Dokumentation zu Swagger ist für die Ereignis - und Transaktions-API verfügbar.
Sind Nicht-Produktionsendpunkte zum Testen verfügbar? Ja. Wenden Sie sich an Ihren Account Manager oder inQuba Support , um Ihre Testanmeldeinformationen zu erhalten.
Welche Datenquellen unterstützt der Connector? Der Connector unterstützt alle Datenquellen, die in Power Automate verwendet werden können. Sie können den Connector als Schritt zu jedem von Ihnen konfigurierten Fluss hinzufügen.
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Ereignis erstellen |
Veröffentlichen Sie einen Ereignisdatensatz in der inQuba-API. Für die Interaktion mit der API ist ein Bearertoken erforderlich. |
| Transaktion erstellen |
Veröffentlichen Sie eine Transaktion in der inQuba Journey-API. Für die Interaktion mit der API ist ein Bearertoken erforderlich. |
| Zugriffstoken erwerben |
Authentifizieren Sie sich mit der inQuba-API, und erhalten Sie ein Autorisierungstoken, das für alle API-Interaktionen verwendet wird. |
Ereignis erstellen
Veröffentlichen Sie einen Ereignisdatensatz in der inQuba-API. Für die Interaktion mit der API ist ein Bearertoken erforderlich.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Mandantenname
|
TenantName | True | string |
Name des Mandanten wie bei inQuba registriert. |
|
Autorisierungstoken
|
AuthorizationToken | True | string |
Autorisierungstoken für die Autorisierung der API-Anforderung an inQuba. |
|
Ereignisdefinitionscode
|
eventDefinitionCode | string |
Der Ereigniscode, für den Sie diese Anforderung veröffentlichen. |
|
|
Ist Test
|
isTest | boolean |
Ein Kennzeichen, das angibt, ob dieses Ereignis als Test oder live veröffentlicht werden soll. |
|
|
Code
|
code | string |
Ereignisattributecode |
|
|
Wert
|
value | string |
Wert des Ereignisattributes |
Gibt zurück
- SuccessStatus
- string
Transaktion erstellen
Veröffentlichen Sie eine Transaktion in der inQuba Journey-API. Für die Interaktion mit der API ist ein Bearertoken erforderlich.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Mandantenname
|
TenantName | True | string |
Name des Mandanten wie bei inQuba registriert. |
|
Autorisierungstoken
|
AuthorizationToken | True | string |
Autorisierungstoken für die Autorisierung der API-Anforderung an inQuba. |
|
Transaktionsdefinitionscode
|
transactionDefinitionCode | string |
Der Transaktionscode, für den Sie diese Anforderung veröffentlichen. |
|
|
Ist Test
|
isTest | boolean |
Ein Kennzeichen, das angibt, ob diese Transktion als Test oder live veröffentlicht werden soll. |
|
|
Code
|
code | string |
Transaktionsattributecode |
|
|
Wert
|
value | string |
Transaktionsattributewert |
Gibt zurück
- SuccessStatus
- string
Zugriffstoken erwerben
Authentifizieren Sie sich mit der inQuba-API, und erhalten Sie ein Autorisierungstoken, das für alle API-Interaktionen verwendet wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Mandantenname
|
TenantName | True | string |
Name des Mandanten wie bei inQuba registriert. |
|
Host-URL
|
HostURL | True | string |
Host des Tokenendpunkts muss ohne Schemanamen angegeben werden. Zb. api.inqubacx.com |
|
Nutzername
|
username | True | string |
Kontoname, wie von inQuba angegeben. |
|
Kennwort
|
password | True | string |
Kontokennwort wie inQuba angegeben. |
|
Kunden-ID
|
client_id | True | string |
Client-ID, wie von inQuba angegeben. |
|
Geheimer Clientschlüssel
|
client_secret | True | string |
Geheimer Clientschlüssel, wie von inQuba bereitgestellt. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Autorisierungstoken
|
access_token | string |
Autorisierungstoken, das für alle API-Interaktionen verwendet wird. |
Definitionen
Schnur
Dies ist der grundlegende Datentyp "string".