Terminologie
Der Begriff Client wird verwendet, um personenbezogene Kunden oder Partner zu identifizieren, die eine Integration mit dem personenbezogenen peoplefone CONNECTOR durchführen
Der Begriff Telefonsuchdienst wird verwendet, um den Dienst des Clients zu identifizieren, der die aktuelle Schnittstelle für den peoplefone CONNECTOR zum Erfassen von Daten verfügbar macht.
Wann kann die peoplefone CONNECTOR API verwendet werden?
Wenn das CRM des Kunden nicht von peoplefone unterstützt wird, bitten wir den Kunden, einen Telefonsuchdienst bereitzustellen.
Überblick
Die peoplefone CONNECTOR API deckt mehrere Anwendungsfälle ab:
- Datensuche zu Benachrichtigungszwecken
Wenn ein Telefonanruf ausgeführt wird (eingehend oder ausgehend), benachrichtigt peoplefone HOSTED den peoplefone CONNECTOR, der mithilfe der in diesem Artikel beschriebenen REST API nach Daten sucht. - Interaktion mit dem Business Workflow
Wenn der Benutzer von peoplefone CONNECTOR auf einen der Geschäftsabläufe klickt, überträgt der Benutzer von peoplefone CONNECTOR die Anforderung zur Behandlung an den Telefonsuchdienst. Der Geschäftsworkflow kann das Erstellen eines Tickets oder eines Anrufverlaufs im CRM umfassen.
Hinweis: Nur Teil 1 wird im Moment behandelt, Teil 2 befindet sich noch im Aufbau.
Teil 1 – Datenabfrage
Anfrage
URL
https://clientServiceAddress/someController
Der Request-URL wird vom Client definiert, damit peoplefone CONNECTOR den Telefonsuchdienst erreichen kann. Diese URL enthält KEINE privaten Daten, die für die Suche erforderlich sind. Diese Daten werden über HTTP-Header bereitgestellt.
Parameter abfragen
peoplefone CONNECTOR gibt die Telefonnummer über den folgenden Abfrage-Parameter an:
Schlüssel: Telefonnummer
Wert (sample): 4178907228
https://clientServiceAddress/someController?PhoneNumber=4178907228
HTTP-Header
Zur Authentifizierung stellt peoplefone CONNECTOR einen Token über den folgenden HTTP-Header bereit:
Schüssel: X-Execution-Token
Wert: jlvlkdshvövdjhwgjwogjhwg
Body
Der Body der Anfrage wird vorerst nicht vom peoplefone CONNECTOR verwendet
Antwort
Beispiel vom HTTP Body
[
{
"Name": "Alexa Holiday",
"Company": "White Cross Co",
"ContactUri": "https://...",
"CompanyUri": "https://...",
"Id": "Crm Identification Number",
"CrmName": "Sugar CRM",
"CrmLogo": "https://...",
"CustomData": {
"Title1": "Data1",
"Title2": "Data2"
}
},
{
...
}
]Layer 1: Die Liste
Das erwartete Ergebnis ist ein Array von Objekten. Es wird empfohlen, nur eine sehr kleine Anzahl von Ergebnissen zurückzugeben. Der Wert von maximal 5 Ergebnissen eignet sich am besten für ein ausgewogenes Verhältnis zwischen Leistung und Präzision. Das Erhöhen dieses Werts kann jedoch in allen Phasen des Systems zu erheblichen Verzögerungen und Leistungsproblemen führen.
Wenn die Abfrage keinen Wert zurückgibt, wird von peoplefone CONNECTOR erwartet, dass sie ein leeres Array mit einem Statuscode von 200 erhält. In diesem Fall wird KEIN 404-Statuscode erwartet. Der 404-Statuscode bedeutet, dass auf den Telefonsuchdienst nicht zugegriffen werden kann.
Layer 2: Das Objekt
Die Objekte, aus denen die Liste besteht, stellen einen Eintrag dar, der für die angegebene Telefonnummer im integrierten CRM gefunden wurde. Dieses Objekt enthält nur wenige Felder, die für peoplefone CONNECTOR erforderlich sind, um den Eintrag ordnungsgemäss anzuzeigen, sowie eine Liste von Schlüssel-Wert-Paaren für bestimmte Daten, die unser Kunde hinzufügen möchte.
| Feldname | Beschreibung |
| Name | Der vollständige Name des gefundenen Kontakts. Dies wird in der Benutzeroberfläche verwendet, um den Namen des Kontakts anzuzeigen. |
| Firma | Der Name der Firma, mit der der Kontakt verknüpft ist. Dies wird in der Benutzeroberfläche verwendet, um den Namen des Unternehmens anzuzeigen. |
| ContactUri | Der URI für den Zugriff auf die Kontaktseite im CRM. Dies wird in der Benutzeroberfläche verwendet, um eine verbindung zum Kontakt herzustellen. |
| CompanyUri | Der URI für den Zugriff auf die Unternehmensseite im CRM. Dies wird in der Benutzeroberfläche verwendet, um eine verbindung zum Unternehmen herzustellen. |
| Id | Die ID des Kontakts im CRM. Dieser Wert wird nicht angezeigt.| |
| CrmName | Der Name des CRM. Dieser Wert wird, insofern angegeben, verwendet, um einen Tooltip zum CRM-Logo hinzuzufügen. |
| CrmLogo | Die URL des Logos des CRM. Dieser Wert wird, falls angegeben, verwendet, um ein Logo auf der Kontaktkarte für diesen Eintrag hinzuzufügen. Dies ist optional, wenn der Kunde nur ein CRM integriert. Es wird jedoch nützlich, wenn der Kunde mehrere CRM-Integrationen hat. |
| CustomFields | Das Objekt CustomFields ist eine Reihe von Schlüssel-Wert-Paaren, mit denen der Kunde alle Daten übertragen kann, die er für die benötigt. |
Teil 2 – Geschäftsablauf
Folgt demnächst
Leistung
Die Antwortzeit ist der Schlüssel, damit der Benutzer die entsprechenden Informationen in der peoplefone CONNECTOR-Anwendung so schnell wie möglich sehen kann. Das bedeutet, dass der Telefonsuchvorgang so schnell wie möglich sein sollte. Um sicherzustellen, dass der Benutzer nicht betroffen ist, wenn die Telefonsuche manchmal zu langsam ist, wird der peoplefone CONNECTOR nach einer konfigurierten Anzahl von Sekunden eine Zeitüberschreitung für die Telefonsuche verursachen und dann die grundlegenden Informationen zurückgeben (Telefonnummer und Anrufstatus).