Threema / Threema Work¶

Die folgenden Schritte geben Ihnen einen Überblick welche Schritte notwendig sind, um einen Bot für Threema / Threema Work anzulegen. Da das Benutzerinterface von Threema möglichen Änderungen unterliegt, besteht kann Anspruch auf Vollständigkeit oder Richtigkeit der folgenden Schritte. Wir aktualisieren jedoch die Dokumentation regelmäßig und freuen uns auf Hinweise Ihrerseits.

Kurzüberblick: Die Einrichtung erfolgt in mehreren Schritten:

1. Neues Botkonto für Threema erstellen
2. Neues Botkonto auf der Business Bot Plattform anlegen
3. Einrichten des Webhook für den Threema Bot

Schritt 1: Neues Botkonto für Threema erstellen¶

Öffnen Sie Ihren Webbrowser und gehen Sie auf die ThreemaGateway Webseite (https://gateway.threema.ch/de). Wenn Sie noch kein Theema Konto besitzen, müssen Sie sich zuerst registrieren. Zubald Sie die Anmeldedaten erhalten haben melden Sie sich mit der E-Mail Adresse und Passwort an.

Der nächste Schritt besteht darin eine neue Threema ID anzufordern. Dazu müssen Sie einige Information wie im folgenden Bild angeben:

Sobald Sie die Threema ID erhalten haben, können Sie ein Profilfoto angeben sowie den Kontostand verwalten.

Schritt 2: Neues Botkonto auf der Business Bot Plattform anlegen¶

1. Zunächst meldet man sich bei der Business Bot Plattform an

2. Wähle Bot Administration → Instant Messenger Konten → Erstelle Bot-Konto. Folgenden Daten werden zum Anlegen des Bot-Kontos benötigt:

   Feld	Beispielwert
   Name:	MeinThreemaBotKonto
   Beschreibung:	BotKonto für Abteilung Z
   Instant Messenger:	Threema

3. Das Bot-Konto wurde nun erstellt und muss noch mit dem Kontoinformationen des Instant Messengers konfiguriert werden. Dazu klickt man auf das Icon Einstellungen und modifiziert folgende Parameter:

   Pflichtfelder	Beschreibung	Beispielwert
   Threema.UserInfo.UserId	Threema Id für die geschäftliche Nutzung (beginnt mit *)	z.B. *COMPANY
   Threema.User.PrivateKey.Secret	Threema private key Passwort	lksjdfjlkjjsjjsjkd
   Threema.User.PrivateKey.String	Threema private key string (von privateKey.txt)	z.B. 6139ae.. (65 chars)
   Threema.User.PublicKey.String	Threema public key string (von publicKey.txt)	z.B. 6139ae.. (65 chars)
   Threema.ValidationToken	Ähnlich einem Schlüssel, der von Threema benötigt wird, um die Verbindung mit dem passwortgeschütztem Webhook der BBP herzustellen	NoVerificationRequired
   Messenger.WebhookId	Diese Webhook-ID ist einzigartig und wird von der Business Bot-Plattform generiert (z.B. https://demo.bbp.local/bbp/webhook/)	42da2023-0187-4ab7-94ec-c843153bb36a

Das Benutzerkonto für den Bot ist nun konfiguriert und wird später beim Anlegen einer Bot-Instanz für den Threema Messenger verwendet.

Schritt 3: Einrichten des Webhook für den Threema Bot¶

Als nächstes müssen wir die Nachrichten an die Business Bot Plattform weiterleiten. Zuerst müssen Sie die Webhook-Adresse auf der Business-Bot-Plattform herausfinden. Um die Webhook-Adresse anzuzeigen, melden Sie sich auf der Business Bot Platform an, um navigieren zu: Chatbot Administration → Bots. Bewegen Sie nun den Mauszeiger über den Bot-Namen, um die Webhook-Adresse des Bot anzuzeigen.

Sobald Sie die Webhook-Adresse herausgefunden haben, müssen Sie diese Adresse auf Threema Gateway einrichten. Melden Sie sich bei Threema Gateway an, gehen Sie zum Menü ID und geben Sie die Webhook-Adresse in das Feld URL für eingehende Nachrichten ein. Klicken Sie auf Speichern, um die Änderungen zu übernehmen und warten Sie einige Minuten bevor Sie mit den nächsten Schritten fortfahren.

Die Webhook-Konfiguration ist nun abgeschlossen. Um Nachrichten vom Threema Gateway zu erhalten, müssen der Webhook betriebsbereit sein. Dazu brauchen Sie nur den Bot zu starten.