open-wa v5 is alpha. Use v4.76.0 for mature production systems unless you are validating v5.
The Client APIAPI ExplorerLicensing

BaseClient

The generated flat client, its dispatch contract, and the full method table.

BaseClient

Generated file warning: this page is generated by packages/schema/scripts/gen-client-reference-docs.ts. Do not edit generated method content by hand.

BaseClient is generated from the registry. Each method is a one-line binding, for example:

/** Sends a text message to a chat */
public sendText = implementMethod(Methods.sendText);

At runtime each call normalizes arguments, validates them with the method's Zod input schema, then dispatches to execute(meta.wapiOverride ?? meta.functionName, validatedParams) (falling back to pup() page evaluation). See Argument normalization.

Method dispatch table

MethodNamespaceDispatch targetParameter orderOutput
addLabellabelsaddLabellabel, chatIdboolean
addParticipantgroupsaddParticipantgroupId, contactIdboolean
approveGroupJoinRequestgroupsapproveGroupJoinRequestgroupId, contactIdstring | boolean
archiveChatchatsarchiveChatchatIdboolean
blockContactcontactscontactBlockcontactIdboolean
checkNumberStatuscontactscheckNumberStatuscontactIdany
checkReadReceiptscontactscheckReadReceiptscontactIdboolean | string
clearChatchatsclearChatchatIdboolean
createGroupgroupscreateGroupname, contactsany
decryptMediamediadecryptMediamessagestring
deleteAllStatusstatusdeleteAllStatus-any
deleteChatchatsdeleteChatchatIdboolean
deleteMessagemessagesdeleteMessagechatId, messageId, onlyLocalboolean
deleteStatusstatusdeleteStatusstatusesToDeleteany
demoteParticipantgroupsdemoteParticipantgroupId, contactIdboolean | string
downloadMediamediadownloadMediamessage, pathstring
forwardMessagesmessagesforwardMessagesto, messages, skipMyMessagesobject { _serialized }[] | boolean
getAllChatIdschatIdsgetAllChatIds-string[]
getAllChatschatsgetAllChatswithNewMessagesOnlyany[]
getAllCommunitiescommunitiesgetAllCommunities-string[]
getAllContactscontactsgetAllContacts-any[]
getAllGroupsgroupsgetAllGroupswithNewMessagesOnlyany[]
getAllLabelslabelsgetAllLabels-any[]
getAllMessagesmessagesgetAllMessageschatId, includeMe, includeNotificationsany[]
getBatteryLevelsessiongetBatteryLevel-number
getBlockedIdscontactsgetBlockedIds-string[]
getBusinessProductsbusinessgetBusinessProfilesProductscontactIdany
getBusinessProfilebusinessgetBusinessProfilecontactIdany
getChatchatsgetChatchatIdany
getChatsByLabellabelsgetChatsByLabellabelany[]
getChatWithNonContactschatsgetChatWithNonContacts-any[]
getCommonGroupscontactsgetCommonGroupscontactIdany
getCommunityAdminIdscommunitiesgetCommunityAdminIdscommunityIdany
getCommunityAdminscommunitiesgetCommunityAdminscommunityIdany
getCommunityInfocommunitiesgetCommunityInfocommunityIdany
getCommunityParticipantIdscommunitiesgetCommunityParticipantIdscommunityIdany
getCommunityParticipantscommunitiesgetCommunityParticipantscommunityIdany
getConnectionStatesessiongetConnectionState-any
getContactcontactsgetContactcontactIdany
getFeaturessessiongetFeatures-any
getGroupAdminsgroupsgetGroupAdminsgroupIdany[]
getGroupInfogroupsgetGroupInfogroupIdany
getGroupInviteLinkgroupsgetGroupInviteLinkgroupIdstring
getGroupMembersgroupsgetGroupMembersgroupIdany[]
getGroupMembersIdgroupsgetGroupMembersIdgroupIdstring[]
getHostNumbersessiongetHostNumber-string
getKickedGroupsgroupsgetKickedGroups-string[]
getLicenseTypesessiongetLicenseType-any
getLoadedMessageCountsessiongetAmountOfLoadedMessages-number
getMesessiongetMe-any
getMessageByIdmessagesgetMessageByIdmessageIdany
getMessageInfomessagesgetMessageInfomessageIdany
getMessagesForLLMmessagesgetGptArraychatId, lastany
getMyLastMessagemessagesgetMyLastMessagechatIdany
getNumberProfilecontactsgetNumberProfilecontactIdany
getOrderbusinessgetOrderidany
getProcessStatssessiongetProcessStats-any
getProfilePicturecontactsgetProfilePicFromServerchatIdstring
getSnapshotsessiongetSnapshotchatId, width, heightstring
getStarredMessagesmessagesgetStarredMessageschatIdany[]
getStatusmystatusgetStatuscontactIdany
getStoriesstatusgetStories-any[]
getUnsentMessagesmessagesgetUnsentMessages-any[]
getUserAgentsessiongetGeneratedUserAgentuserAgentstring
getVCardsmessagesgetVCardsmessageIdstring[]
getWAVersionsessiongetWAVersion-string
healthChecksessionhealthCheck-any
isChatOnlinechatsisChatOnlinechatIdboolean | string
isPluggedsessiongetIsPlugged-boolean
joinGroupViaLinkgroupsjoinGroupViaLinklink, returnChatObjany
leaveGroupgroupsleaveGroupgroupIdany
loadEarlierMessagesmessagesloadEarlierMessageschatId, count, includeMeany[]
markAsReadchatsmarkAsReadchatIdboolean
markAsUnreadchatsmarkAsUnreadchatIdboolean
muteChatchatsmuteChatchatId, muteDurationstring | boolean | number
pinChatchatspinChatchatIdboolean
postImageStatusstatuspostImageStatusimage, captionany
postTextStatusstatuspostTextStatustext, backgroundColor, fontany
postVideoStatusstatuspostVideoStatusvideo, captionany
promoteParticipantgroupspromoteParticipantgroupId, contactIdboolean | string
reactmessagesreactmessageId, emojiboolean
rejectGroupJoinRequestgroupsrejectGroupJoinRequestgroupId, contactIdstring | boolean
removeLabellabelsremoveLabellabel, chatIdboolean
removeParticipantgroupsremoveParticipantgroupId, contactIdboolean
revokeGroupInviteLinkgroupsrevokeGroupInviteLinkgroupIdstring | boolean
sendAdvancedButtonsmessagessendAdvancedButtonsto, body, buttons, text, footer, filenameobject { _serialized } | boolean
sendAudiomessagessendAudioto, file, filename, quotedMsgIdobject { _serialized } | boolean
sendBannermessagessendBannerto, base64object { _serialized } | boolean
sendButtonsmessagessendButtonsto, body, buttons, title, footerobject { _serialized } | boolean
sendContactmessagessendContactto, contactIdobject { _serialized } | boolean
sendFilemessagessendFileto, file, filename, captionobject { _serialized } | string
sendFileFromUrlmessagessendFileFromUrlto, url, filename, caption, headersstring | boolean
sendImagemessagessendImageto, imgData, filename, caption, id, waitForIdobject { _serialized } | boolean | string
sendLinkWithAutoPreviewmessagessendLinkWithAutoPreviewto, url, text, thumbnail, quotedMsgId, customSizeobject { _serialized } | boolean
sendListMessagemessagessendListMessageto, sections, title, description, actionTextobject { _serialized } | boolean
sendLocationmessagessendLocationto, lat, lng, loc, address, urlobject { _serialized } | boolean
sendMessageWithThumbmessagessendMessageWithThumbthumb, url, title, description, content, to, quotedMsgId, customSizeobject { _serialized } | boolean
sendMultipleContactsmessagessendMultipleContactsto, contactIdsobject { _serialized } | boolean
sendPaymentRequestmessagessendPaymentRequestto, amount, currency, messageobject { _serialized } | boolean
sendPollmessagessendPollto, name, options, selectableCountobject { _serialized } | boolean
sendPttmessagessendPttto, file, quotedMsgIdobject { _serialized } | boolean
sendReplyWithMentionsmessagessendReplyWithMentionsto, content, replyMessageId, hideTags, mentionsobject { _serialized } | boolean
sendSeenmessagessendSeenchatIdboolean
sendTextmessagessendTextto, content, optionsobject { _serialized } | boolean | string
sendTextWithMentionsmessagessendTextWithMentionsto, content, hideTags, mentionsobject { _serialized } | boolean
sendVCardmessagessendVCardto, vcard, contactName, contactNumberboolean
sendVideoAsGifmessagessendVideoAsGifto, file, filename, caption, quotedMsgIdobject { _serialized } | boolean
sendYouTubeLinkmessagessendYoutubeLinkto, url, text, thumbnail, quotedMsgId, customSizeobject { _serialized } | boolean
setChatEphemeralchatssetChatEphemeralchatId, ephemeralboolean
setGroupDescriptiongroupssetGroupDescriptiongroupId, descriptionboolean
setGroupEditToAdminsOnlygroupssetGroupEditToAdminsOnlygroupId, onlyAdminsboolean
setGroupIcongroupssetGroupIcongroupId, imageboolean
setGroupTitlegroupssetGroupTitlegroupId, titleboolean
setGroupToAdminsOnlygroupssetGroupToAdminsOnlygroupId, onlyAdminsboolean
setMyNamesessionsetMyNamenameboolean
setMyStatussessionsetMyStatusstatusTextboolean
setProfilePicturesessionsetProfilePicimageboolean
starMessagemessagesstarMessagemessageIdboolean
unarchiveChatchatsunarchiveChatchatIdboolean
unblockContactcontactscontactUnblockcontactIdboolean
unmuteChatchatsunmuteChatchatIdstring | boolean | number
unpinChatchatsunpinChatchatIdboolean
unstarMessagemessagesunstarMessagemessageIdboolean
Wally the Walrus typing

Was this helpful?

Wally and his cute companion coffee mug are coding day and night to keep this up-to-date!

On this page