Skip to main content
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

FeatureSupported
1:1 messagesYes
Group messagesYes
Rich mediaYes
Keyboard buttonsYes
File attachmentsYes
WebhookYes

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

VIBER_AUTH_TOKEN=4a8e6b5c-...

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.