whatsapp網頁版-global
Abstract types
Properties
ChatTypes string
Chat types
Properties
Name | Type | Optional | Description |
---|---|---|---|
SOLO |
|
|
|
GROUP |
|
|
|
UNKNOWN |
|
|
Events string
Events that can be emitted by the client
Properties
Name | Type | Optional | Description |
---|---|---|---|
AUTHENTICATED |
|
|
|
AUTHENTICATION_FAILURE |
|
|
|
READY |
|
|
|
CHAT_REMOVED |
|
|
|
CHAT_ARCHIVED |
|
|
|
MESSAGE_RECEIVED |
|
|
|
MESSAGE_CIPHERTEXT |
|
|
|
MESSAGE_CREATE |
|
|
|
MESSAGE_REVOKED_EVERYONE |
|
|
|
MESSAGE_REVOKED_ME |
|
|
|
MESSAGE_ACK |
|
|
|
MESSAGE_EDIT |
|
|
|
UNREAD_COUNT |
|
|
|
MESSAGE_REACTION |
|
|
|
MEDIA_UPLOADED |
|
|
|
CONTACT_CHANGED |
|
|
|
GROUP_JOIN |
|
|
|
GROUP_LEAVE |
|
|
|
GROUP_ADMIN_CHANGED |
|
|
|
GROUP_MEMBERSHIP_REQUEST |
|
|
|
GROUP_UPDATE |
|
|
|
QR_RECEIVED |
|
|
|
LOADING_SCREEN |
|
|
|
DISCONNECTED |
|
|
|
STATE_CHANGED |
|
|
|
BATTERY_CHANGED |
|
|
|
INCOMING_CALL |
|
|
|
REMOTE_SESSION_SAVED |
|
|
|
VOTE_UPDATE |
|
|
GroupNotificationTypes string
Group notification types
Properties
Name | Type | Optional | Description |
---|---|---|---|
ADD |
|
|
|
INVITE |
|
|
|
REMOVE |
|
|
|
LEAVE |
|
|
|
SUBJECT |
|
|
|
DESCRIPTION |
|
|
|
PICTURE |
|
|
|
ANNOUNCE |
|
|
|
RESTRICT |
|
|
MessageAck number
Message ACK
Properties
Name | Type | Optional | Description |
---|---|---|---|
ACK_ERROR |
|
|
|
ACK_PENDING |
|
|
|
ACK_SERVER |
|
|
|
ACK_DEVICE |
|
|
|
ACK_READ |
|
|
|
ACK_PLAYED |
|
|
MessageTypes string
Message types
Properties
Name | Type | Optional | Description |
---|---|---|---|
TEXT |
|
|
|
AUDIO |
|
|
|
VOICE |
|
|
|
IMAGE |
|
|
|
VIDEO |
|
|
|
DOCUMENT |
|
|
|
STICKER |
|
|
|
LOCATION |
|
|
|
CONTACT_CARD |
|
|
|
CONTACT_CARD_MULTI |
|
|
|
ORDER |
|
|
|
REVOKED |
|
|
|
PRODUCT |
|
|
|
UNKNOWN |
|
|
|
GROUP_INVITE |
|
|
|
LIST |
|
|
|
LIST_RESPONSE |
|
|
|
BUTTONS_RESPONSE |
|
|
|
PAYMENT |
|
|
|
BROADCAST_NOTIFICATION |
|
|
|
CALL_LOG |
|
|
|
CIPHERTEXT |
|
|
|
DEBUG |
|
|
|
E2E_NOTIFICATION |
|
|
|
GP2 |
|
|
|
GROUP_NOTIFICATION |
|
|
|
HSM |
|
|
|
INTERACTIVE |
|
|
|
NATIVE_FLOW |
|
|
|
NOTIFICATION |
|
|
|
NOTIFICATION_TEMPLATE |
|
|
|
OVERSIZED |
|
|
|
PROTOCOL |
|
|
|
REACTION |
|
|
|
TEMPLATE_BUTTON_REPLY |
|
|
|
POLL_CREATION |
|
|
Status number
Client status
Properties
Name | Type | Optional | Description |
---|---|---|---|
INITIALIZING |
|
|
|
AUTHENTICATING |
|
|
|
READY |
|
|
WAState string
whatsapp網頁版 state
Properties
Name | Type | Optional | Description |
---|---|---|---|
CONFLICT |
|
|
|
CONNECTED |
|
|
|
DEPRECATED_VERSION |
|
|
|
OPENING |
|
|
|
PAIRING |
|
|
|
PROXYBLOCK |
|
|
|
SMB_TOS_BLOCK |
|
|
|
TIMEOUT |
|
|
|
TOS_BLOCK |
|
|
|
UNLAUNCHED |
|
|
|
UNPAIRED |
|
|
|
UNPAIRED_IDLE |
|
|
Method
exposeFunctionIfAbsent(page, name, fn)
Expose a function to the page if it does not exist
NOTE: Rewrite it to 'upsertFunction' after updating Puppeteer to 20.6 or higher using page.removeExposedFunction https://pptr.dev/api/puppeteer.page.removeExposedFunction
Parameters
Name | Type | Optional | Description |
---|---|---|---|
page |
|
|
|
name |
string |
|
|
fn |
function() |
|
Abstract types
AddParticipantsResult Object
An object that handles the result for addParticipants
method
Properties
Name | Type | Optional | Description |
---|---|---|---|
code |
number |
|
The code of the result |
message |
string |
|
The result message |
isInviteV4Sent |
boolean |
|
Indicates if the inviteV4 was sent to the partitipant |
AddParticipnatsOptions Object
An object that handles options for adding participants
Properties
Name | Type | Optional | Description |
---|---|---|---|
sleep |
(Array of number or number) |
Yes |
The number of milliseconds to wait before adding the next participant. If it is an array, a random sleep time between the sleep[0] and sleep[1] values will be added (the difference must be >=100 ms, otherwise, a random sleep time between sleep[1] and sleep[1] + 100 will be added). If sleep is a number, a sleep time equal to its value will be added. By default, sleep is an array with a value of [250, 500] Defaults to |
autoSendInviteV4 |
boolean |
Yes |
If true, the inviteV4 will be sent to those participants who have restricted others from being automatically added to groups, otherwise the inviteV4 won't be sent (true by default) Defaults to |
comment |
string |
Yes |
The comment to be added to an inviteV4 (empty string by default) Defaults to |
ButtonSpec Object
Button spec used in Buttons constructor
Properties
Name | Type | Optional | Description |
---|---|---|---|
id |
string |
Yes |
Custom ID to set on the button. A random one will be generated if one is not passed. |
body |
string |
|
The text to show on the button. |
ContactId Object
ID that represents a contact
Properties
Name | Type | Optional | Description |
---|---|---|---|
server |
string |
|
|
user |
string |
|
|
_serialized |
string |
|
CreateGroupOptions Object
An object that handles options for group creation
Properties
Name | Type | Optional | Description |
---|---|---|---|
messageTimer |
number |
Yes |
The number of seconds for the messages to disappear in the group (0 by default, won't take an effect if the group is been creating with myself only) Defaults to |
parentGroupId |
(string or undefined) |
|
The ID of a parent community group to link the newly created group with (won't take an effect if the group is been creating with myself only) |
autoSendInviteV4 |
boolean |
Yes |
If true, the inviteV4 will be sent to those participants who have restricted others from being automatically added to groups, otherwise the inviteV4 won't be sent (true by default) Defaults to |
comment |
string |
Yes |
The comment to be added to an inviteV4 (empty string by default) Defaults to |
CreateGroupResult Object
An object that handles the result for createGroup
method
Properties
Name | Type | Optional | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
title |
string |
|
A group title |
||||||||||||||||
gid |
Object |
|
An object that handles the newly created group ID Values in
|
||||||||||||||||
participants |
Object with ParticipantResult properties |
|
An object that handles the result value for each added to the group participant |
FormattedButtonSpec Object
Properties
Name | Type | Optional | Description |
---|---|---|---|
buttonId |
string |
|
|
type |
number |
|
|
buttonText |
Object |
|
GroupMembershipRequest Object
An object that handles the information about the group membership request
Properties
Name | Type | Optional | Description |
---|---|---|---|
id |
Object |
|
The wid of a user who requests to enter the group |
addedBy |
Object |
|
The wid of a user who created that request |
parentGroupId |
(Object or null) |
|
The wid of a community parent group to which the current group is linked |
requestMethod |
string |
|
The method used to create the request: NonAdminAdd/InviteLink/LinkedGroupJoin |
t |
number |
|
The timestamp the request was created at |
GroupMembershipRequest Object
An object that handles the information about the group membership request
Properties
Name | Type | Optional | Description |
---|---|---|---|
id |
Object |
|
The wid of a user who requests to enter the group |
addedBy |
Object |
|
The wid of a user who created that request |
parentGroupId |
(Object or null) |
|
The wid of a community parent group to which the current group is linked |
requestMethod |
string |
|
The method used to create the request: NonAdminAdd/InviteLink/LinkedGroupJoin |
t |
number |
|
The timestamp the request was created at |
GroupMention Object
An object representing mentions of groups
Properties
Name | Type | Optional | Description |
---|---|---|---|
subject |
string |
|
The name of a group to mention (can be custom) |
id |
string |
|
The group ID, e.g.: 'XXXXXXXXXX@g.us' |
GroupMention Object
Properties
Name | Type | Optional | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
groupSubject |
string |
|
The name of the group |
||||||||||||||||
groupJid |
Object |
|
The group ID Values in
|
GroupParticipant Object
Group participant information
Properties
Name | Type | Optional | Description |
---|---|---|---|
id |
|
||
isAdmin |
boolean |
|
|
isSuperAdmin |
boolean |
|
LocationSendOptions Object
Location send options
Properties
Name | Type | Optional | Description |
---|---|---|---|
name |
string |
Yes |
Location name |
address |
string |
Yes |
Location address |
url |
string |
Yes |
URL address to be shown within a location message |
MembershipRequestActionOptions Object
An object that handles options for approveGroupMembershipRequests
and rejectGroupMembershipRequests
methods
Properties
Name | Type | Optional | Description |
---|---|---|---|
requesterIds |
(Array of string, string, or null) |
|
User ID/s who requested to join the group, if no value is provided, the method will search for all membership requests for that group |
sleep |
(Array of number, number, or null) |
|
The number of milliseconds to wait before performing an operation for the next requester. If it is an array, a random sleep time between the sleep[0] and sleep[1] values will be added (the difference must be >=100 ms, otherwise, a random sleep time between sleep[1] and sleep[1] + 100 will be added). If sleep is a number, a sleep time equal to its value will be added. By default, sleep is an array with a value of [250, 500] |
MembershipRequestActionOptions Object
An object that handles options for approveGroupMembershipRequests
and rejectGroupMembershipRequests
methods
Properties
Name | Type | Optional | Description |
---|---|---|---|
requesterIds |
(Array of string, string, or null) |
|
User ID/s who requested to join the group, if no value is provided, the method will search for all membership requests for that group |
sleep |
(Array of number, number, or null) |
|
The number of milliseconds to wait before performing an operation for the next requester. If it is an array, a random sleep time between the sleep[0] and sleep[1] values will be added (the difference must be >=100 ms, otherwise, a random sleep time between sleep[1] and sleep[1] + 100 will be added). If sleep is a number, a sleep time equal to its value will be added. By default, sleep is an array with a value of [250, 500] |
MembershipRequestActionResult Object
An object that handles the result for membership request action
Properties
Name | Type | Optional | Description |
---|---|---|---|
requesterId |
string |
|
User ID whos membership request was approved/rejected |
error |
(number or undefined) |
|
An error code that occurred during the operation for the participant |
message |
string |
|
A message with a result of membership request action |
MembershipRequestActionResult Object
An object that handles the result for membership request action
Properties
Name | Type | Optional | Description |
---|---|---|---|
requesterId |
string |
|
User ID whos membership request was approved/rejected |
error |
number |
|
An error code that occurred during the operation for the participant |
message |
string |
|
A message with a result of membership request action |
Mention Object
Properties
Name | Type | Optional | Description |
---|---|---|---|
server |
string |
|
|
user |
string |
|
|
_serialized |
string |
|
MessageInfo Object
Message Info
Properties
Name | Type | Optional | Description |
---|---|---|---|
delivery |
Array of {id: ContactId, t: number} |
|
Contacts to which the message has been delivered to |
deliveryRemaining |
number |
|
Amount of people to whom the message has not been delivered to |
played |
Array of {id: ContactId, t: number} |
|
Contacts who have listened to the voice message |
playedRemaining |
number |
|
Amount of people who have not listened to the message |
read |
Array of {id: ContactId, t: number} |
|
Contacts who have read the message |
readRemaining |
number |
|
Amount of people who have not read the message |
MessageSendOptions Object
Message options.
Properties
Name | Type | Optional | Description |
---|---|---|---|
linkPreview |
boolean |
Yes |
Show links preview. Has no effect on multi-device accounts. Defaults to |
sendAudioAsVoice |
boolean |
Yes |
Send audio as voice message with a generated waveform Defaults to |
sendVideoAsGif |
boolean |
Yes |
Send video as gif Defaults to |
sendMediaAsSticker |
boolean |
Yes |
Send media as a sticker Defaults to |
sendMediaAsDocument |
boolean |
Yes |
Send media as a document Defaults to |
isViewOnce |
boolean |
Yes |
Send photo/video as a view once message Defaults to |
parseVCards |
boolean |
Yes |
Automatically parse vCards and send them as contacts Defaults to |
caption |
string |
Yes |
Image or video caption |
quotedMessageId |
string |
Yes |
Id of the message that is being quoted (or replied to) |
groupMentions |
Array of GroupMention |
Yes |
An array of object that handle group mentions |
mentions |
Array of string |
Yes |
User IDs to mention in the message |
sendSeen |
boolean |
Yes |
Mark the conversation as seen after sending the message Defaults to |
invokedBotWid |
string |
Yes |
Bot Wid when doing a bot mention like @Meta AI |
stickerAuthor |
string |
Yes |
Sets the author of the sticker, (if sendMediaAsSticker is true). |
stickerName |
string |
Yes |
Sets the name of the sticker, (if sendMediaAsSticker is true). |
stickerCategories |
Array of string |
Yes |
Sets the categories of the sticker, (if sendMediaAsSticker is true). Provide emoji char array, can be null. |
media |
Yes |
Media to be sent |
ParticipantResult Object
An object that represents the result for a participant added to a group
Properties
Name | Type | Optional | Description |
---|---|---|---|
statusCode |
number |
|
The status code of the result |
message |
string |
|
The result message |
isGroupCreator |
boolean |
|
Indicates if the participant is a group creator |
isInviteV4Sent |
boolean |
|
Indicates if the inviteV4 was sent to the participant |
PollSendOptions Object
Poll send options
Properties
Name | Type | Optional | Description |
---|---|---|---|
allowMultipleAnswers |
boolean |
Yes |
If false it is a single choice poll, otherwise it is a multiple choice poll (false by default) Defaults to |
messageSecret |
Array of number |
|
The custom message secret, can be used as a poll ID. NOTE: it has to be a unique vector with a length of 32 Value can be null. |
ReactionList Object
Reaction List
Properties
Name | Type | Optional | Description |
---|---|---|---|
id |
string |
|
Original emoji |
aggregateEmoji |
string |
|
aggregate emoji |
hasReactionByMe |
boolean |
|
Flag who sent the reaction |
senders |
Array of Reaction |
|
Reaction senders, to this message |
SelectedPollOption Object
Selected poll option structure
Properties
Name | Type | Optional | Description |
---|---|---|---|
id |
number |
|
The local selected or deselected option ID |
name |
string |
|
The option name |
StickerMetadata Object
Sticker metadata.
Properties
Name | Type | Optional | Description |
---|---|---|---|
name |
string |
Yes |
|
author |
string |
Yes |
|
categories |
Array of string |
Yes |
TargetOptions Object
Target options object description
Properties
Name | Type | Optional | Description |
---|---|---|---|
module |
(string or number) |
|
The name or a key of the target module to search |
index |
number |
|
The index value of the target module |
function |
string |
|
The function name to get from a module |
TargetOptions Object
Target options object description
Properties
Name | Type | Optional | Description |
---|---|---|---|
module |
(string or number) |
|
The target module |
function |
string |
|
The function name to get from a module |