So verbinden Sie einen Bot mit KWIGA

In KWIGA können Sie Bots und Messaging-Kanäle über Telegram, WhatsApp, Facebook Messenger, Instagram Direct und Viber verbinden.

Um einen Bot zu verbinden, öffnen Sie den entsprechenden Einstellungsbereich in Ihrem KWIGA-Konto, wählen Sie den Messenger aus, füllen Sie die erforderlichen Felder aus und klicken Sie auf „Bot speichern“.

1. Telegram

Um einen Telegram-Bot zu verbinden, geben Sie Folgendes ein:

• Name — den Namen des Bots in KWIGA.

• Token — den Token, den Sie in Telegram von @BotFather nach der Erstellung des Bots erhalten haben.

Wichtig:

• Geben Sie den Token nicht an andere weiter. Er ermöglicht die Verwaltung des Bots.

• Wenn der Token kompromittiert wurde, widerrufen Sie ihn und erstellen Sie über BotFather einen neuen.

2. WhatsApp

Um WhatsApp zu verbinden, geben Sie Folgendes ein:

• Name — den Namen der Verbindung in KWIGA.

• Zugriffstoken — einen permanenten Token für einen Systembenutzer.

• Telefonnummer-ID — die ID der Telefonnummer.

• WhatsApp-Business-Konto-ID (WABA-ID) — die ID des WhatsApp-Business-Kontos.

• App-Secret der Meta-App — den geheimen Schlüssel der Meta-App.

Wichtig vor der Verbindung

• Die Telefonnummer darf nicht mehr mit der regulären WhatsApp-App oder der WhatsApp-Business-App verbunden sein. Trennen Sie die Verbindung vorab gemäß der Integrationsanleitung.

• Wenn die Nummer bei einem anderen Anbieter verwendet wird, prüfen Sie die Anforderungen für die Übertragung der Nummer und die Zwei-Faktor-Verifizierung.

• Die Meta-App muss sich im Live-Modus befinden und einen Link zu einer Datenschutzerklärung enthalten.

• Bis Meta die Unternehmensverifizierung abgeschlossen hat, zeigt die KWIGA-Oberfläche für den Nachrichtenversand ein Limit von höchstens 250 neuen Kunden pro Tag an. Prüfen Sie vor der Veröffentlichung, ob dieses Limit noch aktuell ist und wofür genau es gilt.

• Nach Ablauf des 24-Stunden-Zeitfensters seit der letzten Nachricht des Kunden können Sie nur noch von Meta genehmigte Nachrichtenvorlagen senden.

• Wenn Sie einen Kunden zum ersten Mal kontaktieren, müssen Sie die WhatsApp-Regeln zur Einwilligung der Empfänger in den Erhalt von Nachrichten einhalten.

Beachten Sie außerdem, dass Meta die Nachrichtentarife festlegt und je nach Kontostatus und Qualität Einschränkungen verhängen kann.

3. Facebook Messenger

Um Facebook Messenger zu verbinden, geben Sie Folgendes ein:

• Name — den Namen der Verbindung in KWIGA.

• Seitenzugriffstoken — den Zugriffstoken der Facebook-Seite.

• Seiten-ID — Facebook-Seiten-ID.

• App-Geheimschlüssel der Meta-App — Geheimschlüssel der Meta-App.

Wichtig vor dem Verbinden

• Die Meta-App muss im Live-Modus sein und einen Link zur Datenschutzerklärung enthalten.

• Sie können einem Kunden innerhalb von 24 Stunden nach seiner letzten Nachricht mit einer regulären Nachricht antworten.

• Nach Ablauf dieser Frist schränken die Regeln von Meta reguläre Nachrichten ein. Besondere Nachrichtenoptionen sind nur verfügbar, wenn die Anforderungen von Meta erfüllt sind.

• Für die Integration sind die entsprechenden App-Berechtigungen und der Zugriff auf die Facebook-Seite erforderlich.

4. Instagram Direct

Um Instagram Direct zu verbinden, geben Sie Folgendes ein:

• Name — Name der Verbindung in KWIGA.

• Instagram-Zugriffstoken (langfristig gültig) — Zugriffstoken.

• Instagram-Nutzer-ID — ID des professionellen Instagram-Kontos.

• Instagram-App-Geheimschlüssel der Meta-App — Geheimschlüssel der Meta-App.

Wichtig vor dem Verbinden

• Für die Integration ist ein professionelles Instagram-Konto erforderlich — ein Business- oder Creator-Konto. Persönliche Konten unterstützen diese Art der API-Integration nicht.

• Die Meta-App muss im Live-Modus sein und einen Link zur Datenschutzerklärung enthalten.

• Sie können einem Kunden innerhalb von 24 Stunden nach seiner letzten Nachricht mit einer regulären Nachricht antworten.

• Ob Sie eine Unterhaltung beginnen, eine Nachricht senden oder einen Chat fortsetzen können, hängt von den Regeln der Instagram Messaging API ab.

• Für die Integration benötigt die App die erforderlichen Berechtigungen für Nachrichten.

5. Viber

Um Viber zu verbinden, geben Sie Folgendes ein:

• Name — Name des Bots in KWIGA.

• Viber-Bot-Token — Token aus dem Viber Admin Panel.

Wichtig vor dem Verbinden

• Die Erstellung eines Chatbots erfordert eine Registrierung und Genehmigung gemäß den aktuellen Geschäftsbedingungen von Rakuten Viber.

• Nach dem aktuellen Geschäftsmodell von Viber beträgt die reguläre Servicegebühr für einen neuen Bot 115 € pro Monat. Für vom Bot initiierte Nachrichten, die zugestellt werden, fallen zusätzliche Gebühren an. Klären Sie die endgültigen Kosten vor dem Verbinden mit Viber.

• In diesem Modell werden Nachrichten, die während einer aktiven 24-Stunden-Sitzung gesendet werden, nicht einzeln berechnet.

• Eine Sitzung beginnt, wenn ein Abonnent dem Bot eine Nachricht sendet oder auf eine vom Bot initiierte Nachricht antwortet.

• Für Nachrichten, die außerhalb einer aktiven Sitzung gesendet werden, gelten die Geschäftsbedingungen von Viber.

Bot-Einrichtung in KWIGA

Nachdem Sie einen Bot mit KWIGA verbunden haben, können Sie sein Verhalten, automatische Nachrichten, Befehle, Schaltflächen und weitere Einstellungen für die Interaktion mit Abonnenten konfigurieren.

Die verfügbaren Einstellungen hängen von der verbundenen Messaging-App ab.

Posteingang

Legen Sie fest, wie eingehende Unterhaltungen bearbeitet werden und wann der Bot arbeitet.

• Unterhaltungen automatisch zuweisen — Unterhaltungen automatisch reihum Teammitgliedern zuweisen.

• Arbeitszeiten — Zeitzone und Arbeitszeiten festlegen.

• Automatische Antwort außerhalb der Arbeitszeiten — Abonnenten, die den Bot außerhalb seiner Arbeitszeiten kontaktieren, automatisch eine Nachricht senden.

Nachrichten

Richten Sie automatische Nachrichten ein, die der Bot in verschiedenen Situationen sendet.

Je nach verfügbaren Funktionen können Sie eine Begrüßung für neue Kontakte, Antworten auf häufige Fragen und Nachrichten zum Zugang zu geschlossenen Gruppen einrichten.

Befehle

Hier können Sie Bot-Befehle erstellen und festlegen, welche Antworten Abonnenten erhalten, wenn sie diese eingeben.

Befehle erscheinen im Bot-Menü und helfen Nutzern, schnell Informationen zu finden oder eine Aktion auszulösen. Sie können beispielsweise die Befehle "Hilfe", "Meine Kurse", "Kontakte" oder "Support" erstellen.

Für jeden Befehl können Sie einen Namen und die Antwort des Bots festlegen. Für komplexere Interaktionen — etwa um Nutzern mehrere Fragen zu stellen, Informationen zu erfassen oder Aktionen auszuführen — können Sie den Befehl mit einer Automatisierung verknüpfen.

Systembefehle sind ebenfalls verfügbar, darunter //help, //menu, //stop, //unsubscribe und //subscribe, die Standardaktionen des Bots ausführen.

Schaltflächen

Richten Sie Schaltflächen ein, über die Abonnenten mit dem Bot interagieren können.

Je nach verfügbaren Funktionen können Sie eine Tastatur unter dem Eingabefeld und Schaltflächen unter Nachrichten einrichten.

Links

Hier können Sie separate Bot-Links mit Quellenbezeichnungen erstellen, um nachzuvollziehen, woher neue Abonnenten kommen.

Wenn Sie beispielsweise einen Bot-Link auf Ihrer Website, auf Instagram und in Anzeigen teilen, erstellen Sie für jede Quelle einen eigenen Link und benennen Sie ihn entsprechend: "Website", "Instagram", "Facebook Ads" usw.

So erstellen Sie einen Link:

1. Geben Sie den Namen der Quelle ein.

2. Klicken Sie auf "Link erstellen".

3. Kopieren Sie den generierten Link oder laden Sie den QR-Code herunter.

4. Teilen Sie ihn an der entsprechenden Stelle.

Wenn jemand dem Link folgt, den Bot öffnet und auf "Start" klickt, erfasst KWIGA die Quelle. Die Anzahl neuer Abonnenten pro Link wird in dessen Einstellungen und im Analysebereich "Woher Abonnenten kommen" angezeigt.

Nur neue Abonnenten zählen: Wenn jemand bereits mit dem Bot interagiert hat, wird ein späterer Aufruf über einen anderen Link nicht gezählt.

Diagnose

Prüfen Sie die Verbindung zwischen dem Bot und KWIGA, sehen Sie sich den Status an und nutzen Sie die verfügbaren Diagnose-Tools.

Die verfügbaren Tools hängen von der Integration ab.