Zoho Sales IQ

Sie können den Agenten-Dienst in Zoho Sales IQ integrieren und ermöglichen so Nutzer:innen von Zoho Sales IQ, direkt mit dem Agenten zu kommunizieren.

Integration vorbereiten

Vor der Integration müssen Sie einige Parameter in Zoho konfigurieren, die während des Integrationsprozesses mit GPTBots benötigt werden.

So erstellen Sie eine Client-ID

1. Melden Sie sich in der Zoho API-Konsole an.

   Hinweis: Wenn Ihr Konto nicht in den USA registriert ist, passen Sie bitte die Domain entsprechend an. Weitere Informationen finden Sie hier:

2. Falls Sie bereits eine verfügbare Anwendung haben, öffnen Sie die entsprechende Anwendung, klicken Sie auf „Client Secret“ und kopieren Sie sowohl die Client-ID als auch das Client Secret. Beide werden für die Integration mit GPTBots benötigt.

3. Falls Sie noch keine Anwendung haben, klicken Sie oben rechts auf ADD CLIENT, um einen neuen Client entsprechend Ihrem Anwendungstyp zu erstellen.

4. Wenn Sie eine neue Anwendung erstellen, geben Sie im Feld „Homepage-URL“ den aktuellen Domainnamen Ihres Services ein. Fügen Sie bei „Authorized Redirect URIs“ den Domainnamen Ihres Services gefolgt von /api/console/bot/zoho/salesiq/redirect ein. Klicken Sie auf CREATE. Nach erfolgreicher Erstellung generiert das System eine Client-ID und ein Client Secret. Kopieren Sie beide, da sie für die GPTBots-Integration benötigt werden.

Hinweis: Eine Client-ID kann bis zu 20 gleichzeitige Autorisierungen haben. Wird diese Anzahl überschritten, wird die Zoho-Autorisierung des zuerst autorisierten Bots ungültig.

Integration einrichten

1. Melden Sie sich bei GPTBots an.

2. Wählen Sie in Ihrer Organisation den gewünschten Agenten, speichern Sie die Version und klicken Sie auf Veröffentlichen. Nach erfolgreicher Veröffentlichung klicken Sie auf Integrationen.

3. Wählen Sie als Integrationsmethode Zoho Sales IQ aus.

4. Geben Sie die erforderlichen Parameter ein:

   • Client-ID und Client Secret: Erforderlich, erhalten Sie in der Vorbereitungsphase;
   • Screen Name: Erforderlich, diesen finden Sie auf der Übersichtsseite Ihres angemeldeten Kontos. Verwenden Sie den ersten Pfad-String nach dem Domainnamen. Beispiel: In der Adresse https://salesiq.zoho.com/gptbos/mychats/000000000000003 ist der Screen Name „gptbots“;
   • E-Mail: Erforderlich, die mit dem Zoho-Konto verknüpfte E-Mail-Adresse;
   • Server-Region: Wählen Sie die Region Ihres Zoho-Kontos aus;
   • Public Key: Optional. Falls Sie im nachfolgenden Webhook-Konfigurationsschritt „Secure your webhook“ aktivieren, klicken Sie zuerst auf Integration und kehren dann zurück, um den Schlüssel einzutragen. Andernfalls ist dieses Feld nicht erforderlich.

5. Klicken Sie nach dem Klick auf Integration im erscheinenden Pop-up auf Akzeptieren.

6. Nach erfolgreicher Autorisierung generiert GPTBots eine Webhook-URL. Wechseln Sie anschließend zur Seite Einstellungen.

7. Klicken Sie auf Webhooks, wählen Sie Datenänderungen und anschließend auf Hinzufügen.

8. Geben Sie die Webhook-Daten wie folgt ein:

   • Marke: Wählen Sie die Marke aus, die den Webhook empfangen soll;
   • Aufzurufende URL: Tragen Sie die im GPTBots-Integrationsschritt erhaltene Webhook-URL ein;
   • Events: Wählen Sie „conversation.created“ und „conversation.visitor.replied“. Nach dem Ausfüllen klicken Sie auf Webhook erstellen.

9. Webhook-Sicherheit: Optional. Sie können wählen, ob Sie die Sicherheit des Webhooks überprüfen möchten (ob die Anfrage von der offiziellen Quelle stammt und nicht gefälscht ist). Nach dem Aktivieren klicken Sie auf „Public Key generieren“, kopieren Sie den als „In Use“ markierten Public Key und fügen Sie ihn auf der GPTBots-Integrationsseite ein.

Mit dem Bot in Zoho Sales IQ kommunizieren

Nach erfolgreicher Integration können Sie direkt im Zoho-Service mit dem Bot kommunizieren.