Viber Messaging Integration

Setup

You will need:

A Viber bot account. Make a note of the auth token.
An active webhooks server that can receive POST requests from Viber. Viber provides a Node.js utility for handling these requests.

In Courier, navigate to the Viber Integration page, enter your auth token and sender name, then click “Save.”

Webhooks Server

Before sending notifications, Viber requires a webhooks server to be registered:

curl -X POST 'https://chatapi.viber.com/pa/set_webhook' \
     -H 'Content-Type: application/json' \
     -H 'X-Viber-Auth-Token: VIBER_AUTH_TOKEN' \
     -d '{ "url": "YOUR_WEBHOOK_SERVER_URL", "event_types": ["delivered"] }'

This server will receive events from Viber such as UserIDs of users who subscribe, as well as delivery status events.

Profile Requirements

To send a direct message to a user, supply the Viber UserID to the viber.receiver property of the recipient profile. The recipient must have an active Viber account. The UserID is sent to your webhooks server after a user messages the Viber bot.

{
  "message": {
    "to": {
      "viber": {
        "receiver": "12943673=="
      }
    }
  }
}

Overrides

Body Overrides

You can override the request body that Courier sends to the Viber Send Message API.

{
  "message": {
    "template": "NOTIFICATION_TEMPLATE_ID",
    "to": {
      "viber": {
        "receiver": "12943673=="
      }
    },
    "providers": {
      "viber": {
        "override": {
          "body": {
            "type": "picture",
            "media": "https://example.com/image.jpg"
          }
        }
      }
    }
  }
}

Config Overrides

You can swap the auth token, sender name, or API URL at send time:

{
  "message": {
    "template": "NOTIFICATION_TEMPLATE_ID",
    "to": {
      "viber": {
        "receiver": "12943673=="
      }
    },
    "providers": {
      "viber": {
        "override": {
          "config": {
            "token": "RUNTIME_AUTH_TOKEN",
            "name": "My Bot Name"
          }
        }
      }
    }
  }
}

​Setup

​Webhooks Server

​Profile Requirements

​Overrides

​Body Overrides

​Config Overrides