Using Phone Number

It is possible to send messages to users using phone numbers they've associated with their Viber accounts. Viber calls this method Viber Business Messages.

📘

Viber Business Messages offer the only way to send a message to Viber using a phone number. You cannot use a phone number with a Viber Bot account.

How it Works

The advantage of Viber is that every Viber account is associated with a phone number. That means the delivery rate is quite high.

  1. User receives a request - push notification
  1. User confirms the message
  1. User receives the message

Prerequisites

You can create Viber Business Message channel but it has to be confirmed by Viber.

📘

Contact us at [email protected] if you are interested in Viber Business Messages.

Price

Viber charges for each delivered message. Price is different for each country and is usually around half the price for SMS. Contact us at [email protected] to get prices for your country. There is also a minimum payment required. The value is chosen regarding of a country selected (150/300/500 €/month).

Setup

1. Send Message

If you get a HTTP response 201 to your request, it means that the message was accepted to be processed by Viber, but it's not guaranteed that it will be delivered to the phone number. If Viber is unable to deliver the message (for example the when the phone number is not connected to any Viber account), you will receive Message Failed webhook.

Note that the phone number in response is in E.164 format.

{
  "contact": {
    "phone_number": "+1 (555) 857-6309"
  },
  "channel": {...},
  "content": {...}
}
{
  "id": "...",
  "contact": {
    "id": "15234390803083474",
    "phone_number": "15558576309"
  },
  "channel": {...},
  "content": {...}
}

See API reference for full documentation.

🚧

Message Types

Only certain message types (text, structure and image) can be send using phone number. See API reference for more details.

2. Listen to Message Delivered Webhook

When the message is delivered, you will receive a Messages Delivered webhook.

{
  "event": "messages_delivered",
  "timestamp" : "2017-12-29T17:26:17.331Z",
  "data" : {
    "channel": {
      "id": "6456078759331238786",
      "type": "viber_business_messages"
    },
    "contact": {
        "id": "6456078781510718339",
      "phone_number": "15558576309"
    },
    "messages": [
      { "id": "6456078996108088196" }, 
      { "id": "6456079002382766981" }
    ],
    "delivered_timestamp": "2017-12-29T17:26:16.001Z"
  }
}

3. (Optional) Listen to Message Failed Webhook

When the message fails to send, you will receive a Message Failed webhook. The most common reason of failure is that a given phone number doesn't have Viber account assigned.

{
  "event": "message_failed",
  "timestamp" : "2017-12-29T17:26:18.361Z",
  "data" : {
    "channel": {
      "id": "6456078759331238786",
      "type": "viber_business_messages"
    },
    "contact": {
      "id": "6456078781510718339",
      "phone_number": "15551111111"
    },
    "message": {
      "id": "6456078996108088196"
    },
    "error_code": 3,
    "reason": "Cannot find Viber user for given phone number."
  }
}