Skip to content
forked from pathus90/watchap

Unofficial java wrapper to WhatsApp Cloud API

License

Notifications You must be signed in to change notification settings

vilsonnjr/watchap

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Watchap

UnOfficial java Wrapper for WhatsApp Cloud API

Built With

  • JDK 11 or higher.
  • Apache Maven 3.3.9 or higher

Getting Started

Prerequisites

To get started using this package, you will need some informations which you can get by from Facebook Developer Portal

  1. Go to your apps

  2. create an app

  3. Choose Bussiness as an app type

  4. Screen Name (This is the app name that is associated with your App ID. You can change it later.)

  5. Fill in the basic information such as password...

  6. Add products to your app and choose WhatsApp

  7. Copy your YOUR_TOKEN. This token will expire in 23 hours.

  8. Copy PHONE_NUMBER_ID, which will be used as the sender number

  9. create phonenumber of recipients to whom the messages will be delivered

    From this page, To send a test message, copy this command, paste it into Terminal, and click Enter. To create your own message template, click here.

Usage

Before starting to use the features of the library, you need to fill in the token retrieved from the facebook developer portal and the phone number which will be used as the sender's number.

Exemple

Watchap watchap = new Watchap(YOUR_TOKEN, PHONE_NUMBER_ID);

Features supported

  1. Sending Text messages
  2. Sending Media Messages (images, audio, videos, stickers and documents)
  3. Sending location messages
  4. Sending interactive buttons
  5. Sending template messages

Text

  • Send Text Message
watchap.sendMessage("337677xxxx", "this is a message");
  • Send Text Message with Preview URL
watchap.sendMessage("337677xxxx", "this is a message", true);

Media

When sending media(image, video, audio, sticker and document ), you can either specify a link containing the media or specify object id.

  • When media is an image, audio, document, or video and you are not using a link.
watchap.sendMessage("337677xxxx", "media-link", false);
  • When media is an image, audio, document, or video and you are not using a link.
watchap.sendMessage("337677xxxx", "<image-object-id>", false);

Image

  1. Send Image Message by URL
watchap.sendMessage("337677xxxx", "https://i.picsum.photos/id/866/200/300.jpg?hmac=rcadCENKh4rD6MAp6V_ma-AyWv641M4iiOpe1RyFHeI", true);
  1. Send Image Message by ID
watchap.sendMessage("337677xxxx", "<image-object-id>", false);

Audio

  1. Send Audio Message by URL
watchap.sendAudio("337677xxxx", "https://www.soundhelix.com/examples/mp3/SoundHelix-Song-15.mp3", true);
  1. Send Audio Message by ID
watchap.sendAudio("337677xxxx", "<image-object-id>", false);

Video

  1. Send Video Message by URL
watchap.sendVideo("337677xxxx", "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4", true);
  1. Send Video Message by ID
watchap.sendVideo("337677xxxx", "<image-object-id>", false);

Document

  1. Send Document Message by URL
watchap.sendDocument("337677xxxx", "https://assets.website-files.com/603d0d2db8ec32ba7d44fffe/603d0e327eb2748c8ab1053f_loremipsum.pdf", true);
  1. Send Document Message by id
watchap.sendDocument("337677xxxx", "<image-object-id>", false);

Sticker

  1. Send Sticker Message by URL
watchap.sendSticker("337677xxxx", "https://s3.getstickerpack.com/storage/uploads/sticker-pack/meme-pack-1/sticker_1.png?363e7ee56d4d8ad53813dae0907ef4c0", true);
  1. Send Sticker Message by id
watchap.sendSticker("337677xxxx", "<image-object-id>", false);

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Any issues, please report here

License

MIT

About

Unofficial java wrapper to WhatsApp Cloud API

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%