hub / github.com/tulir/whatsmeow
github.com/tulir/whatsmeow @main
Chat with this repo
13,861 symbols
19,787 edges
158 files
1,779 documented · 13%
17 cross-repo links
● updated 2d ago★ 6,68723 open issues
Browse by type
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
whatsmeow
whatsmeow is a Go library for the WhatsApp web multidevice API.
Discussion
Matrix room: #whatsmeow:maunium.net
For questions about the WhatsApp protocol (like how to send a specific type of message), you can also use the WhatsApp protocol Q&A section on GitHub discussions.
Usage
The godoc includes docs for all methods and event types. There's also a simple example at the top.
Features
Most core features are already present:
- Sending messages to private chats and groups (both text and media)
- Receiving all messages
- Managing groups and receiving group change events
- Joining via invite messages, using and creating invite links
- Sending and receiving typing notifications
- Sending and receiving delivery and read receipts
- Reading and writing app state (contact list, chat pin/mute status, etc)
- Sending and handling retry receipts if message decryption fails
- Sending status messages (experimental, may not work for large contact lists)
Things that are not yet implemented:
- Sending broadcast list messages (this is not supported on WhatsApp web either)
- Calls
Extension points exported contracts — how you extend this code
DownloadableMessage (Interface)
DownloadableMessage represents a protobuf message that contains attachment info. All of the downloadable messages insid [22 …
download.go
PermanentDisconnect (Interface)
PermanentDisconnect is a class of events emitted when the client will not auto-reconnect by default. [6 implementers]
types/events/events.go
MessageApplicationSub (Interface)
(no doc) [6 implementers]
proto/extra.go
Logger (Interface)
Logger is a simple logger interface that can have subloggers for specific areas. [3 implementers]
util/log/log.go
PushConfig (Interface)
(no doc) [3 implementers]
push.go
EventHandler (FuncType)
EventHandler is a function that can handle events from WhatsApp.
client.go
IdentityStore (Interface)
(no doc) [2 implementers]
store/store.go
DownloadExternalFunc (FuncType)
DownloadExternalFunc is a function that can download a blob of external app state patches.
appstate/decode.go
Core symbols most depended-on inside this repo
Shape
Languages
Go100%
Modules by API surface
proto/waE2E/WAWebProtobufsE2E.pb.go3,336 symbols
proto/waSyncAction/WAWebProtobufSyncAction.pb.go1,130 symbols
proto/waAICommon/WAWebProtobufsAICommon.pb.go987 symbols
proto/waBotMetadata/WABotMetadata.pb.go632 symbols
proto/waArmadilloMiTransportAdminMessage/WAArmadilloMiTransportAdminMessage.pb.go562 symbols
proto/waWeb/WAWebProtobufsWeb.pb.go476 symbols
proto/waArmadilloApplication/WAArmadilloApplication.pb.go451 symbols
proto/waConsumerApplicationParameterised/WAConsumerApplicationParameterised.pb.go391 symbols
proto/waConsumerApplication/WAConsumerApplication.pb.go391 symbols
proto/waHistorySync/WAWebProtobufsHistorySync.pb.go318 symbols
proto/waWa6/WAWebProtobufsWa6.pb.go292 symbols
proto/waMediaTransport/WAMediaTransport.pb.go279 symbols
Used by 8 indexed graphs manifest dependencies, hub-wide
Dependencies from manifests, versioned
filippo.io/edwards25519v1.2.0 · 1×
github.com/beeper/argo-gov1.1.2 · 1×
github.com/coder/websocketv1.8.15 · 1×
github.com/elliotchance/orderedmap/v3v3.1.0 · 1×
github.com/google/uuidv1.6.0 · 1×
github.com/mattn/go-colorablev0.1.14 · 1×
github.com/mattn/go-isattyv0.0.20 · 1×
github.com/petermattis/goidv0.0.0-2026033013502 · 1×
github.com/rs/zerologv1.35.1 · 1×
github.com/vektah/gqlparser/v2v2.5.27 · 1×
go.mau.fi/libsignalv0.2.2 · 1×
go.mau.fi/utilv0.9.10 · 1×
For agents
$ claude mcp add whatsmeow \
-- python -m otcore.mcp_server <graph>