Viber-chattbot för kundtjänst: så fungerar den och så sätter du upp den

Din bot identifieras av en autentiseringstoken. Varje anrop till REST Bot API måste innehålla den i en HTTP-header som heter X-Viber-Auth-Token; utelämnar du den får du felet missing_auth_token. Du registrerar en publik HTTPS-webhook med set_webhook, Viber postar callbacks till den när saker händer, och du svarar med send_message.

När du anropar set_webhook kontrollerar Viber din URL genom att skicka en callback med händelsen webhook till den. Kontrollen går bara igenom om din server svarar med HTTP-status 200. Ett lyckat svar på set_webhook har status 0; en URL som inte kan nås returnerar status 1, invalidUrl.

1. Kunden öppnar din bot via en länk på din webbplats, och Viber skickar en conversation_started-callback.
2. Din bot skickar ett välkomstmeddelande med knappar för vanliga ämnen.
3. Kunden svarar, vilket gör att hen börjar prenumerera, och din bot tar emot en message-callback.
4. Boten besvarar enkla frågor och samlar in uppgifter för allt annat.
5. Fall som inte löses blir ärenden i helpdesken, och agenternas svar går tillbaka via send_message.

Webhook-URL:en måste använda SSL med ett giltigt certifikat från en betrodd certifikatutfärdare. Den valfria listan event_types i set_webhook styr vilka callbacks du tar emot, men vissa kan inte stängas av.

Viber signerar varje callback. Headern X-Viber-Content-Signature innehåller en HMAC-SHA256 av begärans body, med din autentiseringstoken som nyckel, så kontrollera den innan du behandlar något. Om din webhook inte returnerar HTTP 200 försöker Viber skicka callbacken flera gånger, så se till att en upprepad callback inte skapar ett dubblettärende.

Den här regeln formar varje supportflöde i Viber: din bot kan bara skicka meddelanden till användare som prenumererar. En conversation_started-händelse är ingen prenumeration. Den tillåter ett välkomstmeddelande, som Viber säger att du bör skicka inom 5 minuter via send_message, med parametern receiver. Händelsen utlöses också för användare som redan prenumererar.

En användare börjar prenumerera genom att skicka ett meddelande till boten. Det första meddelandet utlöser en message-callback, inte en subscribed-callback, så spara användar-ID:t från båda händelserna. Användare kan avsluta prenumerationen när som helst, vilket omedelbart blockerar fler meddelanden från boten, och du får en unsubscribed-callback med deras ID. Om de börjar prenumerera igen raderas allt sammanhang och all tracking_data för konversationen.

För att starta konversationer från din webbplats använder du en djuplänk i formatet viber://pa?chatURI= följt av botens URI. Om du lägger till en context-parameter skickas ett värde, till exempel sidan kunden kom från, med in i conversation_started-callbacken. Viber påpekar att vissa webbläsare kanske inte känner igen djuplänken. För meddelanden om driftavbrott skickar broadcast-API:et till upp till 300 mottagare per anrop, och alla som inte prenumererar returneras som misslyckade (failed).

En begäran till send_message anger mottagaren (receiver, användar-ID:t), meddelandetypen och ett sender-objekt vars namn är obligatoriskt och begränsat till 28 tecken. Textmeddelanden kan vara upp till 7 000 tecken. Två valfria fält är användbara för support: tracking_data (upp till 4 096 tecken), som Viber skickar tillbaka med användarens svar och som därför kan innehålla ett ärende-ID eller det aktuella steget i ett flöde, och min_api_version, den lägsta klient-API-version som krävs för meddelandet, som är 1 som standard.

Tangentbord kan fästas vid alla meddelandetyper via fältet keyboard. Varje knapp har en ActionType:

• reply (standard) skickar knappens svar till boten.
• open-url öppnar en URL, i Viber eller i en extern webbläsare beroende på OpenURLType, och skickar URL:en till boten.
• location-picker, share-phone och none är också tillgängliga.

Två tangentbordsinställningar hjälper supportflöden. InputFieldState satt till hidden tar bort textfältet när du vill att kunderna ska välja en knapp, och DefaultHeight satt till true håller tangentbordet på samma höjd som det inbyggda tangentbordet.

Per oktober 2026 anger Vibers utvecklardokumentation att ”sedan 5.02.24 kan Viber-bottar endast skapas på kommersiella villkor”, med ansökningar som går direkt till Rakuten Viber eller via dess verifierade officiella partner. Fråga Viber eller en partner om aktuella priser innan du bygger. Svaret från send_message innehåller också ett fält för faktureringsstatus som visar hur varje meddelande har kategoriserats för debitering.

För överlämning till agenter listar Zendesk Viber bland de kanaler som finns tillgängliga via Sunshine Conversations. Att lägga till Sunshine Conversations-kanaler i Agent Workspace kräver Suite Professional eller högre, och du måste också använda messaging och Agent Workspace. Meddelanden blir då ärenden, och agenternas svar går tillbaka till kunden. Utan det är det vanliga mönstret en liten tjänst som skapar ärenden via helpdeskens API och skickar agenternas svar med send_message.

TascaLabs listade botkanaler är webbplats, telefon, WhatsApp, Telegram, Facebook Messenger och Instagram. Viber finns inte på den listan, men andra kanaler med ett API kan avgränsas under det kostnadsfria Health Check-samtalet på 30 minuter. TascaLab bygger ovanpå de verktyg du redan använder, till exempel Zendesk, Freshdesk, Jira och Slack, via API:er, webhooks och Make eller n8n. En Starter Chat Bot kostar 4 000 kr för en eller två kanaler och en Standard Chat Bot 5 700 kr för tre till fem. Varje projekt omfattar 30 dagars support efter lansering och grundläggande dokumentation, utan dolda avgifter, och de flesta uppsättningar tar 1–3 veckor.