Viber

Connect profClaw to Viber via the Viber Bot API. Popular in Eastern Europe and Southeast Asia.

Viber is a messaging app with strong presence in Eastern Europe, the Middle East, and Southeast Asia. profClaw connects via Viber’s Bot API for business interactions.

Capabilities

Feature	Supported
1:1 messages	Yes
Group messages	Yes
Rich media	Yes
Keyboard buttons	Yes
File attachments	Yes
Webhook	Yes

Setup

1. Create a Viber Bot

   Go to partners.viber.com and create a bot account. You’ll receive an Authentication Token.

2. Set webhook

   Viber requires a webhook to receive messages. Set it via the API:

   curl -X POST https://chatapi.viber.com/pa/set_webhook \
     -H "X-Viber-Auth-Token: your-token" \
     -d '{"url": "https://your-domain.com/webhooks/viber"}'
   
3. Configure profClaw

   VIBER_AUTH_TOKEN=your-authentication-token
   

Environment Variables

VIBER_AUTH_TOKEN · string · required

Viber Bot authentication token from partners.viber.com.

Configuration Example

.env

VIBER_AUTH_TOKEN=4a8e6b5c-...

settings.yml

chat:
  viber:
    auth_token: "${VIBER_AUTH_TOKEN}"

Message Format

profClaw sends Viber text messages with optional keyboard buttons:

{
  "receiver": "user-id",
  "type": "text",
  "text": "How can I help you?",
  "keyboard": {
    "Type": "keyboard",
    "Buttons": [
      { "ActionType": "reply", "ActionBody": "help", "Text": "Help" }
    ]
  }
}

Notes

• Status: Beta
• Viber requires a public HTTPS webhook URL.
• The webhook must be set programmatically via the API (not a dashboard).
• Viber bots can only message users who have subscribed or messaged the bot first.
• Message broadcasting requires Viber partner approval for large audiences.

Related

• Chat Providers Overview - Compare all 27 supported channels
• LINE - Dominant messaging platform in Japan and Taiwan
• Messenger - Facebook Messenger for Western audiences
• profclaw channels - Enable and test the Viber connection from the CLI