On Viber, businesses chat with customers through a bot (a business account with its own name and picture). Customers open your bot and write to it; their messages arrive in the PALMS inbox. You paste the bot’s token once; PALMS checks it and points the bot’s messages to PALMS.
Before you start
- Viber on your phone, with the account that manages the bot.
- A Viber bot for your business — see get a bot.
- Access to the bot’s page in the Viber Partners portal, where its token is.
Get a bot
Since 2024, Viber creates new bots for businesses that accept its commercial terms (a monthly fee per bot). Bots created before keep working.
- Open Viber Partners and sign in with the Viber account on your phone.
- Create a bot account: name, picture, category and description. Or open your existing bot.
- If Viber asks for a commercial agreement, follow its steps. The bot is activated once Viber approves it.
Paste the token
- On the bot’s page in Viber Partners, find Token (sometimes “Authentication token”) and copy it.
- Paste it in PALMS and click Connect.
PALMS checks the token with Viber, shows your bot’s name and picture, stores the token encrypted and sets the bot’s webhook. A bot sends its messages to one address only: another tool that used this bot stops receiving them.
Test your connection
- Click Open the bot (or scan the QR code with your phone).
- Send the code PALMS shows.
- PALMS answers in Viber and the step shows a success tick.
What works on Viber
- Text, pictures, videos, files, stickers, contacts and locations arrive in the inbox. You can send text and pictures.
- A bot can only message people who wrote to it first (or subscribed). That’s always the case in your inbox.
- Viber may charge for messages under its commercial terms; see your agreement.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| Token refused | Copied partly, or the bot isn’t active yet | Copy it again; check the bot’s status in Viber Partners |
| “Needs a public address” | Viber only sends to https addresses | Ask your PALMS administrator to set the public URL |
| Messages stopped arriving | Another tool set its own webhook on the bot | Use Reconnect on the channel |
Reconnect
Use Reconnect on the channel and paste the token again (the same bot). Conversations stay as they are.