Viber

The Viber channel integrates Open Astra agents into your Viber Public Account. Agents respond to direct messages via the Viber Bot API. Viber has over 1 billion users and is especially popular in Eastern Europe and Southeast Asia.

Setup

Go to the Viber Partner Portal and create a bot account
Copy the Auth Token from the bot dashboard — this is your VIBER_AUTH_TOKEN
Set the webhook URL to your Astra gateway: https://your-domain/channels/viber
Add to your environment:

bash

VIBER_AUTH_TOKEN=your-auth-token
VIBER_BOT_NAME=Your Bot Name

Configuration in astra.yml

yaml

channels:
  viber:
    enabled: true
    authToken: your-auth-token   # Overrides VIBER_AUTH_TOKEN
    botName: Your Bot Name       # Overrides VIBER_BOT_NAME

Features

Direct messages — agents respond to 1:1 messages from Viber users
Rich media — structured responses support Viber's keyboard and carousel formats
Quick reply keyboards — agent suggestions can be surfaced as Viber custom keyboards
Auth token verification — all incoming webhooks are verified against the auth token

Environment Variables

Variable	Required	Description
`VIBER_AUTH_TOKEN`	Yes	Bot auth token from the Viber Partner Portal
`VIBER_BOT_NAME`	No	Display name for the bot in Viber

ℹViber requires a publicly accessible HTTPS endpoint. In development, use a tunnel like ngrok: ngrok http 3000.