Note-

• You can send personalised campaigns only to the users for which you have a user identifier (phone number).
• Viber bot does not have phone number for your users by default. You can get the phone number in 2 ways -
  • You need to ask it explicitly from the user (by sending a broadcast message on Viber ID). 
  • You can access phone numbers directly, if you are a part of Viber's Business messages service. 

Step 1: Collect customer user IDs

To send messages in Viber, you need to collect your users' IDs to identify your user and interact with them consistently. User IDs are generated by Viber and can be used when interacting with Viber APIs. 

Step 2: Save user's Viber ID on MoEngage

Once you obtain a list of Viber user IDs, you will send them to MoEngage. 

• If you have a user identifier such as phone number, you can add them on MoEngage as a viber_id - custom tracked user attribute/property (like phone number). You can save this data to MoEngage either using:
  • User Data API or
  • Upload them using User Imports inside MoEngage.
    
• If you do not have any user identifier (meaning the user has not shared his personal details with your bot), you can upload them as Anonymous users.  
  

Step 3: Create Connector Campaign on MoEngage to send Viber Message

To create a connector campaign on MoEngage, 

1. Navigate to Create Campaign >> Connectors >> Custom and choose delivery type most suitable to your needs 

2. Choose Segment of users for whom viber_id exists (You can combine with other Segment criteria) 

3. On step 2 of the campaign, 

• Select method as POST
• Add Webhook URL as :

  https://chatapi.viber.com/pa/send_message

• In Headers, use

  X-Viber-Auth-Token: <Account authentication token>

  The authentication token is generated upon bot creation. You can view it in the “edit info” screen of your Viber admin panel.

  

• In Body, choose Raw and use the content depending on what kind of message type you want to send out. You can look at different types here.

Here are few content samples for different message types:

{
  "receiver": "01234567890A=",
  "min_api_version": 1,
  "sender": {
    "name": "John McClane",
    "avatar": "http://avatar.example.com"
  },
  "tracking_data": "tracking data",
  "type": "text",
  "text": "Hello world!"
}
        

{
  "receiver": "01234567890A=",
  "min_api_version": 1,
  "sender": {
    "name": "John McClane",
    "avatar": "http://avatar.example.com"
  },
  "tracking_data": "tracking data",
  "type": "picture",
  "text": "Photo description",
  "media": "http://www.images.com/img.jpg",
  "thumbnail": "http://www.images.com/thumb.jpg"
}
          

{
  "receiver": "01234567890A=",
  "min_api_version": 1,
  "sender": {
    "name": "John McClane",
    "avatar": "http://avatar.example.com"
  },
  "tracking_data": "tracking data",
  "type": "video",
  "media": "http://www.videos.com/video.mp4",
  "thumbnail": "http://www.images.com/thumb.jpg",
  "size": 10000,
  "duration": 10
}
          

Note- You can send up to 100 messages to a user in an hour without reply. The limit is reset when a user replies to a message. 

4. At this point, your campaign should be ready to test and send. You can also test your connector configuration using the Test functionality available on Step 2 of Create Connector Campaign

If your test user successfully receives the message, your set-up is good to go. You can go ahead and Publish the campaign.