Channels integration

Viber

Viber AI integration
  • CategoryChannels
  • AuthAPI key

Overview

Connect a Viber Business Messages sender through Infobip so the AI agent can answer customers who message your business on Viber. Their messages arrive as conversations in Workspace > Main Inbox, and every reply, from you or the AI agent, goes out from your sender. MessageMind connects to Viber through Infobip, so you need your own Infobip account with an approved Viber sender before you start.

What MessageMind can do with it

  • Viber messages sent to your sender open conversations in Workspace > Main Inbox.
  • The AI agent answers those conversations from the same sender.
  • You and your team can reply from any Viber conversation with text or pictures.
  • The customer's phone number is saved on their contact. If that number already belongs to a contact, for example someone who wrote to you on WhatsApp or by SMS, the Viber conversation is added to that contact.
  • A campaign can start whenever a new Viber conversation opens, using the Conversation Created trigger with the channel set to Viber.

Requirements

  • An Infobip account with a Viber Business Messages sender. Infobip registers the sender and handles Viber's approval.
  • The Viber sender fee, about €100 a month, which Infobip bills to your Infobip account.
  • An Infobip API key and your Infobip Base URL.
  • Access to the Infobip portal, where you point incoming Viber messages at MessageMind.
  • A channel left on your MessageMind plan.

How to connect

  1. Go to Connections > Channels and click the Viber Business card. It is listed under the Messaging filter.
  2. In the How Viber is set up box below the form, copy the address that follows "To receive messages, set your Infobip inbound webhook to".
  3. In the Infobip portal, set that address as the inbound webhook for your Viber sender. The Infobip docs link in the same box opens Infobip's guide to Viber Business Messages.
  4. In Infobip, open Developer Tools > API keys. Copy an API key and the Base URL shown on that page.
  5. Back in MessageMind, type your sender in Viber sender exactly as it is registered on Infobip.
  6. Fill in Display name if you want a different name for this connection inside MessageMind (up to 28 characters). Customers see the sender name registered on Infobip. Avatar URL can stay empty.
  7. Under Your Infobip account, paste the key into Infobip API key and the Base URL into Infobip Base URL. You can leave out https://.
  8. Click Connect Viber. You see "Viber connected via Infobip." and the page switches to a Connected badge with your sender.
  9. From your own phone, send a Viber message to your business and see it arrive in Workspace > Main Inbox.

Authentication and permissions

Mechanism
You paste an Infobip API key and your Infobip Base URL into the form on the Viber page.
Credentials
Both are on the Developer Tools > API keys page of your Infobip account. The Base URL belongs to your account and looks like xxxxx.api.infobip.com.

Available data and actions

Reads

  • Text messages and pictures that customers send to your Viber sender.
  • The customer's phone number, which comes with each message.

Writes

  • Text and picture replies from you, your team or the AI agent, sent from your Viber sender.

AI agent use cases

  • On a Sunday evening a customer asks on Viber whether you are open tomorrow, and the AI agent answers from your sender.
  • A customer sends a photo of a damaged order with a short question. The picture shows in the conversation and the AI agent reads it along with the text.
  • Someone who usually messages you on WhatsApp writes on Viber from the same number. The conversation lands on their existing contact, so your team knows who it is.
  • You want your team, not the AI agent, to handle Viber for a while. Turn on Ignore all messages for Viber and answer those conversations yourselves.

Configuration

  • In AI Lab > AI Training, on the Prompt tab, pick Viber in the Channels menu of Behavioral Guidelines to write guidelines the AI agent follows only on Viber.
  • At the bottom of the same tab, Advanced Settings opens AI Exception Handling Rule. Pick Viber, then turn on Ignore all messages to keep the AI agent off Viber, or turn on Rule Status and write which Viber messages it should or should not reply to.
  • In Workspace > Campaigns, the Conversation Created trigger has Viber in its Channel list. Set Started by to Contact (inbound) to run a campaign only when a customer opens a new Viber conversation.

Example workflows

A customer writes to you on Viber

  1. The customer sends a message to your business in Viber.
  2. A Viber conversation appears in Workspace > Main Inbox, named after the customer's phone number.
  3. If the AI agent is handling the conversation, it replies from your sender.
  4. You open the conversation to follow along and type a reply whenever you want to step in.
  5. To give the contact a real name, edit it in the contact panel next to the conversation. Later Viber messages keep the name you set.

Switch to a new Infobip API key

  1. In Infobip, create a new key under Developer Tools > API keys and copy its value.
  2. In MessageMind, go to Connections > Channels and click the Viber Business card.
  3. Click Disconnect at the top right.
  4. Fill in the form again with the same sender, the new key and your Base URL, then click Connect Viber.
  5. Once you see "Viber connected via Infobip.", revoke the old key in Infobip.

Disconnect and reconnect

  • Go to Connections > Channels and click the Viber Business card.
  • Click Disconnect at the top right. You see "Viber disconnected."
  • MessageMind removes the sender, API key and Base URL you entered, and the AI agent stops replying on Viber.
  • Past Viber conversations stay in the Workspace.
  • Your Infobip account and Viber sender stay as they are.
  • To reconnect, click the card again and fill in the whole form, including the API key.