# Viber Verbind je eigen **Viber-bot** zodat je Viber-gesprekken in de app binnenkomen en een AI-agent kan antwoorden. Je maakt verbinding door één waarde (het authenticatietoken van je bot) te plakken en wij regelen de rest van de configuratie voor je. --- ## Wat is de Viber-integratie? De Viber-integratie koppelt een **Viber-bot** waarvan jij de eigenaar bent aan het platform met behulp van de officiële Bot API van Viber, het eigen systeem van Viber voor het automatisch verzenden en ontvangen van berichten, in plaats van dat je ze handmatig typt. Gesprekken tussen je bot en de mensen die hem volgen worden beschikbaar in de app, en een AI-agent en een gedeelde inbox werken daarbovenop. Dit is een **officiële** integratie, dus deze is stabiel en voldoet aan de regels van Viber. > **Beschikbaarheid.** Viber wordt het meest gebruikt in de Filipijnen, Vietnam en andere delen van Zuidoost-Azië, en in heel Oost-Europa en Griekenland. --- ## Voordat je begint **Je hebt je eigen Viber-bot nodig en Viber geeft bots alleen uit op een betaald zakelijk abonnement.** Sinds februari 2024 maakt Viber geen gratis bots meer aan. Je zet het account rechtstreeks op bij Viber, en dat account en de bijbehorende kosten blijven tussen jou en Viber. Wij verkopen het niet door, rekenen geen opslag en nemen geen commissie, en we kunnen de bot niet namens jou aanmaken. Op het moment van schrijven rekent Viber een maandelijks bedrag per bot plus kosten per bericht voor berichten die je bot start (zie [Kosten](#cost) hieronder). Controleer de huidige voorwaarden van Viber wanneer je je aanmeldt, aangezien zij hun prijzen kunnen wijzigen. Er is geen aanmeldformulier voor zelfbediening. Viber beoordeelt elke chatbot-aanvraag handmatig en je kunt je op twee manieren aanmelden: - **Via een geverifieerde Viber-partner**, wat de route is die Viber aanbeveelt en meestal de snelste is. - **Direct bij Viber**, door een e-mail te sturen naar `partners@viber.com`. Als je al met Viber werkt, kan je accountmanager voor zakelijke accounts dit in plaats daarvan starten. Zodra je aanvraag is goedgekeurd, onderteken je de overeenkomst van Viber en accepteer je hun commerciële voorwaarden, waarna je bot wordt aangemaakt. Daarna vind je het token in de Viber-app onder **Meer → Instellingen → Bots → Info bewerken → Je app-sleutel**. Viber noemt dit je *app-sleutel*; hun API-documentatie noemt dezelfde waarde een *authenticatietoken*, en bot-beheerders kunnen deze ook zien in het eigen beheerderspaneel van Viber. Hoe het ook wordt genoemd, het is de enige waarde waar deze app om vraagt. Dat token is het enige wat je van Viber nodig hebt. De configuratie hier duurt ongeveer een minuut. --- ## Viber configureren ### Stap 1: Kopieer het authenticatietoken van je bot De snelste manier om het te vinden is via de Viber-app op je telefoon. 1. Open Viber op de telefoon van het account dat de bot bezit. 2. Ga naar **Meer → Instellingen → Bots**. 3. Selecteer je bot en tik op **Info bewerken**. 4. Kopieer de waarde die wordt weergegeven onder **Je app-sleutel**. Dat is het token. > Houd dit token privé. Iedereen die het heeft, kan berichten versturen als jouw bot. ### Stap 2: Verbind Viber in de app 1. Klik in de linkerzijbalk onderaan op **Instellingen**. 2. Klik in de linker kolom van Instellingen onder **Kanalen** op **Kanalen**. 3. Zoek de **Viber**-kaart en klik op **Verbinden**. 4. Plak je **auth token**. 5. Klik op **Verbinden**. 6. De app controleert het token bij Viber en toont **"Verbonden met: \"**. **Er hoeft geen webhook te worden ingesteld.** In tegenstelling tot de meeste andere kanalen, registreren wij alles bij Viber voor je als onderdeel van het verbindingsproces, dus er is niets dat je naar een andere console hoeft te kopiëren. Het scherm met de verbinding toont het adres waar je berichten binnenkomen, puur zodat je dit kunt delen met de ondersteuning als dat ooit nodig is. ### Stap 3: De bot testen 1. Open Viber op een andere telefoon en **volg je bot** (zoek ernaar of gebruik de link). 2. **Stuur een bericht.** 3. Open de app en ga naar **Chats**. Het inkomende bericht verschijnt in de gesprekslijst. 4. Als een AI-agent dit kanaal beheert, zul je zien dat deze **automatisch antwoordt**. Zodra de verbinding tot stand is gebracht, wordt je Viber-bot weergegeven als **Verbonden** op de Kanalen-pagina en reageert de AI op inkomende berichten. --- ## Wie je bot kan berichten Dit is het belangrijkste om te begrijpen over Viber, en het is anders dan bij elk ander kanaal: **Je bot kan alleen berichten sturen naar mensen die hem volgen.** Iemand moet je bot vinden en volgen voordat je diegene iets kunt sturen. Er is geen manier om een Viber-gebruiker te berichten die je bot niet eerst heeft gevolgd. Als iemand je bot ontvolgt of blokkeert, kun je diegene niet opnieuw berichten totdat diegene de bot weer volgt en een bericht stuurt. Wanneer dat gebeurt, markeert de app het gesprek zodat het stopt met proberen, en elk antwoord dat je verstuurt wordt als mislukt weergegeven met een uitleg in plaats van geruisloos te verdwijnen. Hierdoor werkt Viber erg goed als **ondersteunings- en antwoordkanaal** (iemand stuurt jou een bericht, de AI antwoordt) en slecht als kanaal voor koude acquisitie. --- ## Kosten Viber is een **gratis** kanaal in de app: geen kosten per bericht en geen maandelijkse verbindingskosten van onze kant. Je kosten komen van **Viber**, op je eigen account: - Een **maandelijks bedrag per bot** (ongeveer €100 op het moment van schrijven). - **Antwoorden binnen een gesprek dat iemand is gestart, zijn gratis en onbeperkt.** Dit dekt bijna alles wat een AI-agent doet. - **Berichten die je bot start**, buiten een gesprek dat de persoon zelf is begonnen, worden per bericht in rekening gebracht tegen een tarief dat afhangt van het land van de ontvanger. De praktische conclusie: het beantwoorden van mensen kost je niets buiten de maandelijkse vergoeding. Uitzendingen en proactieve follow-ups zijn de zaken die de kosten verhogen. --- ## Mediaberichten Inkomende foto's, video's, bestanden, stickers, locaties en gedeelde contacten worden herkend, zodat de AI weet dat er media is verzonden (er wordt een korte notitie aan het gesprek toegevoegd). Uitgaande AI-antwoorden zijn in deze versie **tekst en afbeeldingen**. Lange antwoorden worden automatisch ingekort tot de limiet van 7.000 tekens van Viber. --- ## Sessiebeheer ### Verbindingsstatus controleren De verbindingsstatus van je Viber wordt getoond op de **Viber**-kaart op de **Kanalen**-pagina: | Status | Betekenis | |---|---| | **Verbonden** | Een Viber-bot is gekoppeld aan dit account | | **Verbonden, actie vereist** | Iets anders heeft je bot overgenomen; berichten bereiken ons niet | | **Niet verbonden** | Geen verbinding ingesteld | De kaart controleert je bot opnieuw telkens wanneer je de pagina Kanalen opent. **Een Viber-bot kan zijn berichten slechts op één plek tegelijk afleveren**, dus als je dezelfde bot aan een andere tool koppelt, neemt die tool het over en komen je berichten hier niet meer aan, zonder waarschuwing van Viber. Dat is wat **"Verbonden, actie vereist"** betekent. Open de kaart en maak opnieuw verbinding om het beheer terug te krijgen. ### Verbinding verbreken Open de **Viber**-kaart en klik op **Beheren**, klik vervolgens op **Verbinding verbreken** en bevestig met **Viber verwijderen?**. Dit stopt het ontvangen van de berichten van de bot en verwijdert deze uit je account. Je bot zelf blijft van jou. Er verandert niets aan je Viber-account. --- ## Beperkingen - **Alleen volgers.** Je bot kan alleen berichten sturen naar mensen die hem volgen. Zie [Wie je bot kan berichten](#who-your-bot-can-message). - **Je hebt je eigen betaalde Viber-bot nodig.** Wij kunnen er geen leveren. - **Eén bot per verbinding.** Koppel elke bot afzonderlijk; een bot kan slechts aan één account worden gekoppeld. - **Tekst + afbeeldingen verzenden.** De AI antwoordt met tekst en afbeeldingen; carrousels en rich cards worden in deze versie niet verzonden. - **Geen welkomstbericht.** Wanneer iemand je bot voor het eerst opent maar deze nog niet volgt, staat Viber één begroeting toe. Deze versie verstuurt er geen. Het gesprek begint wanneer zij hun eerste bericht sturen. --- ## Probleemoplossing ### Token geweigerd bij het verbinden - Zorg ervoor dat je de waarde hebt gekopieerd uit **Edit Info → Your app key** in de Viber-app, en niet een ander ID. - Controleer of je bot nog steeds actief is op je Viber-account. - Bij het verbinden wordt ook gecontroleerd of Viber ons kan bereiken. Als je token absoluut correct is en het nog steeds mislukt, wacht dan een minuut en probeer het opnieuw, neem daarna contact op met de ondersteuning. ### "Deze Viber-bot is al verbonden met een ander account" Dezelfde bot is gekoppeld aan een ander account in de app. Verbreek daar eerst de verbinding of gebruik een andere bot. ### Bot antwoordt niet - Bevestig dat de kaart **Verbonden** toont, niet **Verbonden, actie vereist**. - Bevestig dat de persoon met wie je test je bot heeft **gevolgd**. Viber bezorgt alleen berichten van volgers. - Controleer of er een AI-agent is toegewezen aan dit kanaal. ### Berichten komen niet meer aan Dit is bijna altijd het overnameprobleem dat wordt beschreven onder [Verbindingsstatus controleren](#checking-connection-status): dezelfde bot is verbonden met een andere tool. Open de **Viber**-kaart en maak opnieuw verbinding. ### Een antwoord mislukte met "Niet geabonneerd" De persoon heeft je bot ontvolgd of geblokkeerd. Je kunt ze pas weer berichten sturen als ze de bot opnieuw volgen en eerst een bericht naar jou sturen. --- ## Best practices - **Focus op ondersteuning, niet op acquisitie.** Antwoorden binnen een gesprek dat iemand anders is gestart zijn gratis en onbeperkt; berichten die jij start worden in rekening gebracht en bereiken alleen volgers. - **Maak je bot makkelijk te volgen.** Plaats de link op je site, in je e-mailhandtekening en in je andere kanalen. Het volgen van de bot is de enige manier waarop mensen deze kunnen bereiken. - **Houd je authenticatietoken veilig.** Iedereen met dit token kan berichten sturen als jouw bot. Genereer het opnieuw in de Viber-app als het is gelekt en maak daarna hier opnieuw verbinding. - **Koppel dezelfde bot niet aan twee tools.** De tweede tool neemt de verbinding stilletjes over.