/go-whatsapp-web-multidevice

API for Whatsapp Web Multi Device Version, Support UI & Webhook

Primary LanguageGoMIT LicenseMIT

WhatsApp API Multi Device Version

release version
Build Image
release windows release linux release macos

Support ARM Architecture

Now that we support ARM64 for Linux:

Feature

  • Send WhatsApp message via http API, docs/openapi.yml for more details
  • Compress image before send
  • Compress video before send
  • Change OS name become your app (it's the device name when connect via mobile)
    • --os=Chrome or --os=MyApplication
  • Basic Auth (able to add multi credentials)
    • --basic-auth=kemal:secret,toni:password,userName:secretPassword, or you can simplify
    • -b=kemal:secret,toni:password,userName:secretPassword
  • Customizable port and debug mode
    • --port 8000
    • --debug true
  • Auto reply message
    • --autoreply="Don't reply this message"
  • Webhook for received message
    • --webhook="http://yourwebhook.site/handler", or you can simplify
    • -w="http://yourwebhook.site/handler"
  • For more command ./main --help

Required (without docker)

  • Mac OS:
    • brew install ffmpeg
    • export CGO_CFLAGS_ALLOW="-Xpreprocessor"
  • Linux:
    • sudo apt update
    • sudo apt install ffmpeg
  • Windows (not recomended, prefer using WSL):

How to use

Basic

  1. Clone this repo: git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice
  2. Open the folder that was cloned via cmd/terminal.
  3. run cd src
  4. run go run main.go
  5. Open http://localhost:3000

Docker (you don't need to install in required)

  1. Clone this repo: git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice
  2. Open the folder that was cloned via cmd/terminal.
  3. run docker-compose up -d --build
  4. open http://localhost:3000

Build your own binary

  1. Clone this repo git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice
  2. Open the folder that was cloned via cmd/terminal.
  3. run cd src
  4. run
    1. Linux & MacOS: go build -o whatsapp
    2. Windows (CMD / PowerShell): go build -o whatsapp.exe
  5. run
    1. Linux & MacOS: ./whatsapp
      1. run ./whatsapp --help for more detail flags
    2. Windows: .\whatsapp.exe or you can double-click it
      1. run .\whatsapp.exe --help for more detail flags
  6. open http://localhost:3000 in browser

Production Mode (docker)

docker run --detach --publish=3000:3000 --name=whatsapp --restart=always --volume=$(docker volume create --name=whatsapp):/app/storages aldinokemal2104/go-whatsapp-web-multidevice --autoreply="Dont't reply this message please"

Production Mode (binary)

You can fork or edit this source code !

Current API

Feature Menu Method URL
Login GET /app/login
Logout GET /app/logout
Reconnect GET /app/reconnect
Devices GET /app/devices
User Info GET /user/info
User Avatar GET /user/avatar
User My Group List GET /user/my/groups
User My Privacy Setting GET /user/my/privacy
Send Message POST /send/message
Send Image POST /send/image
Send Audio POST /send/audio
Send File POST /send/file
Send Video POST /send/video
Send Contact POST /send/contact
Send Link POST /send/link
Send Location POST /send/location
Send Poll / Vote POST /send/poll
Revoke Message POST /message/:message_id/revoke
React Message POST /message/:message_id/reaction
Delete Message POST /message/:message_id/delete
Edit Message POST /message/:message_id/update
Join Group With Link POST /group/join-with-link
Leave Group POST /group/leave
Create Group POST /group
Add Participants in Group POST /group/participants
Remove Participant in Group DELETE /group/participants
Promote Participant in Group POST /group/participants/promote
Demote Participant in Group POST /group/participants/demote
✅ = Available
❌ = Not Available Yet

App User Interface

  1. Homepage Homepage
  2. Login Login
  3. Send Message Send Message
  4. Send Image Send Image
  5. Send File Send File
  6. Send Video Send Video
  7. Send Contact Send Contact
  8. Send Location Send Location
  9. Send Audio Send Location
  10. Send Poll Send Poll
  11. Revoke Message Revoke Message
  12. Delete Message Delete Message
  13. Reaction Message Revoke Message
  14. Edit Message Edit Message
  15. User Info User Info
  16. User Avatar User Avatar
  17. My Privacy My Privacy
  18. My Group My Group
  19. Auto Reply Auto Reply
  20. Basic Auth Prompt Basic Auth

Mac OS NOTE

  • Please do this if you have an error (invalid flag in pkg-config --cflags: -Xpreprocessor) export CGO_CFLAGS_ALLOW="-Xpreprocessor"