About

This is a small script that helps you to automatically send phone numbers in bulk to your VIBER Channel as contacts and thus reveal whether a certain phone number is associated with a registered VIBER account. There's no need in sharing your contacts with Viber. Overall it helps you with your Open Source Intelligence (OSINT) workflow on Messangers - specifically Viber.

It's not a full automation, you will need to do some things manually, but overall it saves more time by automating the most time consuming and dull task - adding phone numbers to the contact book

Install

git clone https://github.com/sgxgsx/ViberOSINT.git

pip install -r requirements.txt

Token

• Create a VIBER account
• Create a VIBER channel
• Use the following documentation to find your API token - https://developers.viber.com/docs/tools/channels-post-api/. You can find your token by entering your Channel’s info screen-> scroll down to “Developer Tools” -> copy token -> use the token for posting via API.
• Edit config.json in the repository and change [TOKEN] to your copied token
• Next time you are running the script, it'll automatically update the config file to include your UID and also would activate your channel api token by setting up a webhook.

Examples

• send a single phone number to a viber channel as a contact (this phone number has a registered Viber account)

python3 viber_contacts.py --phone +79124538669

• send a single phone number to a viber channel as a contact (this phone number doesn't have a registered Viber account associated with it)

python3 viber_contacts.py --phone +79124538670

• send phones in bulk

python3 viber_contacts --list phones.txt

After you ran a script:

• Open Viber Desktop and go to your VIBER channel
• Mostly always VIBER doesn't want to resolve contacts automatically, that's why you might need to do it manually or wait
• Account is unresolved if its name is still "a"

• In order to manually resolve the accounts you need to:
• Click on the "a" name on a popup contact. It'll take you to another view where the name of this contact would change
• If the name is a phone number and profile picture hasn't changed - it means that this phone number is not on Viber

• Otherwise, you'll see that the name of the contact is updated or you'll see a profile picture