:warning: This project is still under construction. Contributions are welcome.

:link: Links:

• :hammer_and_wrench: Installation
  • Maven
  • Gradle
• :eyes: Overview
• :eyes: Proxy
• :scroll: Examples (Proxy) - Direct proxy without authentication credentials: - With authentication credentials:
• :scroll: Examples (Sending messages)
  • Sending a simple text message
  • Sending a message with buttons (template)
  • Sending a message with a contact
  • Sending an interactive message with buttons
  • Sending an interactive message with a list
  • Sending an audio message
  • Sending a document message
  • Sending an image link message
  • Sending an image message
  • Sending a sticker message
  • Sending a video message
• :scroll: Examples (WhatsApp Business Management API)
  • Creating a message template
  • Managing phone numbers
  • Getting verification codes and verifying them.
• :arrow_down: WebHooks
• :paperclip: Media
  • Uploading media
  • Retrieving the URL for a specific media
  • Deleting media
  • downloading media
• :loudspeaker: Call to Action
• :hammer_and_wrench: Get Involved
• :open_file_folder: Examples folder

See javadoc

:hammer_and_wrench: Installation

:warning: this library is compatible with java 17+.

Maven

1. Add the JitPack repository to your build file:

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

2. Add the following Maven dependency to your project's pom.xml:

   <dependency>
      <groupId>com.github.Bindambc</groupId>
      <artifactId>whatsapp-business-java-api</artifactId>
      <version>v0.6.1</version>
   </dependency>

Gradle:

1. Add it in your root build.gradle at the end of repositories:

	allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

2. Add the dependency

	dependencies {
	        implementation 'com.github.Bindambc:whatsapp-business-java-api:v0.6.1'
	}

3. Install library into your Maven's local repository by running mvn install

Alternatively, you can clone this repository and run the examples.

:arrow_heading_up: back

:eyes: Overview

There are two client classes that can be used to interact with the API:

1. WhatsappBusinessCloudApi, a synchronous/blocking WhatsApp Business Platform Cloud API client;

Send and receive messages using a cloud-hosted version of the WhatsApp Business Platform. The Cloud API allows you to implement WhatsApp Business APIs without the cost of hosting of your own servers and also allows you to more easily scale your business messaging.

 WhatsappApiFactory factory = WhatsappApiFactory.newInstance(TestUtils.TOKEN);

 WhatsappBusinessCloudApi whatsappBusinessCloudApi = factory.newBusinessCloudApi(ApiVersion.V19_0);

2. WhatsappBusinessManagementApi, a synchronous/blocking WhatsApp Business Management API client;

The WhatsApp Business Management API allows you to programmatically manage your WhatsApp Business Account assets, such as message templates and phone numbers.

WhatsappApiFactory factory = WhatsappApiFactory.newInstance(TOKEN);

WhatsappBusinessManagementApi whatsappBusinessCloudApi = factory.newBusinessManagementApi(ApiVersion.V19_0);

These can be instantiated through the corresponding factory method of WhatsappApiFactory, by passing the token, which can be created following the instructions at whatsapp.

:arrow_heading_up: back

:eyes: Proxy

You can add a proxy to the api by calling the method setHttpProxy(...) of class WhatsappApiServiceGenerator

public static void setHttpProxy(String host, int port, String username, String pwd)

Call this method before create the api instance like:

// Set http proxy with credentials before the creation of the api instance
WhatsappApiServiceGenerator.setHttpProxy("<YOUR_PROXY_HOST>", "<YOUR_PROXY_PORT>", "<YOUR_PROXY_USERNAME>", "<YOUR_PROXY_PWD>");

// Create the api instance
WhatsappBusinessCloudApi whatsappBusinessCloudApi = factory.newBusinessCloudApi();

:scroll: Examples (Proxy):

Direct proxy without authentication credentials:

   WhatsappApiFactory factory = WhatsappApiFactory.newInstance(TestConstants.TOKEN);

        // Set http proxy without credentials before the creation of the api instance
        WhatsappApiServiceGenerator.setHttpProxy("localhost", 8080, null,null);
        
        WhatsappBusinessCloudApi whatsappBusinessCloudApi = factory.newBusinessCloudApi();
        var message = MessageBuilder.builder()//
                .setTo(PHONE_NUMBER_1)//
                .buildTextMessage(new TextMessage()//
                        .setBody(Formatter.bold("Hello world!") + "\nSome code here: \n" + Formatter.code("hello world code here"))//
                        .setPreviewUrl(false));

        MessageResponse messageResponse = whatsappBusinessCloudApi.sendMessage(PHONE_NUMBER_ID, message);

        System.out.println(messageResponse);

With authentication credentials:

 WhatsappApiFactory factory = WhatsappApiFactory.newInstance(TestConstants.TOKEN);

        // Set http proxy with credentials before the creation of the api instance
        WhatsappApiServiceGenerator.setHttpProxy("localhost", 8080, "username", "password");
        
        WhatsappBusinessCloudApi whatsappBusinessCloudApi = factory.newBusinessCloudApi();
        var message = MessageBuilder.builder()//
                .setTo(PHONE_NUMBER_1)//
                .buildTextMessage(new TextMessage()//
                        .setBody(Formatter.bold("Hello world!") + "\nSome code here: \n" + Formatter.code("hello world code here"))//
                        .setPreviewUrl(false));

        MessageResponse messageResponse = whatsappBusinessCloudApi.sendMessage(PHONE_NUMBER_ID, message);

        System.out.println(messageResponse);

:arrow_heading_up: back

:scroll: Examples (Sending messages)

Sending a simple text message:

 	WhatsappApiFactory factory = WhatsappApiFactory.newInstance(TestUtils.TOKEN);

        WhatsappBusinessCloudApi whatsappBusinessCloudApi = factory.newBusinessCloudApi();
	
        var message = MessageBuilder.builder()//
                .setTo(PHONE_NUMBER_1)//
                .buildTextMessage(new TextMessage()//
                        .setBody(Formatter.bold("Hello world!") + "\nSome code here: \n" + Formatter.code("hello world code here"))//
                        .setPreviewUrl(false));


        whatsappBusinessCloudApi.sendMessage(PHONE_NUMBER_ID, message);

Result:

:arrow_heading_up: back

[Sending a message with buttons (templa