Wie man mit Botpress v12 und Smooch ganz einfach einen WhatsApp Chatbot erstellt
Ein Chatbot kann eine unglaublich nützliche Hilfe für Ihr Unternehmen sein. In diesem Beitrag finden Sie alle Schritte, die Sie benötigen, um Ihren eigenen zu erstellen. Mit Botpress v12 und Smooch (jetzt bekannt als Sunshine Conversations von Zendesk) zeigen wir Ihnen, wie Sie sich mit WhatsApp verbinden und einen einfachen Q&A-Bot erstellen, der auf eine Vielzahl von Fragen antwortet.
Vor der Erstellung des Bots
Bevor wir beginnen, müssen Sie mehrere Dienste einrichten und konfigurieren . Dazu benötigen Sie eine geschäftliche E-Mail-Adresse und mindestens 64 GB Speicherplatz auf Ihrer Festplatte.
Herunterladen Botpress
Navigieren Sie zunächst zur DokumentationsseiteBotpress v12 und laden Sie Ihre bevorzugte Version von Botpress herunter.
Erstellen Sie ein Konto bei Smooch
Während Botpress v12 herunterlädt, navigieren Sie zur Anmeldeseite von Smooch/Sunshine Conversations. Sobald Sie den Anmeldevorgang abgeschlossen haben, müssen Sie eine App erstellen und ihr einen Namen geben.
Zu diesem Zeitpunkt sollte Ihr Download von Botpress abgeschlossen sein. Wenn Sie mit der Option "binär" heruntergeladen haben, extrahieren Sie den Inhalt des Downloads einfach in ein Verzeichnis Ihrer Wahl.
Ngrok herunterladen
Der dritte Dienst, den wir verwenden werden, heißt Ngrok, den Sie hier herunterladen können. Ngrok ist ein kostenloser Dienst, den wir verwenden werden, um den Botpress Server, der auf Ihrem lokalen Rechner läuft, für das Web freizugeben. Befolgen Sie die Anweisungen auf der Website zum Herunterladen und Installieren. Jetzt können Sie mit der Erstellung Ihres Chatbots beginnen.
Botpress mit API-Schlüsseln von Smooch einrichten
Um mit Ihrem Chatbot zu beginnen, müssen Sie zunächst den Ordner öffnen, in den wir Botpress v12 entpackt haben, und die Datei "bp" ausführen. Dadurch wird der Bot gestartet, was den Download einiger Module erfordert. Dieser Vorgang nimmt einige Zeit in Anspruch, sollte aber nur einmal durchgeführt werden müssen, so dass jeder weitere Start schneller vonstatten geht.
Während die App Botpress eingerichtet wird, navigieren Sie zurück zu Ihrer App auf Smooch und wählen Sie Einstellungen. Sie sollten Optionen für die Benennung Ihres Bots, ein Bild, Nachrichtenoptionen, eine App-ID und API-Schlüssel sehen. Wenn Sie API-Schlüssel sehen, sollten Sie einen neuen API-Schlüssel erstellen.
Erstellen und konfigurieren Sie Ihren Bot
Die Einrichtung von Botpress v12 sollte abgeschlossen sein, wenn Sie den API-Schlüssel auf Smooch generieren. Zu diesem Zeitpunkt hat Ihnen Ihre Konsole mitgeteilt, wo Sie das Botpress Studio öffnen können - in unserem Fall war dies localhost:3000. Navigieren Sie zu der in der Konsole angegebenen URL und melden Sie sich für Ihr Administratorkonto an.
Da Sie Botpress zum ersten Mal ausführen, werden Sie feststellen, dass Ihr Arbeitsbereich keine Bots enthält. Wählen Sie die Option zum Erstellen eines Bots und geben Sie ihm einen Namen. Dadurch wird das Feld Bot-ID automatisch ausgefüllt. Wählen Sie als Nächstes eine Bot-Vorlage aus (z. B. die Option "Learn Botpress Basics").
Sie werden sehen, dass Ihr Arbeitsbereich jetzt einen Bot hat! Wählen Sie nun den Bot aus (klicken Sie auf seinen Namen). Eine senkrecht verlaufende Leiste auf der linken Seite des Studios sollte Ihre Aufmerksamkeit erregen. Die hier angezeigten Optionen sind die, mit denen Sie bei der Entwicklung Ihres Bots am meisten arbeiten werden. In unserem Fall beginnen wir mit der Option Code-Editor, die eine Reihe von Verzeichnissen im Studio öffnet und uns zum nächsten Schritt bringt.
Unter Configurations im Code-Editor sehen Sie zwei Ordner. Konzentrieren Sie sich zunächst auf den Ordner Current bot.
Wählen Sie unter Configurations die Datei bot.config.json aus und blättern Sie zu "messaging". Hier können Sie ein Objekt "channels" hinzufügen, das ein Objekt "smooch" enthalten wird. Erstellen Sie in Smooch einen booleschen Wert namens "enabled" und geben Sie ihm den Wert "true". Anschließend müssen Sie die Zeichenketten "keyId" und "secret" erstellen - , die die ID bzw. das Geheimnis des API-Schlüssels übernehmen, den Sie in Ihrer Smooch-Anwendung erstellt haben.
Sobald diese Aufgabe abgeschlossen ist, speichern Sie Ihre bot.config.json und navigieren Sie zum Ordner Global unter Configurations, um die botpress.config.json zu öffnen. Suchen Sie nach "externalUrl", das auf eine leere Zeichenfolge gesetzt ist. Dies ist ein recht einfacher Dienst, folgen Sie also einfach den Anweisungen auf der Website, um den Port, auf dem der Bot laufen wird, mit Ngrok freizugeben. Danach fügen Sie die HTTPS-URL in die Zeichenfolge externalUrl ein.
Speichern Sie die Datei, starten Sie den Server neu und öffnen Sie dann Ihren Bot erneut. Klicken Sie auf "Jetzt trainieren" in der unteren rechten Ecke. An der Stelle, an der früher "Jetzt trainieren" stand, sollte jetzt "Bereit" stehen.
Sprechen Sie mit Ihrem Bot
Kehren Sie zur Smooch-App zurück und Sie sollten sehen, dass Webhooks automatisch konfiguriert werden. Navigieren Sie zurück zu Integrationen, wählen Sie WhatsApp aus und verbinden Sie sich. Wählen Sie nun Ihren Integrationsmodus - für die Zwecke dieser Anleitung ist "Sandbox" ausreichend.
Wählen Sie "Sandbox aktivieren" und folgen Sie den Anweisungen, um eine Nachricht an die angegebene Nummer in WhatsApp zu senden. Nachdem Sie Ihre Smooch Sandbox für WhatsApp erfolgreich verbunden haben, sollten Sie eine Nachricht erhalten. Alle weiteren Nachrichten werden an den von Ihnen erstellten Webhook weitergeleitet.
Jetzt können Sie mit Ihrem Bot sprechen!
Lassen Sie Ihren Bot zurücksprechen
Da wir nun einen leeren Bot haben und eine Nachricht erhalten haben, die bestätigt, dass unsere Integrationen ordnungsgemäß funktionieren, wollen wir mit der ersten Reaktion des Bots beginnen, nachdem wir etwas gesagt haben.
Navigieren Sie dazu im Botpress Studio zu Q&A, der vierten Option unten in der linken Seitenleiste. Sie werden aufgefordert, eine Frage hinzuzufügen, indem Sie auf das Pluszeichen in der Symbolleiste tippen; folgen Sie dieser Aufforderung. Daraufhin wird ein Bildschirm angezeigt, in dem Sie sowohl für die Frage als auch für die Antwort einen Text eingeben können. In unserem Fall haben wir die Frage "Was ist Ihr Lieblingsobst? Die Antwort lautet: "Meine Lieblingsfrucht ist die Tomate, die von den meisten Menschen mit Gemüse verwechselt wird! Wir können diesen Vorgang einige Male wiederholen und jedes Mal eine neue Frage und Antwort eingeben.
Sie werden feststellen, dass oben rechts bei jeder neuen Frage "unvollständig" steht. Wenn Sie mit dem Mauszeiger darüber fahren, wird Ihnen mitgeteilt, dass die Frage und Antwort nur exakte Übereinstimmungen verwenden wird. Das liegt daran, dass wir mehrere verschiedene Arten, die Frage zu stellen, hinzufügen müssen, um das maschinelle Lernen für den Bot zu ermöglichen und zu unterstützen. Fügen Sie mehrere Varianten der Frage zu den Q&A hinzu, je mehr, desto besser.
Schließlich können wir eine Unterhaltung mit unserem Bot führen und ihm einige einfache Fragen stellen, auf die wir dann eine Antwort erhalten. Das sollte ziemlich einfach sein. Stellen Sie ihm einfach eine der von Ihnen erstellten Fragen und erhalten Sie eine Antwort! Beachten Sie, dass es sich hier um eine recht einfache Integration handelt. Unzulässige Fragen oder Nachrichten, die außerhalb der für diesen Bot konfigurierten Parameter liegen, werden einfach ignoriert.
Schlussfolgerung
In diesem Leitfaden haben wir die Anmeldung bei den Diensten behandelt, die Sie benötigen, um einen Chatbot mit Botpress v12 zu erstellen. Dazu gehören Smooch, Ngrok und Botpress selbst. Wir haben unsere Dienste konfiguriert, sie zusammen integriert und mit unserem Bot gesprochen. Beim Gespräch mit dem Bot haben wir gesehen, wie er mit einer Vielzahl von Eingaben umgeht und wie er auf unsachgemäße oder unspezifische Eingaben reagiert. Wenn Sie etwas Robusteres bauen möchten, das APIs aufruft und mit Flows arbeitet, wäre unser Mars Rover Photography Chatbot ein guter Ausgangspunkt. Wenn du über WhatsApp hinausgehen und deinen Chatbot in andere Kanäle integrieren möchtest, schau dir unsere Botpress v12 Channel Integration Playlist auf YouTube an. Viel Spaß beim Bot-Bauen! :robot:
Schritt-für-Schritt-Rekapitulation
Es wird zwar empfohlen, diesen Leitfaden vollständig zu lesen, aber hier ist eine grobe Zusammenfassung der wichtigsten Schritte:
1. Vorbereitung
- Laden Sie botpress von https://v12 herunter .botpress.com/
- Anmelden unter app.smooch.io
- Erstellen Sie eine App bei smooch und geben Sie ihr einen Namen
- Entpacken Sie den Inhalt des Botpress Downloads in ein Verzeichnis Ihrer Wahl
- Laden Sie Ngrok von https://ngrok.com/ herunter und befolgen Sie die Anweisungen auf der Website zur Installation.
2. Start
- Öffnen Sie den Ordner Botpress , in den extrahiert wurde
- Datei "bp" ausführen
- Haben Sie Geduld, während die richtigen Module heruntergeladen werden
3. Erstellung
- Generieren Sie den API-Schlüssel
- Warten Sie, bis Botpress mit dem Einrichten fertig ist.
- Die Konsole sagt Ihnen, wo das Botpress Studio zu finden ist (Beispiel: bei mir war es localhost:3000)
- Navigieren Sie zu der in der Konsole angegebenen Url
- Mit einem Administratorkonto anmelden
- Erstellen Sie eine Bot-Option und benennen Sie sie
- Bot-Vorlage auswählen (Beispiel: "Leerer Bot")
- Der Arbeitsbereich wird nun einen Bot haben
- Klicken Sie auf Bot, indem Sie auf den Namen klicken
- Navigieren Sie zur Option Code-Editor
4. Konfiguration
- Suchen Sie den Ordner Current Bot unter Configurations im Code-Editor
- Wählen Sie unter Konfigurationen die Datei bot.config.json und blättern Sie zu "messaging".
- Ein Objekt "channels" hinzufügen (enthält ein Objekt "smooch")
- Erstellen Sie in Smooch einen booleschen Wert namens "enabled" und geben Sie ihm den Wert true
- Erstellen Sie die Zeichenketten "keyId" und "secret" (die ID und das Geheimnis des zuvor in Smooch generierten API-Schlüssels übernehmen)
- Speichern Sie Ihre bot.config.json
- Zu Konfigurationen navigieren
- Öffnen Sie botpress.config.json
- Suchen Sie nach "externalUrl" (es wird auf eine leere Zeichenfolge gesetzt)
- Datei speichern
- Server neu starten
- Bot erneut öffnen
- Klicken Sie auf "Jetzt trainieren".
- "Bereit" wird "Zug jetzt" ersetzen
- Kehren Sie zu Smooch zurück und überprüfen Sie die automatisch konfigurierten Webhooks
- Zu den Integrationen
- WhatsApp auswählen und verbinden
- Wählen Sie den Integrationsmodus (Beispiel: Ich habe "Sandbox" verwendet)
- Wählen Sie "Sandbox aktivieren" und folgen Sie den Anweisungen, um eine Nachricht an die angegebene Nummer in WhatsApp zu senden.
- Prüfen, ob Nachricht empfangen wurde
- Weitere Nachrichten werden an den Webhook weitergeleitet
- Du kannst jetzt mit deinem Bot sprechen!
5. Sprechen mit dem Bot
- Stellen Sie dem Bot eine Ihrer Fragen
- Lesen Sie die Antwort
- Stellen Sie ihm eine "falsche" Frage und stellen Sie fest, dass es nicht antwortet.
Teilen Sie dies auf:
Erstellen Sie kostenlos Ihren eigenen personalisierten AI-Chatbot
Beginnen Sie mit der Erstellung eines personalisierten GPT-Bots mit unserer intuitiven Drag & Drop-Oberfläche.
Legen Sie los - es ist kostenlos! 🤖Keine Kreditkarte erforderlich
Bleiben Sie auf dem Laufenden über AI chatbots