yowsup is a python library that enables building applications that can communicate with WhatsApp users. The project started as the protocol engine behind Wazapp for Meego and OpenWA for BB10. Now as a standalone library it can be used to power any custom WhatsApp client.

https://github.com/tgalal/yowsup

- python>=2.7,<=3.7
- consonance==0.1.3-1
- python-axolotl==0.2.2
- protobuf>=3.6.0
- six==1.10

Clone the git repository and execute the setup

git clone https://github.com/tgalal/yowsup.git
cd yowsup-master/
./setup.py install

WARNING

It seems that recently yowsup gets detected during registration resulting in an instant ban for your number right after registering with the code you receive by sms/voice. I'd strongly recommend to not attempt registration through yowsup until I look further into this. Follow the status of this here

Example:

yowsup-cli registration --requestcode sms --config-phone 49XXXXXXXX --config-cc 49 --config-mcc 123 --config-mnc 456
yowsup-cli registration --register 123456 --config-phone 49XXXXXXXX

CountryCode => Germany = 49
--config-cc 49

Mobile Country Code => Germany = 262
--config-mcc 262

Mobile Network Codes
--config-mnc 03
Most likely 01 - 03
01 	Telekom 	Telekom Deutschland GmbH 	
02 	Vodafone 	Vodafone D2 GmbH 	
03 	O2 	        Telefónica Germany GmbH & Co. oHG

Freenet / Klarmobil => 03
Freenet Funk => 07?!
0157 => Eplus => 03