Viber Channel

Overview

The Viber channel connects a Viber Bot (or Business account) so subscribers appear in the Team Inbox alongside your other channels. Viber is widely used across Eastern Europe, Greece and South-East Asia, and it runs the same auto-reply, flows, AI agent and broadcasts as the rest of WaDesk — with Viber’s own keyboards and carousels for rich replies.

The simplest channel to connect. Viber needs one value — the authentication token — and WaDesk registers the webhook with Viber for you. There is no URL to copy anywhere.

How the Channel Works

  • Viber bots use the official Viber Bot REST API, authenticated with a single authentication token.
  • WaDesk calls Viber’s set_webhook for you at connect time, so inbound events arrive immediately — nothing to paste into Viber’s console.
  • Every delivery is signed by Viber and verified against your token before WaDesk accepts it.
  • People reach you by finding your bot in Viber search, scanning its QR code, or opening its deep link.

Creating the Bot & Getting the Token

The token comes from Viber’s own admin panel. Step by step:

  1. Open the Viber admin panel. Go to partners.viber.com and sign in. You will be asked to confirm with the Viber app on your phone, so keep it handy — the account is tied to your phone number.
  2. Create a bot. Choose Create Bot Account.
  3. Fill in the details. Upload an avatar, and give the bot a name, a URI (its unique handle), a category, a short description and your country. The name and avatar are what customers see.
  4. Create the account. Confirm and submit the form.
  5. Copy the token. Viber shows your authentication token once the bot exists — a long string like 4c04ba1b3fa1f3d0-1a2b3c4d5e6f7a8b-9c0d1e2f3a4b5c6d. Copy it. You can return to it later from the bot’s page in the panel.
The token is the bot’s password. Anyone holding it can send messages as your brand. If it leaks, regenerate it in the Viber panel and re-connect in WaDesk.
Bot vs Business account. A free Bot covers two-way chat and is what most teams need. Viber Business Messages (transactional/promotional messaging at scale, with per-message pricing) is a separate commercial product arranged with Viber or a partner.

Connecting in WaDesk

  1. Open the Viber pageChannels → Viber in the menu.
  2. Paste the authentication token and save.
  3. WaDesk registers the webhook automatically and fetches the bot’s name, avatar and URI, so nothing needs pasting back into Viber.
  4. Test it. Open your bot in the Viber app (search its name or use its deep link), press Subscribe, and send a message — it appears in the Team Inbox within seconds.
One webhook per bot. A Viber bot can point at only one webhook at a time. Connecting the same token in another tool will silently steal the events from WaDesk.

API Limits & Rules

RuleWhat it means
Subscriber requiredYou can only message users who have subscribed to your bot. A user who merely opened the chat but never subscribed cannot be messaged — WaDesk shows the thread but blocks the send with a clear reason.
No 24-hour windowOnce someone subscribes you can message them any time; there is no session expiry like WhatsApp.
Broadcast batch sizeViber’s broadcast endpoint accepts up to 300 recipients per call. WaDesk splits larger audiences into batches and paces them automatically.
UnsubscribeA user can unsubscribe at any time; sends to them fail and WaDesk skips them on the next broadcast.
Rate limitsViber throttles high-volume senders. WaDesk paces broadcasts to stay inside the limits rather than being blocked.

Using the Inbox

  • One thread per subscriber. Each Viber user who messages your bot gets a thread with their display name and avatar.
  • Media. Images, video, files, stickers, contacts and location messages render inline and can be replied to.
  • Read receipts. Viber reports delivery and seen status, so the inbox shows whether your message was actually read.
  • Keyboards and carousels. Buttons and multi-card carousels built in your flows or templates render natively in the Viber app.

Auto-Reply, Flows & AI

  • Auto-reply. Scope Welcome / Away / Out-of-hours / Keyword rules to your Viber bot in Auto Reply.
  • Flows. Set the Trigger node’s channel to Viber in the Flow Builder. Buttons, quick replies, media and question steps run on Viber.
  • AI agent. Assign an agent to the bot for automatic replies with hand-off to a human.

Viber Broadcasts

The Viber broadcast composer reaches every subscriber of your bot. Pick the bot, choose your audience, write the message with a live preview, and send. Because there is no 24-hour window you can reach your whole subscriber base — WaDesk batches the send at Viber’s 300-per-call limit, paces it to respect rate limits, and skips anyone who has unsubscribed.

Troubleshooting

SymptomCause & fix
No messages arrivingThe token is wrong or regenerated, or another tool has claimed the webhook. Re-paste a fresh token; WaDesk re-registers the webhook.
Webhook registration fails on saveViber requires a publicly reachable HTTPS URL with a valid certificate. A self-signed certificate, plain HTTP or an IP address will be rejected.
“Not subscribed” when replyingThat user opened the chat but never pressed Subscribe. You cannot message them until they do.
“Receiver is not registered”The user unsubscribed or removed the bot. They are skipped on future sends.
Broadcast slowExpected — WaDesk batches at 300 recipients and paces the calls so the bot is not throttled.
WaDesk Documentation