Viber #

Verbinden Sie Ihren eigenen Viber-Bot, damit Ihre Viber-Konversationen in die App fließen und ein KI-Agent antworten kann. Sie stellen die Verbindung her, indem Sie einen einzigen Wert (das Authentifizierungs-Token Ihres Bots) einfügen, und wir erledigen den Rest der Einrichtung für Sie.

Was ist die Viber-Integration? #

Die Viber-Integration verknüpft einen Viber-Bot, den Sie besitzen, mit der Plattform unter Verwendung der offiziellen Viber Bot API – Vibers eigenes System zum automatischen Senden und Empfangen von Nachrichten, anstatt diese manuell einzugeben. Konversationen zwischen Ihrem Bot und den Personen, die ihm folgen, werden innerhalb der App verfügbar, und ein KI-Agent sowie ein gemeinsamer Posteingang arbeiten auf dieser Basis.

Dies ist eine offizielle Integration, daher ist sie stabil und entspricht den Richtlinien von Viber.

Verfügbarkeit. Viber ist am weitesten verbreitet auf den Philippinen, in Vietnam und anderen Teilen Südostasiens sowie in Osteuropa und Griechenland.

Bevor Sie beginnen #

Sie benötigen einen eigenen Viber-Bot, und Viber stellt Bots nur noch im Rahmen eines kostenpflichtigen Business-Plans zur Verfügung. Seit Februar 2024 erstellt Viber keine kostenlosen Bots mehr. Sie richten das Konto direkt bei Viber ein, und dieses Konto sowie die damit verbundenen Gebühren liegen allein in Ihrer Verantwortung gegenüber Viber. Wir verkaufen es nicht weiter, schlagen keine Gebühren auf, erhalten keine Provision und können den Bot nicht in Ihrem Namen erstellen.

Zum Zeitpunkt der Erstellung dieses Dokuments erhebt Viber eine monatliche Gebühr pro Bot sowie eine Gebühr pro Nachricht für Nachrichten, die von Ihrem Bot initiiert werden (siehe Kosten unten). Überprüfen Sie die aktuellen Bedingungen von Viber bei der Anmeldung, da Viber die Preise jederzeit ändern kann.

Es gibt kein Self-Service-Anmeldeformular. Viber prüft jede Chatbot-Anwendung manuell. Sie können sich auf zwei Arten bewerben:

• Über einen verifizierten Viber-Partner, was der von Viber empfohlene und in der Regel schnellere Weg ist.
• Direkt bei Viber, per E-Mail an partners@viber.com. Wenn Sie bereits mit Viber zusammenarbeiten, kann Ihr Account Manager dies stattdessen in die Wege leiten.

Sobald Ihre Bewerbung genehmigt wurde, unterzeichnen Sie die Vereinbarung von Viber und akzeptieren deren Geschäftsbedingungen. Danach wird Ihr Bot erstellt.

Danach finden Sie das Token in der Viber-App unter Mehr → Einstellungen → Bots → Info bearbeiten → Ihr App-Schlüssel. Viber nennt es Ihren App-Schlüssel; in deren API-Dokumentation wird derselbe Wert als Authentifizierungs-Token bezeichnet, und Bot-Administratoren können ihn auch im eigenen Admin-Panel von Viber einsehen. Unabhängig von der Bezeichnung ist dies der einzige Wert, den diese App abfragt.

Dieses Token ist das Einzige, was Sie von Viber benötigen. Die Einrichtung hier dauert etwa eine Minute.

Einrichten von Viber #

Schritt 1: Kopieren Sie das Authentifizierungs-Token Ihres Bots #

Am schnellsten finden Sie ihn in der Viber-App auf Ihrem Telefon.

1. Öffnen Sie Viber auf dem Telefon, dessen Konto der Bot gehört.
2. Gehen Sie zu Mehr → Einstellungen → Bots.
3. Wählen Sie Ihren Bot aus und tippen Sie auf Info bearbeiten.
4. Kopieren Sie den Wert, der unter Ihr App-Schlüssel angezeigt wird. Das ist das Token.

Halten Sie dieses Token privat. Jeder, der es besitzt, kann Nachrichten als Ihr Bot senden.

Schritt 2: Verbinden Sie Viber in der App #

1. Klicken Sie in der linken Seitenleiste unten auf Einstellungen.
2. Klicken Sie in der linken Einstellungsleiste unter Kanäle auf Kanäle.
3. Suchen Sie die Viber-Karte und klicken Sie auf Verbinden.
4. Fügen Sie Ihr Auth-Token ein.
5. Klicken Sie auf Verbinden.
6. Die App überprüft das Token bei Viber und zeigt “Verbunden mit: <Ihr Bot-Name>” an.

Es muss kein Webhook eingerichtet werden. Im Gegensatz zu den meisten anderen Kanälen registrieren wir im Rahmen der Verbindung alles bei Viber für Sie, sodass Sie nichts in eine andere Konsole kopieren müssen. Der Verbindungsbildschirm zeigt die Adresse an, unter der Ihre Nachrichten eingehen, damit Sie diese bei Bedarf an den Support weitergeben können.

Schritt 3: Den Bot testen #

1. Öffnen Sie Viber auf einem anderen Telefon und folgen Sie Ihrem Bot (suchen Sie danach oder verwenden Sie den Link).
2. Senden Sie ihm eine Nachricht.
3. Öffnen Sie die App und gehen Sie zu Chats. Die eingehende Nachricht erscheint in der Konversationsliste.
4. Wenn ein KI-Agent diesen Kanal verwaltet, sehen Sie, wie er automatisch antwortet.

Sobald die Verbindung hergestellt ist, wird Ihr Viber-Bot auf der Kanäle-Seite als Verbunden angezeigt und die KI antwortet auf eingehende Nachrichten.

Wen Ihr Bot benachrichtigen kann #

Dies ist der wichtigste Punkt, den Sie über Viber wissen müssen, und er unterscheidet sich von jedem anderen Kanal:

Ihr Bot kann nur Personen benachrichtigen, die ihm folgen. Jemand muss Ihren Bot finden und ihm folgen, bevor Sie ihm etwas senden können. Es gibt keine Möglichkeit, einem Viber-Benutzer eine Nachricht zu senden, der Ihrem Bot nicht zuerst gefolgt ist.

Wenn jemand Ihrem Bot nicht mehr folgt oder ihn blockiert, können Sie ihm erst wieder eine Nachricht senden, wenn er dem Bot folgt und Ihnen eine Nachricht schreibt. Wenn dies geschieht, markiert die App die Konversation, sodass keine weiteren Versuche unternommen werden. Jede Antwort, die Sie senden, wird als fehlgeschlagen mit einer Erklärung angezeigt, anstatt stillschweigend zu verschwinden.

Aus diesem Grund eignet sich Viber sehr gut als Support- und Antwortkanal (jemand schreibt Ihnen, die KI antwortet) und schlecht als Kanal für Kaltakquise.

Kosten #

Viber ist ein kostenloser Kanal in der App: keine Gebühr pro Nachricht und keine monatliche Verbindungsgebühr von unserer Seite.

Ihre Kosten entstehen bei Viber über Ihr eigenes Konto:

• Eine monatliche Gebühr pro Bot (zum Zeitpunkt der Erstellung dieses Dokuments etwa 100 €).
• Antworten innerhalb einer von einer Person begonnenen Konversation sind kostenlos und unbegrenzt. Dies deckt fast alles ab, was ein KI-Agent tut.
• Nachrichten, die Ihr Bot initiiert, außerhalb einer Konversation, die die Person begonnen hat, werden pro Nachricht zu einem Tarif berechnet, der vom Land des Empfängers abhängt.

Das praktische Fazit: Die Beantwortung von Nachrichten kostet Sie außer der monatlichen Gebühr nichts. Broadcasts und proaktive Nachfassaktionen sind das, was ins Geld geht.

Mediennachrichten #

Eingehende Fotos, Videos, Dateien, Sticker, Standorte und geteilte Kontakte werden erkannt, sodass die KI weiß, dass Medien gesendet wurden (ein kurzer Hinweis wird der Konversation hinzugefügt). Ausgehende KI-Antworten sind in dieser Version Text und Bilder. Lange Antworten werden automatisch auf das Viber-Limit von 7.000 Zeichen gekürzt.

Sitzungsverwaltung #

Überprüfen des Verbindungsstatus #

Ihr Viber-Verbindungsstatus wird auf der Viber-Karte auf der Kanäle-Seite angezeigt:

Die Karte überprüft Ihren Bot jedes Mal neu, wenn Sie die Seite „Kanäle“ öffnen. Ein Viber-Bot kann seine Nachrichten immer nur an einen Ort gleichzeitig senden. Wenn Sie denselben Bot also mit einem anderen Tool verbinden, übernimmt dieses Tool die Kontrolle und Ihre Nachrichten kommen hier ohne Vorwarnung von Viber nicht mehr an. Genau das bedeutet „Verbunden, Aktion erforderlich“. Öffnen Sie die Karte und stellen Sie die Verbindung erneut her, um die Kontrolle zurückzugewinnen.

Trennen der Verbindung #

Öffnen Sie die Viber-Karte, klicken Sie auf Verwalten und dann auf Trennen. Bestätigen Sie anschließend mit Viber entfernen?. Dies verhindert, dass wir Nachrichten des Bots empfangen, und entfernt ihn aus Ihrem Konto. Ihr Bot bleibt weiterhin in Ihrem Besitz. An Ihrem Viber-Konto ändert sich nichts.

Einschränkungen #

• Nur Follower. Ihr Bot kann nur Personen Nachrichten senden, die ihm folgen. Siehe Wem Ihr Bot Nachrichten senden kann.
• Sie benötigen einen eigenen kostenpflichtigen Viber-Bot. Wir können keinen zur Verfügung stellen.
• Ein Bot pro Verbindung. Verbinden Sie jeden Bot separat; ein Bot kann nur mit einem Konto verknüpft sein.
• Versand von Text + Bildern. Die KI antwortet mit Text und Bildern; Karussells und Rich Cards werden in dieser Version nicht gesendet.
• Keine Willkommensnachricht. Wenn jemand Ihren Bot zum ersten Mal öffnet, ihm aber noch nicht folgt, erlaubt Viber eine einzelne sofortige Begrüßung. Diese Version sendet keine solche Nachricht. Das Gespräch beginnt, sobald die Person ihre erste Nachricht sendet.

Fehlerbehebung #

Token beim Verbinden abgelehnt #

• Stellen Sie sicher, dass Sie den Wert aus Edit Info → Your app key in der Viber-App kopiert haben und nicht eine andere ID.
• Überprüfen Sie, ob Ihr Bot in Ihrem Viber-Konto noch aktiv ist.
• Beim Verbinden wird auch geprüft, ob Viber uns erreichen kann. Wenn Ihr Token definitiv korrekt ist und es dennoch fehlschlägt, warten Sie eine Minute und versuchen Sie es erneut. Kontaktieren Sie andernfalls den Support.

„Dieser Viber-Bot ist bereits mit einem anderen Konto verbunden“ #

Derselbe Bot ist in der App mit einem anderen Konto verknüpft. Trennen Sie ihn dort zuerst oder verwenden Sie einen anderen Bot.

Bot antwortet nicht #

• Bestätigen Sie, dass die Karte Verbunden anzeigt und nicht Verbunden, Aktion erforderlich.
• Bestätigen Sie, dass die Person, mit der Sie testen, Ihrem Bot gefolgt ist. Viber stellt nur Nachrichten von Followern zu.
• Prüfen Sie, ob diesem Kanal ein KI-Agent zugewiesen ist.

Nachrichten kommen nicht mehr an #

Dies ist fast immer das unter Verbindungsstatus prüfen beschriebene Übernahmeproblem: Derselbe Bot wurde mit einem anderen Tool verbunden. Öffnen Sie die Viber-Karte und stellen Sie die Verbindung erneut her.

Eine Antwort schlug mit „Not Subscribed“ fehl #

Die Person hat Ihrem Bot entfolgt oder ihn blockiert. Sie können ihr erst wieder Nachrichten senden, wenn sie dem Bot erneut folgt und Ihnen zuerst eine Nachricht schreibt.

Best Practices #

• Fokus auf Support, nicht auf Outreach. Antworten innerhalb eines von jemandem begonnenen Gesprächs sind kostenlos und unbegrenzt; Nachrichten, die Sie initiieren, sind kostenpflichtig und erreichen nur Follower.
• Machen Sie es einfach, Ihrem Bot zu folgen. Platzieren Sie den Link auf Ihrer Website, in Ihrer E-Mail-Signatur und in Ihren anderen Kanälen. Dem Bot zu folgen ist der einzige Weg, wie Personen ihn erreichen können.
• Bewahren Sie Ihr Authentifizierungs-Token sicher auf. Jeder, der es besitzt, kann als Ihr Bot Nachrichten senden. Generieren Sie es in der Viber-App neu, falls es in falsche Hände gerät, und verbinden Sie es dann hier erneut.
• Verbinden Sie denselben Bot nicht mit zwei Tools. Das zweite Tool übernimmt die Kontrolle lautlos.