You can connect both a Viber bot and the company number in Viber to Skynum — the latter is the Viber number channel. We recommend the bot: it is Viber's official tool for businesses. Viber number suits you if customers already write to the company number or you need to write to customers first. The article describes both ways.

Customers' messages from Viber arrive in Skynum. The manager replies from a computer, sees the product's price and stock balance right there, and creates the order right in the chat.

Advantages common to the bot and the Viber number channel:

  • The whole team replies. Several managers handle customers from Viber at the same time, each from their own computer.
  • A sale without switching windows. The manager creates an order in the same chat where the customer decided to buy.
  • A product photo with the price in a minute. The manager finds the product in the Skynum catalog, sees how much is left, and sends the customer a photo with the price.
  • The counterparty is identified automatically. If the customer's number is recorded in Skynum for only one counterparty, the conversation is linked to them, and the manager knows who they are talking to. The bot learns the number when the customer shares it.
  • The chat in the counterparty card. Open the counterparty and you will see the Viber conversation next to their orders, payments and calls.
  • Conversations belong to the company. When a manager leaves, their chats with customers remain in Skynum, and another employee takes them over.
  • The customer's files are always at hand. Skynum keeps photos and documents up to 20 MB together with the conversation, so they open from the chat even a year later.
  • Each chat has its own manager. The conversation is handled by the employee assigned to it, and the head of the team knows who is responsible for the customer.
  • How much Viber earns. Reports show the revenue from sales via Viber, the cost of goods sold and the profit.

Viber chats are handled in the Messenger section — next to chats from Instagram, Facebook, WhatsApp, Telegram, the website and the Prom and Rozetka marketplaces. The manager works with one list of conversations and does not need to keep Viber open on the phone.

Orders from conversations, reply templates and chat statuses are described in the article Messenger. In Viber, all of this works the same way as in other channels.

Below — a comparison of the bot and the Viber number channel, connecting each of them, the specifics of Viber conversations, how to invite a customer to the bot and how to write to a customer first.

Bot or Viber Number

Viber bot — your company's official chat in Viber with its name and logo. The customer opens the bot by a link or from its page in Viber.

Viber number — a company number on which Viber runs. For the customer, it is a regular contact in Viber. The E-chat service connects the number to Skynum.

Way
Advantages
Disadvantages
Viber bot
No risk of being banned: the bot replies only to customers who contacted it themselves. The chat shows the company name and logo. No phone is needed for work. The bot can ask for the number, and the customer shares it with one button.
You cannot write to a customer who has not opened the bot yet. The bot is paid: Viber creates it on application, and maintenance is paid monthly. Viber charges for replies sent more than 24 hours after the customer's last message.
Viber number
You can write to a customer first. Customers write to a number they already know. The customer's number is known from the first message. The chat shows when the customer called in Viber. Replies from the company phone also get into the chat.
Viber can ban the number for mass messages to strangers: start up to 20 new dialogs a day, and fewer from a new number. E-chat is a paid service.

The two ways do not exclude each other: the bot and the number are connected as two separate integrations.

Connecting a Viber Bot

To connect, you need a bot in Viber and its token. If the company already has a bot, go to the "Bot Token" subsection.

Create a Bot in Viber

Viber creates a new bot only on an application submitted by one of its partners. Bot maintenance is paid; the partner will name the terms and the price.

  1. Open the Viber partners page. In the filters, choose the Viber Chatbots product and the country Ukraine — the partners that help apply for a bot in Ukraine remain.
  2. Choose a partner and make sure they create bots specifically: most Viber partners only do sender names and mailings. Leave the partner an application for a bot.
  3. Prepare the bot's name, logo and address: this is what the customer sees in Viber, and the address opens the chat with the bot.
  4. When Viber approves the application, the bot is created, and its admin gets access to the bot settings in Viber.

Bot Token

The token is visible to the bot admin. In Viber on the admin's phone, open More → Settings → Bots → Edit Info and copy the Your app key value — this is the token. Keep the token secret: with it, anyone can write to your customers on behalf of the bot.

Is the bot already connected to another service? You do not need a new one: first disconnect the bot there, then connect it to Skynum.

Connect the Bot in Skynum

The bot is ready — now go to Skynum. In the platform, open Settings → Integrations → Messengers, click Add Integration and choose Viber bot in the list.

The form for a new integration opens. Fill in the fields:

  • Integration name — the bot's label in the list of integrations and in the Messenger section.
  • Integration Active — turn it on: without it, Skynum will not receive the bot's messages.
  • Sales channel — the channel Skynum assigns the bot's chats and the orders created from them to; reports count sales from Viber by this channel.
  • Pricing Type — the price the customer will see next to a product in the chat and at which the product is added to the order. For a new integration, Skynum sets the company's main pricing type.
  • Default Executor — (optional) the employee Skynum assigns every new chat of the bot to.
  • Notification sound — choose Yes for Skynum to play a sound for every new message to the bot.
  • Send notifications only to — (optional) the employees Skynum sends notifications about new messages to the bot to. If you leave the field empty, everyone with access to the chats of this integration sees the notification.
  • Request the phone number — turn it on if you want the bot to find out the customer's number; how it works is described below, in the subsection "The Bot Asks the Customer for a Number".
  • Bot messages language — the language of the request to share the number: Українська, Русский or English.
  • Legal entity, branch — which branch or legal entity to assign the bot's chats to; employees with access to it will work with them.
  • Token — paste the Your app key from the bot settings in Viber.

Do not fill in Account — Skynum enters the bot's address there itself.

Click Save. The bot's address in Viber appears in the Account field, and its name and photo under it: the bot is connected. If Skynum shows API token is empty or invalid, copy the token again and save the integration once more.

Link to the bot:

viber://pa?chatURI=+Account

For example viber://pa?chatURI=myshop

Open the link on your phone and write to the bot as a regular customer — in a few seconds, the conversation appears in the Messenger section.

The Bot Asks the Customer for a Number

For the bot to ask the customer for their number, turn on Request the phone number in the integration, and choose the language of this request in the Bot messages language field.

A customer who has opened the chat with the bot receives a request with the Share phone number button. If they tap it, the number arrives in the chat. When the number is recorded in Skynum for only one counterparty, the chat is linked to them; otherwise the manager chooses the counterparty in the Counterparty field next to the conversation.

Connecting the Viber Number Channel

To connect a number, you need an E-chat account and a phone where Viber works with the company number. If you do not have an account, sign up for E-chat.

Connect the number the company uses for working with customers.

Add the Number in E-chat

In your E-chat account, click Connect Viber number. The Adding a Viber number window opens: choose the Skynum integration, enter the company number in the Phone number in international format field and click Add number.

A QR code appears on the screen. Point the Viber camera at it on the phone with the company number — as when logging in to Viber on a computer. After scanning, Viber on the phone works without changes. Instructions with pictures are in the E-chat help.

Important. E-chat appears among the devices in Viber on the phone. Keep this device: if you remove it, Skynum will stop receiving customers' messages.

Expand the Connected numbers and accounts block in your E-chat account — the number appears among the Viber numbers. Copy the API key next to the number.

Does the number already work in E-chat with another CRM? Then you do not need to add it — update the key. In the number's row, click the gear icon, in the Number settings window click Update next to the API key field and copy the new key: from this moment, the previous CRM no longer receives the number's conversations.

Connect the Number in Skynum

The number is ready — now go to Skynum. In the platform, open Settings → Integrations → Messengers, click Add Integration and choose Viber number in the list.

The form for a new integration opens. Fill in the fields:

  • Integration name — the number's label in the list of integrations and in the Messenger section.
  • Integration Active — turn it on: without it, Skynum will not receive messages to the number.
  • Sales channel — the channel Skynum assigns the number's chats and the orders created from them to; reports count sales from Viber by this channel.
  • Pricing Type — the price the customer will see next to a product in the chat and at which the product is added to the order. For a new integration, Skynum sets the company's main pricing type.
  • Default Executor — (optional) the employee Skynum assigns every new chat of the number to.
  • Notification sound — choose Yes for Skynum to play a sound for every new message to the number.
  • Send notifications only to — (optional) the employees Skynum sends notifications about new messages to the number to. If you leave the field empty, everyone with access to the chats of this integration sees the notification.
  • Legal entity, branch — which branch or legal entity to assign the number's chats to; employees with access to it will work with them.
  • Phone number — the company number with the country code, for example +380 67 123 45 67.
  • API Key — the number's key from your E-chat account.

Do not fill in Account — Skynum enters the number there itself.

Click Save — the Check Connection button appears in the integration. Click it — Skynum shows the message Connection successfully verified. If the check failed, compare the number and the key in Skynum and in E-chat, correct them and try again.

Finally, send a message to the company number from your personal Viber — in a few seconds, it appears in the Messenger section.

Conversations in Viber

Viber chats appear in the Messenger section together with the chats of other channels. Open a chat — the counterparty, status and sales channel are shown next to the conversation. From there, the manager creates an order or a task with the Create button and sends a product from the catalog or a ready reply from the templates to the chat. See details in the article Messenger.

What Comes from the Customer

  • To a bot chat — text, photos, videos, documents, stickers, locations and contacts.
  • To a number chat — text, photos, videos, voice messages and documents. A contact from the customer arrives as text with the name and number.

Skynum keeps the customer's files up to 20 MB, and they open from the chat at any time. For a larger file in a bot chat, only its name and size are shown — ask the customer for a link to it. In a number chat, a larger file arrives as a link that opens for 30 days: to keep the file, save it to your computer within this time.

What You Can Send to the Customer

  • In a bot chat — photos, documents and text up to 5000 characters. A photo with a caption of up to 768 characters reaches the customer as one message, a document with text as two: first the document, then the text. The customer can open the document in Viber for 30 days.
  • In a number chat — photos, documents and text up to 4096 characters. A photo or document with text reaches the customer as two messages: first the file, then the text.

You can send a product from the Skynum catalog to both bot chats and number chats: click the button with the box icon and choose the product. The catalog shows the stock balance, and the customer receives a photo of the product with the price of the type selected in the integration's Pricing Type field.

Each of the manager's messages has a status under it: Sent — the message has left Skynum; Delivered — it has reached the customer; Seen — in a bot chat, the customer has read it; in a number chat, the customer has replied.

Specifics of a Bot Chat

A bot chat starts with the label The client started the conversation — the customer has opened the bot. The manager can reply once the customer sends the first message.

If the customer forbids the bot to write to them, The client unsubscribed from messages appears in the chat, and the manager's replies will not reach them. When the customer writes to the bot again or allows it to write, The client subscribed to messages appears in the chat — send the undelivered message again with the Retry button under it.

Important. The bot's replies are free within 24 hours after the customer's last message; for later ones, the bot owner pays Viber. The chat shows when the customer last wrote.

How to Invite a Customer to the Bot Chat

Place a link to the bot on your website — on a button or in the text: the customer taps it on the phone and gets right into the chat. Invite customers who do not visit your website with a Viber mailing: it is delivered to the customer's phone number even if they have not opened the bot yet. For this, you need an SMS messaging service that also sends messages to Viber.

Open Counterparties → SMS and click New letter. In the Provider field, choose this service. In the Messenger field, write the invitation text. In the Button field, enter the button text, for example "Write to a manager", and paste the link to the bot into the Link field. Choose the recipients and click Submit.

The customer taps the button and gets to the bot, and their chat with the label The client started the conversation appears in the Messenger section. The manager can reply as soon as the customer writes the first message — and for the next 24 hours replies are free.

How to Write to a Customer First

You can write to a customer first from the Viber number channel. Sometimes an order from a website request is already packed, but the customer does not answer the phone. Write to them in Viber. Above the chat list in the Messenger section, click the pencil button — New conversation.

The New conversation window opens. In the Messenger field, choose the company number marked Viber number. On the Contragent tab, choose the customer and their number, or on the Any number tab, enter the number manually. Type the message and click Submit. The chat appears in the list, and the customer's reply will arrive there.

Important. Viber can ban a number used for mass messages to people who have not contacted you. E-chat recommends starting up to 20 new dialogs a day from one number, and no more than four from a number that has recently started working in Viber. The New conversation window shows how many dialogs have been started today.

Write first to those who are waiting to hear from you, and send news and promotions to everyone through SMS messaging.

All file formats and solutions to typical situations are collected in the help centre: for the bot — in the Viber Bot Integration section, for the number — in the E-chat Integration section.

Summary

Viber now works in Skynum: the customer writes to your bot or to the company number, the manager replies and sells from the chat, and reports show how much Viber earns. For the other chat features, see the article Messenger.