Wechaty v0.62.1 Documentation

• Website - https://wechaty.js.org
• Docs Site - https://wechaty.js.org/docs/
• API References - https://wechaty.github.io/wechaty/

Classes

If you want to know how to get contact, see <a href="#Contact">Contact</a></p>

Constants

Functions

Typedefs

<a name="Wechaty"></a>

Wechaty

Main bot class.

A Bot is a WeChat client depends on which puppet you use. It may equals

• web-WeChat, when you use: puppet-puppeteer/puppet-wechat4u
• ipad-WeChat, when you use: puppet-padchat
• ios-WeChat, when you use: puppet-ioscat

See more:

• What is a Puppet in Wechaty

If you want to know how to send message, see Message

If you want to know how to get contact, see Contact

Kind: global class

• Wechaty
  • new Wechaty([options])
  • instance
    • .wechatifiedContact
    • .name()
    • .use(...plugins) ⇒ <code>Wechaty</code>
    • .start() ⇒ <code>Promise.<void></code>
    • .stop() ⇒ <code>Promise.<void></code>
    • .logout() ⇒ <code>Promise.<void></code>
    • .logonoff() ⇒ <code>boolean</code>
    • .userSelf() ⇒ <code>ContactSelf</code>
    • .say(something) ⇒ <code>Promise.<void></code>
  • static
    • .instance([options])
    • .use(...plugins) ⇒ <code>Wechaty</code>

<a name="new_Wechaty_new"></a>

new Wechaty([options])

Creates an instance of Wechaty.

Example (The World's Shortest ChatBot Code: 6 lines of JavaScript)

import { Wechaty } from 'wechaty'
const bot = new Wechaty()
bot.on('scan',    (qrCode, status) => console.log('https://wechaty.js.org/qrcode/' + encodeURIComponent(qrcode)))
bot.on('login',   user => console.log(`User ${user} logged in`))
bot.on('message', message => console.log(`Message: ${message}`))
bot.start()

<a name="Wechaty+wechatifiedContact"></a>

wechaty.wechatifiedContact

1. Setup Wechaty User Classes

Kind: instance property of <code>Wechaty</code>
<a name="Wechaty+name"></a>

wechaty.name()

Wechaty bot name set by options.name default: wechaty

Kind: instance method of <code>Wechaty</code>
<a name="Wechaty+use"></a>

wechaty.use(...plugins) ⇒ <code>Wechaty</code>

For wechaty ecosystem, allow user to define a 3rd party plugin for the current wechaty instance.

Kind: instance method of <code>Wechaty</code>
Returns: <code>Wechaty</code> - - this for chaining,

Example

// The same usage with Wechaty.use().

<a name="Wechaty+start"></a>

wechaty.start() ⇒ <code>Promise.<void></code>

When you start the bot, bot will begin to login, need you WeChat scan qrcode to login

Tips: All the bot operation needs to be triggered after start() is done

Kind: instance method of <code>Wechaty</code>
Example

await bot.start()
// do other stuff with bot here

<a name="Wechaty+stop"></a>

wechaty.stop() ⇒ <code>Promise.<void></code>

Stop the bot

Kind: instance method of <code>Wechaty</code>
Example

await bot.stop()

<a name="Wechaty+logout"></a>

wechaty.logout() ⇒ <code>Promise.<void></code>

Logout the bot

Kind: instance method of <code>Wechaty</code>
Example

await bot.logout()

<a name="Wechaty+logonoff"></a>

wechaty.logonoff() ⇒ <code>boolean</code>

Get the logon / logoff state

Kind: instance method of <code>Wechaty</code>
Example

if (bot.logonoff()) {
  console.log('Bot logged in')
} else {
  console.log('Bot not logged in')
}

<a name="Wechaty+userSelf"></a>

wechaty.userSelf() ⇒ <code>ContactSelf</code>

Get current user

Kind: instance method of <code>Wechaty</code>
Example

const contact = bot.userSelf()
console.log(`Bot is ${contact.name()}`)

<a name="Wechaty+say"></a>

wechaty.say(something) ⇒ <code>Promise.<void></code>

Send message to userSelf, in other words, bot send message to itself.

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

Kind: instance method of <code>Wechaty</code>

Example

const bot = new Wechaty()
await bot.start()
// after logged in

// 1. send text to bot itself
await bot.say('hello!')

// 2. send Contact to bot itself
const contact = await bot.Contact.find()
await bot.say(contact)

// 3. send Image to bot itself from remote url
import { FileBox }  from 'wechaty'
const fileBox = FileBox.fromUrl('https://wechaty.github.io/wechaty/images/bot-qr-code.png')
await bot.say(fileBox)

// 4. send Image to bot itself from local file
import { FileBox }  from 'wechaty'
const fileBox = FileBox.fromFile('/tmp/text.jpg')
await bot.say(fileBox)

// 5. send Link to bot itself
const linkPayload = new UrlLink ({
  description : 'WeChat Bot SDK for Individual Account, Powered by TypeScript, Docker, and Love',
  thumbnailUrl: 'https://avatars0.githubusercontent.com/u/25162437?s=200&v=4',
  title       : 'Welcome to Wechaty',
  url         : 'https://github.com/wechaty/wechaty',
})
await bot.say(linkPayload)

// 6. send MiniProgram to bot itself
const miniPayload = new MiniProgram ({
  username           : 'gh_xxxxxxx',     //get from mp.weixin.qq.com
  appid              : '',               //optional, get from mp.weixin.qq.com
  title              : '',               //optional
  pagepath           : '',               //optional
  description        : '',               //optional
  thumbnailurl       : '',               //optional
})
await bot.say(miniPayload)

<a name="Wechaty.instance"></a>

Wechaty.instance([options])

Get the global instance of Wechaty

Kind: static method of <code>Wechaty</code>

Example (The World's Shortest ChatBot Code: 6 lines of JavaScript)

const { Wechaty } = require('wechaty')

Wechaty.instance() // Global instance
.on('scan', (url, status) => console.log(`Scan QR Code to login: ${status}\n${url}`))
.on('login',       user => console.log(`User ${user} logged in`))
.on('message',  message => console.log(`Message: ${message}`))
.start()

<a name="Wechaty.use"></a>

Wechaty.use(...plugins) ⇒ <code>Wechaty</code>

For wechaty ecosystem, allow user to define a 3rd party plugin for the all wechaty instances

Kind: static method of <code>Wechaty</code>
Returns: <code>Wechaty</code> - - this for chaining,

Example

// Report all chat message to my server.

function WechatyReportPlugin(options: { url: string }) {
  return function (this: Wechaty) {
    this.on('message', message => http.post(options.url, { data: message }))
  }
}

bot.use(WechatyReportPlugin({ url: 'http://somewhere.to.report.your.data.com' })

<a name="Room"></a>

Room

All WeChat rooms(groups) will be encapsulated as a Room.

Examples/Room-Bot

Kind: global class
Properties

• Room
  • instance
    • .sync() ⇒ <code>Promise.<void></code>
    • .say(textOrContactOrFileOrUrlOrMini, [mention]) ⇒ <code>Promise.<(void|Message)></code>
    • .add(contact) ⇒ <code>Promise.<void></code>
    • .remove(contact) ⇒ <code>Promise.<void></code>
    • .del()
    • .quit() ⇒ <code>Promise.<void></code>
    • .topic([newTopic]) ⇒ <code>Promise.<(string|void)></code>
    • .announce([text]) ⇒ <code>Promise.<(void|string)></code>
    • .qrCode() ⇒ <code>Promise.<string></code>
    • .alias(contact) ⇒ <code>Promise.<(string|null)></code>
    • .has(contact) ⇒ <code>Promise.<boolean></code>
    • .memberAll([query]) ⇒ <code>Promise.<Array.<Contact>></code>
    • .member(queryArg) ⇒ <code>Promise.<(null|Contact)></code>
    • .owner() ⇒ <code>Contact</code> | <code>null</code>
    • .avatar() ⇒ <code>FileBox</code>
  • static
    • .create(contactList, [topic]) ⇒ <code>Promise.<Room></code>
    • .findAll([query]) ⇒ <code>Promise.<Array.<Room>></code>
    • .find(query) ⇒ <code>Promise.<(Room|null)></code>

<a name="Room+sync"></a>

room.sync() ⇒ <code>Promise.<void></code>

Force reload data for Room, Sync data from puppet API again.

Kind: instance method of <code>Room</code>
Example

await room.sync()

<a name="Room+say"></a>

room.say(textOrContactOrFileOrUrlOrMini, [mention]) ⇒ <code>Promise.<(void|Message)></code>

Send message inside Room, if set [replyTo], wechaty will mention the contact as well.

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

Kind: instance method of <code>Room</code>

Example

const bot = new Wechaty()
await bot.start()
// after logged in...
const room = await bot.Room.find({topic: 'wechaty'})

// 1. Send text inside Room

await room.say('Hello world!')
const msg = await room.say('Hello world!') // only supported by puppet-padplus

// 2. Send media file inside Room
import { FileBox }  from 'wechaty'
const fileBox1 = FileBox.fromUrl('https://wechaty.github.io/wechaty/images/bot-qr-code.png')
const fileBox2 = FileBox.fromLocal('/tmp/text.txt')
await room.say(fileBox1)
const msg1 = await room.say(fileBox1) // only supported by puppet-padplus
await room.say(fileBox2)
const msg2 = await room.say(fileBox2) // only supported by puppet-padplus

// 3. Send Contact Card in a room
const contactCard = await bot.Contact.find({name: 'lijiarui'}) // change 'lijiarui' to any of the room member
await room.say(contactCard)
const msg = await room.say(contactCard) // only supported by puppet-padplus

// 4. Send text inside room and mention @mention contact
const contact = await bot.Contact.find({name: 'lijiarui'}) // change 'lijiarui' to any of the room member
await room.say('Hello world!', contact)
const msg = await room.say('Hello world!', contact) // only supported by puppet-padplus

// 5. Send text inside room and mention someone with Tagged Template
const contact2 = await bot.Contact.find({name: 'zixia'}) // change 'zixia' to any of the room member
await room.say`Hello ${contact}, here is the world ${contact2}`
const msg = await room.say`Hello ${contact}, here is the world ${contact2}` // only supported by puppet-padplus

// 6. send url link in a room

const urlLink = new UrlLink ({
  description : 'WeChat Bot SDK for Individual Account, Powered by TypeScript, Docker, and Love',
  thumbnailUrl: 'https://avatars0.githubusercontent.com/u/25162437?s=200&v=4',
  title       : 'Welcome to Wechaty',
  url         : 'https://github.com/wechaty/wechaty',
})
await room.say(urlLink)
const msg = await room.say(urlLink) // only supported by puppet-padplus

// 7. send mini program in a room

const miniProgram = new MiniProgram ({
  username           : 'gh_xxxxxxx',     //get from mp.weixin.qq.com
  appid              : '',               //optional, get from mp.weixin.qq.com
  title              : '',               //optional
  pagepath           : '',               //optional
  description        : '',               //optional
  thumbnailurl       : '',               //optional
})
await room.say(miniProgram)
const msg = await room.say(miniProgram) // only supported by puppet-padplus

<a name="Room+add"></a>

room.add(contact) ⇒ <code>Promise.<void></code>

Add contact in a room

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

see Web version of WeChat closed group interface

Kind: instance method of <code>Room</code>

Example

const bot = new Wechaty()
await bot.start()
// after logged in...
const contact = await bot.Contact.find({name: 'lijiarui'}) // change 'lijiarui' to any contact in your WeChat
const room = await bot.Room.find({topic: 'WeChat'})        // change 'WeChat' to any room topic in your WeChat
if (room) {
  try {
     await room.add(contact)
  } catch(e) {
     console.error(e)
  }
}

<a name="Room+remove"></a>

room.remove(contact) ⇒ <code>Promise.<void></code>

Remove a contact from the room It works only when the bot is the owner of the room

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

see Web version of WeChat closed group interface

Kind: instance method of <code>Room</code>

Example

const bot = new Wechaty()
await bot.start()
// after logged in...
const room = await bot.Room.find({topic: 'WeChat'})          // change 'WeChat' to any room topic in your WeChat
const contact = await bot.Contact.find({name: 'lijiarui'})   // change 'lijiarui' to any room member in the room you just set
if (room) {
  try {
     await room.remove(contact)
  } catch(e) {
     console.error(e)
  }
}

<a name="Room+del"></a>

room.del()

Deprecated

Kind: instance method of <code>Room</code>
<a name="Room+quit"></a>

room.quit() ⇒ <code>Promise.<void></code>

Bot quit the room itself

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

Kind: instance method of <code>Room</code>
Example

await room.quit()

<a name="Room+topic"></a>

room.topic([newTopic]) ⇒ <code>Promise.<(string|void)></code>

SET/GET topic from the room

Kind: instance method of <code>Room</code>

Example (When you say anything in a room, it will get room topic. )

const bot = new Wechaty()
bot
.on('message', async m => {
  const room = m.room()
  if (room) {
    const topic = await room.topic()
    console.log(`room topic is : ${topic}`)
  }
})
.start()

Example (When you say anything in a room, it will change room topic. )

const bot = new Wechaty()
bot
.on('message', async m => {
  const room = m.room()
  if (room) {
    const oldTopic = await room.topic()
    await room.topic('change topic to wechaty!')
    console.log(`room topic change from ${oldTopic} to ${room.topic()}`)
  }
})
.start()

<a name="Room+announce"></a>

room.announce([text]) ⇒ <code>Promise.<(void|string)></code>

SET/GET announce from the room

Tips: It only works when bot is the owner of the room.

This function is depending on the Puppet Implementation, see puppet-compatible-table

Kind: instance method of <code>Room</code>

Example (When you say anything in a room, it will get room announce. )

const bot = new Wechaty()
await bot.start()
// after logged in...
const room = await bot.Room.find({topic: 'your room'})
const announce = await room.announce()
console.log(`room announce is : ${announce}`)

Example (When you say anything in a room, it will change room announce. )

const bot = new Wechaty()
await bot.start()
// after logged in...
const room = await bot.Room.find({topic: 'your room'})
const oldAnnounce = await room.announce()
await room.announce('change announce to wechaty!')
console.log(`room announce change from ${oldAnnounce} to ${room.announce()}`)

<a name="Room+qrCode"></a>

room.qrCode() ⇒ <code>Promise.<string></code>

Get QR Code Value of the Room from the room, which can be used as scan and join the room.

Tips:

1. This function is depending on the Puppet Implementation, see puppet-compatible-table
2. The return should be the QR Code Data, instead of the QR Code Image. (the data should be less than 8KB. See: https://stackoverflow.com/a/12764370/1123955 )

Kind: instance method of <code>Room</code>
<a name="Room+alias"></a>

room.alias(contact) ⇒ <code>Promise.<(string|null)></code>

Return contact's roomAlias in the room

Kind: instance method of <code>Room</code>
Returns: <code>Promise.<(string|null)></code> - - If a contact has an alias in room, return string, otherwise return null

Example

const bot = new Wechaty()
bot
.on('message', async m => {
  const room = m.room()
  const contact = m.from()
  if (room) {
    const alias = await room.alias(contact)
    console.log(`${contact.name()} alias is ${alias}`)
  }
})
.start()

<a name="Room+has"></a>

room.has(contact) ⇒ <code>Promise.<boolean></code>

Check if the room has member contact, the return is a Promise and must be await-ed

Kind: instance method of <code>Room</code>
Returns: <code>Promise.<boolean></code> - Return true if has contact, else return false.

Example (Check whether 'lijiarui' is in the room 'wechaty')

const bot = new Wechaty()
await bot.start()
// after logged in...
const contact = await bot.Contact.find({name: 'lijiarui'})   // change 'lijiarui' to any of contact in your WeChat
const room = await bot.Room.find({topic: 'wechaty'})         // change 'wechaty' to any of the room in your WeChat
if (contact && room) {
  if (await room.has(contact)) {
    console.log(`${contact.name()} is in the room wechaty!`)
  } else {
    console.log(`${contact.name()} is not in the room wechaty!`)
  }
}

<a name="Room+memberAll"></a>

room.memberAll([query]) ⇒ <code>Promise.<Array.<Contact>></code>

Find all contacts in a room

definition

• name the name-string set by user-self, should be called name, equal to Contact.name()
• roomAlias the name-string set by user-self in the room, should be called roomAlias
• contactAlias the name-string set by bot for others, should be called alias, equal to Contact.alias()

Kind: instance method of <code>Room</code>

Example

const roomList:Contact[] | null = await room.findAll()
if(roomList)
 console.log(`room all member list: `, roomList)
const memberContactList: Contact[] | null =await room.findAll(`abc`)
console.log(`contact list with all name, room alias, alias are abc:`, memberContactList)

<a name="Room+member"></a>

room.member(queryArg) ⇒ <code>Promise.<(null|Contact)></code>

Find all contacts in a room, if get many, return the first one.

Kind: instance method of <code>Room</code>

Example (Find member by name)

const bot = new Wechaty()
await bot.start()
// after logged in...
const room = await bot.Room.find({topic: 'wechaty'})           // change 'wechaty' to any room name in your WeChat
if (room) {
  const member = await room.member('lijiarui')             // change 'lijiarui' to any room member in your WeChat
  if (member) {
    console.log(`wechaty room got the member: ${member.name()}`)
  } else {
    console.log(`cannot get member in wechaty room!`)
  }
}

Example (Find member by MemberQueryFilter)

const bot = new Wechaty()
await bot.start()
// after logged in...
const room = await bot.Room.find({topic: 'wechaty'})          // change 'wechaty' to any room name in your WeChat
if (room) {
  const member = await room.member({name: 'lijiarui'})        // change 'lijiarui' to any room member in your WeChat
  if (member) {
    console.log(`wechaty room got the member: ${member.name()}`)
  } else {
    console.log(`cannot get member in wechaty room!`)
  }
}

<a name="Room+owner"></a>

room.owner() ⇒ <code>Contact</code> | <code>null</code>

Get room's owner from the room.

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

Kind: instance method of <code>Room</code>
Example

const owner = room.owner()

<a name="Room+avatar"></a>

room.avatar() ⇒ <code>FileBox</code>

Get avatar from the room.

Kind: instance method of <code>Room</code>
Example

const fileBox = await room.avatar()
const name = fileBox.name
fileBox.toFile(name)

<a name="Room.create"></a>

Room.create(contactList, [topic]) ⇒ <code>Promise.<Room></code>

Create a new room.

Kind: static method of <code>Room</code>

Example (Creat a room with 'lijiarui' and 'huan', the room topic is 'ding - created')

const helperContactA = await Contact.find({ name: 'lijiarui' })  // change 'lijiarui' to any contact in your WeChat
const helperContactB = await Contact.find({ name: 'huan' })  // change 'huan' to any contact in your WeChat
const contactList = [helperContactA, helperContactB]
console.log('Bot', 'contactList: %s', contactList.join(','))
const room = await Room.create(contactList, 'ding')
console.log('Bot', 'createDingRoom() new ding room created: %s', room)
await room.topic('ding - created')
await room.say('ding - created')

<a name="Room.findAll"></a>

Room.findAll([query]) ⇒ <code>Promise.<Array.<Room>></code>

Find room by by filter: {topic: string | RegExp}, return all the matched room

Kind: static method of <code>Room</code>

Example

const bot = new Wechaty()
await bot.start()
// after logged in
const roomList = await bot.Room.findAll()                    // get the room list of the bot
const roomList = await bot.Room.findAll({topic: 'wechaty'})  // find all of the rooms with name 'wechaty'

<a name="Room.find"></a>

Room.find(query) ⇒ <code>Promise.<(Room|null)></code>

Try to find a room by filter: {topic: string | RegExp}. If get many, return the first one.

Kind: static method of <code>Room</code>
Returns: <code>Promise.<(Room|null)></code> - If can find the room, return Room, or return null

Example

const bot = new Wechaty()
await bot.start()
// after logged in...
const roomList = await bot.Room.find()
const roomList = await bot.Room.find({topic: 'wechaty'})

<a name="Contact"></a>

Contact

All wechat contacts(friend) will be encapsulated as a Contact. Examples/Contact-Bot

Kind: global class
Properties

• Contact
  • instance
    • .say(something) ⇒ <code>Promise.<(void|Message)></code>
    • .name() ⇒ <code>string</code>
    • .alias(newAlias) ⇒ <code>Promise.<(null|string|void)></code>
    • .friend() ⇒ <code>boolean</code> | <code>null</code>
    • .type() ⇒ <code>ContactType.Unknown</code> | <code>ContactType.Personal</code> | <code>ContactType.Official</code>
    • .gender() ⇒ <code>ContactGender.Unknown</code> | <code>ContactGender.Male</code> | <code>ContactGender.Female</code>
    • .province() ⇒ <code>string</code> | <code>null</code>
    • .city() ⇒ <code>string</code> | <code>null</code>
    • .avatar() ⇒ <code>Promise.<FileBox></code>
    • .tags() ⇒ <code>Promise.<Array.<Tag>></code>
    • .sync() ⇒ <code>Promise.<this></code>
    • .self() ⇒ <code>boolean</code>
  • static
    • .find(query) ⇒ <code>Promise.<(Contact|null)></code>
    • .findAll([queryArg]) ⇒ <code>Promise.<Array.<Contact>></code>
    • .tags() ⇒ <code>Promise.<Array.<Tag>></code>

<a name="Contact+say"></a>

contact.say(something) ⇒ <code>Promise.<(void|Message)></code>

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

Kind: instance method of <code>Contact</code>

Example

const bot = new Wechaty()
await bot.start()
const contact = await bot.Contact.find({name: 'lijiarui'})  // change 'lijiarui' to any of your contact name in wechat

// 1. send text to contact

await contact.say('welcome to wechaty!')
const msg = await contact.say('welcome to wechaty!') // only supported by puppet-padplus

// 2. send media file to contact

import { FileBox }  from 'wechaty'
const fileBox1 = FileBox.fromUrl('https://wechaty.github.io/wechaty/images/bot-qr-code.png')
const fileBox2 = FileBox.fromFile('/tmp/text.txt')
await contact.say(fileBox1)
const msg1 = await contact.say(fileBox1) // only supported by puppet-padplus
await contact.say(fileBox2)
const msg2 = await contact.say(fileBox2) // only supported by puppet-padplus

// 3. send contact card to contact

const contactCard = bot.Contact.load('contactId')
const msg = await contact.say(contactCard) // only supported by puppet-padplus

// 4. send url link to contact

const urlLink = new UrlLink ({
  description : 'WeChat Bot SDK for Individual Account, Powered by TypeScript, Docker, and Love',
  thumbnailUrl: 'https://avatars0.githubusercontent.com/u/25162437?s=200&v=4',
  title       : 'Welcome to Wechaty',
  url         : 'https://github.com/wechaty/wechaty',
})
await contact.say(urlLink)
const msg = await contact.say(urlLink) // only supported by puppet-padplus

// 5. send mini program to contact

const miniProgram = new MiniProgram ({
  username           : 'gh_xxxxxxx',     //get from mp.weixin.qq.com
  appid              : '',               //optional, get from mp.weixin.qq.com
  title              : '',               //optional
  pagepath           : '',               //optional
  description        : '',               //optional
  thumbnailurl       : '',               //optional
})
await contact.say(miniProgram)
const msg = await contact.say(miniProgram) // only supported by puppet-padplus

<a name="Contact+name"></a>

contact.name() ⇒ <code>string</code>

Get the name from a contact

Kind: instance method of <code>Contact</code>
Example

const name = contact.name()

<a name="Contact+alias"></a>

contact.alias(newAlias) ⇒ <code>Promise.<(null|string|void)></code>

GET / SET / DELETE the alias for a contact

Tests show it will failed if set alias too frequently(60 times in one minute).

Kind: instance method of <code>Contact</code>

Example ( GET the alias for a contact, return {(Promise<string | null>)})

const alias = await contact.alias()
if (alias === null) {
  console.log('You have not yet set any alias for contact ' + contact.name())
} else {
  console.log('You have already set an alias for contact ' + contact.name() + ':' + alias)
}

Example (SET the alias for a contact)

try {
  await contact.alias('lijiarui')
  console.log(`change ${contact.name()}'s alias successfully!`)
} catch (e) {
  console.log(`failed to change ${contact.name()} alias!`)
}

Example (DELETE the alias for a contact)

try {
  const oldAlias = await contact.alias(null)
  console.log(`delete ${contact.name()}'s alias successfully!`)
  console.log('old alias is ${oldAlias}`)
} catch (e) {
  console.log(`failed to delete ${contact.name()}'s alias!`)
}

<a name="Contact+friend"></a>

contact.friend() ⇒ <code>boolean</code> | <code>null</code>

Check if contact is friend

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

Kind: instance method of <code>Contact</code>
Returns: <code>boolean</code> | <code>null</code> - True for friend of the bot

False for not friend of the bot, null for unknown.
Example

const isFriend = contact.friend()

<a name="Contact+type"></a>

contact.type() ⇒ <code>ContactType.Unknown</code> | <code>ContactType.Personal</code> | <code>ContactType.Official</code>

Return the type of the Contact

Tips: ContactType is enum here.</br>

Kind: instance method of <code>Contact</code>
Example

const bot = new Wechaty()
await bot.start()
const isOfficial = contact.type() === bot.Contact.Type.Official

<a name="Contact+gender"></a>

contact.gender() ⇒ <code>ContactGender.Unknown</code> | <code>ContactGender.Male</code> | <code>ContactGender.Female</code>

Contact gender

Tips: ContactGender is enum here. </br>

Kind: instance method of <code>Contact</code>
Example

const gender = contact.gender() === bot.Contact.Gender.Male

<a name="Contact+province"></a>

contact.province() ⇒ <code>string</code> | <code>null</code>

Get the region 'province' from a contact

Kind: instance method of <code>Contact</code>
Example

const province = contact.province()

<a name="Contact+city"></a>

contact.city() ⇒ <code>string</code> | <code>null</code>

Get the region 'city' from a contact

Kind: instance method of <code>Contact</code>
Example

const city = contact.city()

<a name="Contact+avatar"></a>

contact.avatar() ⇒ <code>Promise.<FileBox></code>

Get avatar picture file stream

Kind: instance method of <code>Contact</code>
Example

// Save avatar to local file like `1-name.jpg`

const file = await contact.avatar()
const name = file.name
await file.toFile(name, true)
console.log(`Contact: ${contact.name()} with avatar file: ${name}`)

<a name="Contact+tags"></a>

contact.tags() ⇒ <code>Promise.<Array.<Tag>></code>

Get all tags of contact

Kind: instance method of <code>Contact</code>
Example

const tags = await contact.tags()

<a name="Contact+sync"></a>

contact.sync() ⇒ <code>Promise.<this></code>

Force reload data for Contact, Sync data from low-level API again.

Kind: instance method of <code>Contact</code>
Example

await contact.sync()

<a name="Contact+self"></a>

contact.self() ⇒ <code>boolean</code>

Check if contact is self

Kind: instance method of <code>Contact</code>
Returns: <code>boolean</code> - True for contact is self, False for contact is others
Example

const isSelf = contact.self()

<a name="Contact.find"></a>

Contact.find(query) ⇒ <code>Promise.<(Contact|null)></code>

Try to find a contact by filter: {name: string | RegExp} / {alias: string | RegExp}

Find contact by name or alias, if the result more than one, return the first one.

Kind: static method of <code>Contact</code>
Returns: <code>Promise.<(Contact|null)></code> - If can find the contact, return Contact, or return null

Example

const bot = new Wechaty()
await bot.start()
const contactFindByName = await bot.Contact.find({ name:"ruirui"} )
const contactFindByAlias = await bot.Contact.find({ alias:"lijiarui"} )

<a name="Contact.findAll"></a>

Contact.findAll([queryArg]) ⇒ <code>Promise.<Array.<Contact>></code>

Find contact by name or alias

If use Contact.findAll() get the contact list of the bot.

definition

• name the name-string set by user-self, should be called name
• alias the name-string set by bot for others, should be called alias

Kind: static method of <code>Contact</code>

Example

const bot = new Wechaty()
await bot.start()
const contactList = await bot.Contact.findAll()                      // get the contact list of the bot
const contactList = await bot.Contact.findAll({ name: 'ruirui' })    // find all of the contacts whose name is 'ruirui'
const contactList = await bot.Contact.findAll({ alias: 'lijiarui' }) // find all of the contacts whose alias is 'lijiarui'

<a name="Contact.tags"></a>

Contact.tags() ⇒ <code>Promise.<Array.<Tag>></code>

Get tags for all contact

Kind: static method of <code>Contact</code>
Example

const tags = await wechaty.Contact.tags()

<a name="ContactSelf"></a>

ContactSelf

Bot itself will be encapsulated as a ContactSelf.

Tips: this class is extends Contact

Kind: global class

• ContactSelf
  • .avatar([file]) ⇒ <code>Promise.<(void|FileBox)></code>
  • .qrcode() ⇒ <code>Promise.<string></code>
  • .signature(signature)

<a name="ContactSelf+avatar"></a>

contactSelf.avatar([file]) ⇒ <code>Promise.<(void|FileBox)></code>

GET / SET bot avatar

Kind: instance method of <code>ContactSelf</code>

Example ( GET the avatar for bot, return {Promise<FileBox>})

// Save avatar to local file like `1-name.jpg`

bot.on('login', (user: ContactSelf) => {
  console.log(`user ${user} login`)
  const file = await user.avatar()
  const name = file.name
  await file.toFile(name, true)
  console.log(`Save bot avatar: ${contact.name()} with avatar file: ${name}`)
})

Example (SET the avatar for a bot)

import { FileBox }  from 'wechaty'
bot.on('login', (user: ContactSelf) => {
  console.log(`user ${user} login`)
  const fileBox = FileBox.fromUrl('https://wechaty.github.io/wechaty/images/bot-qr-code.png')
  await user.avatar(fileBox)
  console.log(`Change bot avatar successfully!`)
})

<a name="ContactSelf+qrcode"></a>

contactSelf.qrcode() ⇒ <code>Promise.<string></code>

Get bot qrcode

Kind: instance method of <code>ContactSelf</code>
Example

import { generate } from 'qrcode-terminal'
bot.on('login', (user: ContactSelf) => {
  console.log(`user ${user} login`)
  const qrcode = await user.qrcode()
  console.log(`Following is the bot qrcode!`)
  generate(qrcode, { small: true })
})

<a name="ContactSelf+signature"></a>

contactSelf.signature(signature)

Change bot signature

Kind: instance method of <code>ContactSelf</code>

Example

bot.on('login', async user => {
  console.log(`user ${user} login`)
  try {
    await user.signature(`Signature changed by wechaty on ${new Date()}`)
  } catch (e) {
    console.error('change signature failed', e)
  }
})

<a name="Friendship"></a>

Friendship

Send, receive friend request, and friend confirmation events.

1. send request
2. receive request(in friend event)
3. confirmation friendship(friend event)

Examples/Friend-Bot

Kind: global class

• Friendship
  • instance
    • .accept() ⇒ <code>Promise.<void></code>
    • .hello() ⇒ <code>string</code>
    • .contact() ⇒ <code>Contact</code>
    • .type() ⇒ <code>FriendshipType</code>
    • .toJSON() ⇒ <code>FriendshipPayload</code>
  • static
    • .search(condition) ⇒ <code>Promise.<Contact></code>
    • .add(contact, options) ⇒ <code>Promise.<void></code>
    • .fromJSON()

<a name="Friendship+accept"></a>

friendship.accept() ⇒ <code>Promise.<void></code>

Accept Friend Request

Kind: instance method of <code>Friendship</code>
Example

const bot = new Wechaty()
bot.on('friendship', async friendship => {
  try {
    console.log(`received friend event.`)
    switch (friendship.type()) {

    // 1. New Friend Request

    case Friendship.Type.Receive:
      await friendship.accept()
      break

    // 2. Friend Ship Confirmed

    case Friendship.Type.Confirm:
      console.log(`friend ship confirmed`)
      break
    }
  } catch (e) {
    console.error(e)
  }
}
.start()

<a name="Friendship+hello"></a>

friendship.hello() ⇒ <code>string</code>

Get verify message from

Kind: instance method of <code>Friendship</code>
Example (If request content is `ding`, then accept the friendship)

const bot = new Wechaty()
bot.on('friendship', async friendship => {
  try {
    console.log(`received friend event from ${friendship.contact().name()}`)
    if (friendship.type() === Friendship.Type.Receive && friendship.hello() === 'ding') {
      await friendship.accept()
    }
  } catch (e) {
    console.error(e)
  }
}
.start()

<a name="Friendship+contact"></a>

friendship.contact() ⇒ <code>Contact</code>

Get the contact from friendship

Kind: instance method of <code>Friendship</code>
Example

const bot = new Wechaty()
bot.on('friendship', async friendship => {
  const contact = friendship.contact()
  const name = contact.name()
  console.log(`received friend event from ${name}`)
}
.start()

<a name="Friendship+type"></a>

friendship.type() ⇒ <code>FriendshipType</code>

Return the Friendship Type

Tips: FriendshipType is enum here. </br>

• FriendshipType.Unknown </br>
• FriendshipType.Confirm </br>
• FriendshipType.Receive </br>
• FriendshipType.Verify </br>

Kind: instance method of <code>Friendship</code>
Example (If request content is `ding`, then accept the friendship)

const bot = new Wechaty()
bot.on('friendship', async friendship => {
  try {
    if (friendship.type() === Friendship.Type.Receive && friendship.hello() === 'ding') {
      await friendship.accept()
    }
  } catch (e) {
    console.error(e)
  }
}
.start()

<a name="Friendship+toJSON"></a>

friendship.toJSON() ⇒ <code>FriendshipPayload</code>

get friendShipPayload Json

Kind: instance method of <code>Friendship</code>
Example

const bot = new Wechaty()
bot.on('friendship', async friendship => {
  try {
    // JSON.stringify(friendship) as well.
    const payload = await friendship.toJSON()
  } catch (e) {
    console.error(e)
  }
}
.start()

<a name="Friendship.search"></a>

Friendship.search(condition) ⇒ <code>Promise.<Contact></code>

Search a Friend by phone or weixin.

The best practice is to search friend request once per minute. Remember not to do this too frequently, or your account may be blocked.

Kind: static method of <code>Friendship</code>

Example

const friend_phone = await bot.Friendship.search({phone: '13112341234'})
const friend_weixin = await bot.Friendship.search({weixin: 'weixin_account'})

console.log(`This is the new friend info searched by phone : ${friend_phone}`)
await bot.Friendship.add(friend_phone, 'hello')

<a name="Friendship.add"></a>

Friendship.add(contact, options) ⇒ <code>Promise.<void></code>

Send a Friend Request to a contact with message hello.

The best practice is to send friend request once per minute. Remeber not to do this too frequently, or your account may be blocked.

Kind: static method of <code>Friendship</code>

Example

const contact = await bot.Friendship.search({phone: '13112341234'})
await bot.Friendship.add(contact, 'Nice to meet you! I am wechaty bot!')

const memberList = await room.memberList()
for (let i = 0; i < memberList.length; i++) {
  await bot.Friendship.add(member, {
    room: room,
    hello: `Nice to meet you! I am wechaty bot from room: ${await room.topic()}!`,
  })
}

<a name="Friendship.fromJSON"></a>

Friendship.fromJSON()

create friendShip by friendshipJson

Kind: static method of <code>Friendship</code>
Example

const bot = new Wechaty()
bot.start()

const payload = '{...}'  // your saved JSON payload
const friendship = bot.FriendShip.fromJSON(friendshipFromDisk)
await friendship.accept()

<a name="Message"></a>

Message

All wechat messages will be encapsulated as a Message.

Examples/Ding-Dong-Bot

Kind: global class

• Message
  • instance
    • .talker() ⇒ <code>Contact</code>
    • .from()
    • .to() ⇒ <code>Contact</code> | <code>null</code>
    • .room() ⇒ <code>Room</code> | <code>null</code>
    • .text() ⇒ <code>string</code>
    • .toRecalled()
    • .say(textOrContactOrFile, [mention]) ⇒ <code>Promise.<(void|Message)></code>
    • .recall() ⇒ <code>Promise.<boolean></code>
    • .type() ⇒ <code>MessageType</code>
    • .self() ⇒ <code>boolean</code>
    • .mentionList() ⇒ <code>Promise.<Array.<Contact>></code>
    • .mention()
    • .mentionSelf() ⇒ <code>Promise.<boolean></code>
    • .forward(to) ⇒ <code>Promise.<void></code>
    • .date()
    • .age() ⇒ <code>number</code>
    • .toFileBox() ⇒ <code>Promise.<FileBox></code>
    • .toImage() ⇒ <code>Image</code>
    • .toContact() ⇒ <code>Promise.<Contact></code>
  • static
    • .find()
    • .findAll()

<a name="Message+talker"></a>

message.talker() ⇒ <code>Contact</code>

Get the talker of a message.

Kind: instance method of <code>Message</code>
Example

const bot = new Wechaty()
bot
.on('message', async m => {
  const talker = msg.talker()
  const text = msg.text()
  const room = msg.room()
  if (room) {
    const topic = await room.topic()
    console.log(`Room: ${topic} Contact: ${talker.name()} Text: ${text}`)
  } else {
    console.log(`Contact: ${talker.name()} Text: ${text}`)
  }
})
.start()

<a name="Message+from"></a>

message.from()

Kind: instance method of <code>Message</code>
Depreacated: Use message.talker() to replace message.from() https://github.com/wechaty/wechaty/issues/2094
<a name="Message+to"></a>

message.to() ⇒ <code>Contact</code> | <code>null</code>

Get the destination of the message Message.to() will return null if a message is in a room, use Message.room() to get the room.

Kind: instance method of <code>Message</code>
<a name="Message+room"></a>

message.room() ⇒ <code>Room</code> | <code>null</code>

Get the room from the message. If the message is not in a room, then will return null

Kind: instance method of <code>Message</code>
Example

const bot = new Wechaty()
bot
.on('message', async m => {
  const contact = msg.from()
  const text = msg.text()
  const room = msg.room()
  if (room) {
    const topic = await room.topic()
    console.log(`Room: ${topic} Contact: ${contact.name()} Text: ${text}`)
  } else {
    console.log(`Contact: ${contact.name()} Text: ${text}`)
  }
})
.start()

<a name="Message+text"></a>

message.text() ⇒ <code>string</code>

Get the text content of the message

Kind: instance method of <code>Message</code>
Example

const bot = new Wechaty()
bot
.on('message', async m => {
  const contact = msg.from()
  const text = msg.text()
  const room = msg.room()
  if (room) {
    const topic = await room.topic()
    console.log(`Room: ${topic} Contact: ${contact.name()} Text: ${text}`)
  } else {
    console.log(`Contact: ${contact.name()} Text: ${text}`)
  }
})
.start()

<a name="Message+toRecalled"></a>

message.toRecalled()

Get the recalled message

Kind: instance method of <code>Message</code>
Example

const bot = new Wechaty()
bot
.on('message', async m => {
  if (m.type() === MessageType.Recalled) {
    const recalledMessage = await m.toRecalled()
    console.log(`Message: ${recalledMessage} has been recalled.`)
  }
})
.start()

<a name="Message+say"></a>

message.say(textOrContactOrFile, [mention]) ⇒ <code>Promise.<(void|Message)></code>

Reply a Text or Media File message to the sender.

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

Kind: instance method of <code>Message</code>
See: Examples/ding-dong-bot

Example

import { FileBox }  from 'wechaty'
const bot = new Wechaty()
bot
.on('message', async m => {

// 1. send Image

  if (/^ding$/i.test(m.text())) {
    const fileBox = FileBox.fromUrl('https://wechaty.github.io/wechaty/images/bot-qr-code.png')
    await msg.say(fileBox)
    const message = await msg.say(fileBox) // only supported by puppet-padplus
  }

// 2. send Text

  if (/^dong$/i.test(m.text())) {
    await msg.say('ding')
    const message = await msg.say('ding') // only supported by puppet-padplus
  }

// 3. send Contact

  if (/^lijiarui$/i.test(m.text())) {
    const contactCard = await bot.Contact.find({name: 'lijiarui'})
    if (!contactCard) {
      console.log('not found')
      return
    }
    await msg.say(contactCard)
    const message = await msg.say(contactCard) // only supported by puppet-padplus
  }

// 4. send Link

  if (/^link$/i.test(m.text())) {
    const linkPayload = new UrlLink ({
      description : 'WeChat Bot SDK for Individual Account, Powered by TypeScript, Docker, and Love',
      thumbnailUrl: 'https://avatars0.githubusercontent.com/u/25162437?s=200&v=4',
      title       : 'Welcome to Wechaty',
      url         : 'https://github.com/wechaty/wechaty',
    })
    await msg.say(linkPayload)
    const message = await msg.say(linkPayload) // only supported by puppet-padplus
  }

// 5. send MiniProgram

  if (/^link$/i.test(m.text())) {
    const miniProgramPayload = new MiniProgram ({
      username           : 'gh_xxxxxxx',     //get from mp.weixin.qq.com
      appid              : '',               //optional, get from mp.weixin.qq.com
      title              : '',               //optional
      pagepath           : '',               //optional
      description        : '',               //optional
      thumbnailurl       : '',               //optional
    })
    await msg.say(miniProgramPayload)
    const message = await msg.say(miniProgramPayload) // only supported by puppet-padplus
  }

})
.start()

<a name="Message+recall"></a>

message.recall() ⇒ <code>Promise.<boolean></code>

Recall a message.

Tips:

Kind: instance method of <code>Message</code>
Example

const bot = new Wechaty()
bot
.on('message', async m => {
  const recallMessage = await msg.say('123')
  if (recallMessage) {
    const isSuccess = await recallMessage.recall()
  }
})

<a name="Message+type"></a>

message.type() ⇒ <code>MessageType</code>

Get the type from the message.

Tips: MessageType is Enum here. </br>

• MessageType.Unknown </br>
• MessageType.Attachment </br>
• MessageType.Audio </br>
• MessageType.Contact </br>
• MessageType.Emoticon </br>
• MessageType.Image </br>
• MessageType.Text </br>
• MessageType.Video </br>
• MessageType.Url </br>

Kind: instance method of <code>Message</code>
Example

const bot = new Wechaty()
if (message.type() === bot.Message.Type.Text) {
  console.log('This is a text message')
}

<a name="Message+self"></a>

message.self() ⇒ <code>boolean</code>

Check if a message is sent by self.

Kind: instance method of <code>Message</code>
Returns: <code>boolean</code> - - Return true for send from self, false for send from others.
Example

if (message.self()) {
 console.log('this message is sent by myself!')
}

<a name="Message+mentionList"></a>

message.mentionList() ⇒ <code>Promise.<Array.<Contact>></code>

Get message mentioned contactList.

Message event table as follows

Kind: instance method of <code>Message</code>
Returns: <code>Promise.<Array.<Contact>></code> - - Return message mentioned contactList
Example

const contactList = await message.mentionList()
console.log(contactList)

<a name="Message+mention"></a>

message.mention()

Deprecated

Kind: instance method of <code>Message</code>
<a name="Message+mentionSelf"></a>

message.mentionSelf() ⇒ <code>Promise.<boolean></code>

Check if a message is mention self.

Kind: instance method of <code>Message</code>
Returns: <code>Promise.<boolean></code> - - Return true for mention me.
Example

if (await message.mentionSelf()) {
 console.log('this message were mentioned me! [You were mentioned] tip ([有人@我]的提示)')
}

<a name="Message+forward"></a>

message.forward(to) ⇒ <code>Promise.<void></code>

Forward the received message.

Kind: instance method of <code>Message</code>

Example

const bot = new Wechaty()
bot
.on('message', async m => {
  const room = await bot.Room.find({topic: 'wechaty'})
  if (room) {
    await m.forward(room)
    console.log('forward this message to wechaty room!')
  }
})
.start()

<a name="Message+date"></a>

message.date()

Message sent date

Kind: instance method of <code>Message</code>
<a name="Message+age"></a>

message.age() ⇒ <code>number</code>

Returns the message age in seconds.

For example, the message is sent at time 8:43:01, and when we received it in Wechaty, the time is 8:43:15, then the age() will return 8:43:15 - 8:43:01 = 14 (seconds)

Kind: instance method of <code>Message</code>
Returns: <code>number</code> - message age in seconds.
<a name="Message+toFileBox"></a>

message.toFileBox() ⇒ <code>Promise.<FileBox></code>

Extract the Media File from the Message, and put it into the FileBox.

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

Kind: instance method of <code>Message</code>
Example (Save media file from a message)

const fileBox = await message.toFileBox()
const fileName = fileBox.name
fileBox.toFile(fileName)

<a name="Message+toImage"></a>

message.toImage() ⇒ <code>Image</code>

Extract the Image File from the Message, so that we can use different image sizes.

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

Kind: instance method of <code>Message</code>
Example (Save image file from a message)

const image = message.toImage()
const fileBox = await image.artwork()
const fileName = fileBox.name
fileBox.toFile(fileName)

<a name="Message+toContact"></a>

message.toContact() ⇒ <code>Promise.<Contact></code>

Get Share Card of the Message Extract the Contact Card from the Message, and encapsulate it into Contact class

Tips: This function is depending on the Puppet Implementation, see puppet-compatible-table

Kind: instance method of <code>Message</code>
<a name="Message.find"></a>

Message.find()

Find message in cache

Kind: static method of <code>Message</code>
<a name="Message.findAll"></a>

Message.findAll()

Find messages in cache

Kind: static method of <code>Message</code>
<a name="RoomInvitation"></a>

RoomInvitation

accept room invitation

Kind: global class

• RoomInvitation
  • instance
    • .accept() ⇒ <code>Promise.<void></code>
    • .inviter() ⇒ <code>Contact</code>
    • .topic() ⇒ <code>string</code>
    • .date() ⇒ <code>Promise.<Date></code>
    • .age() ⇒ <code>number</code>
    • .toJSON() ⇒ <code>string</code>
  • static
    • .fromJSON() ⇒ <code>RoomInvitation</code>

<a name="RoomInvitation+accept"></a>

roomInvitation.accept() ⇒ <code>Promise.<void></code>

Accept Room Invitation

Kind: instance method of <code>RoomInvitation</code>
Example

const bot = new Wechaty()
bot.on('room-invite', async roomInvitation => {
  try {
    console.log(`received room-invite event.`)
    await roomInvitation.accept()
  } catch (e) {
    console.error(e)
  }
}
.start()

<a name="RoomInvitation+inviter"></a>

roomInvitation.inviter() ⇒ <code>Contact</code>

Get the inviter from room invitation

Kind: instance method of <code>RoomInvitation</code>
Example

const bot = new Wechaty()
bot.on('room-invite', async roomInvitation => {
  const inviter = await roomInvitation.inviter()
  const name = inviter.name()
  console.log(`received room invitation event from ${name}`)
}
.start()

<a name="RoomInvitation+topic"></a>

roomInvitation.topic() ⇒ <code>string</code>

Get the room topic from room invitation

Kind: instance method of <code>RoomInvitation</code>
Example

const bot = new Wechaty()
bot.on('room-invite', async roomInvitation => {
  const topic = await roomInvitation.topic()
  console.log(`received room invitation event from room ${topic}`)
}
.start()

<a name="RoomInvitation+date"></a>

roomInvitation.date() ⇒ <code>Promise.<Date></code>

Get the invitation time

Kind: instance method of <code>RoomInvitation</code>
<a name="RoomInvitation+age"></a>

roomInvitation.age() ⇒ <code>number</code>

Returns the roopm invitation age in seconds.

For example, the invitation is sent at time 8:43:01, and when we received it in Wechaty, the time is 8:43:15, then the age() will return 8:43:15 - 8:43:01 = 14 (seconds)

Kind: instance method of <code>RoomInvitation</code>
<a name="RoomInvitation+toJSON"></a>

roomInvitation.toJSON() ⇒ <code>string</code>

Get the room invitation info when listened on room-invite event

Kind: instance method of <code>RoomInvitation</code>
Example

const bot = new Wechaty()
bot.on('room-invite', async roomInvitation => {
 const roomInvitation = bot.RoomInvitation.load(roomInvitation.id)
 const jsonData = await roomInvitation.toJSON(roomInvitation.id)
 // save the json data to disk, and we can use it by RoomInvitation.fromJSON()
}
.start()

<a name="RoomInvitation.fromJSON"></a>

RoomInvitation.fromJSON() ⇒ <code>RoomInvitation</code>

Load the room invitation info from disk

Kind: static method of <code>RoomInvitation</code>
Example

const bot = new Wechaty()
const dataFromDisk // get the room invitation info data from disk
const roomInvitation = await bot.RoomInvitation.fromJSON(dataFromDisk)
await roomInvitation.accept()

<a name="cuid_1"></a>

cuid_1

Wechaty Chatbot SDK - https://github.com/wechaty/wechaty

Kind: global constant
Copyright: 2016 Huan LI (李卓桓) https://github.com/huan, and Wechaty Contributors https://github.com/wechaty.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
<a name="clone_class_1"></a>

clone_class_1

Wechaty Chatbot SDK - https://github.com/wechaty/wechaty

Kind: global constant
Copyright: 2016 Huan LI (李卓桓) https://github.com/huan, and Wechaty Contributors https://github.com/wechaty.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
<a name="clone_class_1"></a>

clone_class_1

Wechaty Chatbot SDK - https://github.com/wechaty/wechaty

Kind: global constant
Copyright: 2016 Huan LI (李卓桓) https://github.com/huan, and Wechaty Contributors https://github.com/wechaty.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
<a name="wechaty_puppet_1"></a>

wechaty_puppet_1

Wechaty Chatbot SDK - https://github.com/wechaty/wechaty

Kind: global constant
Copyright: 2016 Huan LI (李卓桓) https://github.com/huan, and Wechaty Contributors https://github.com/wechaty.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
<a name="events_1"></a>

events_1

Wechaty Chatbot SDK - https://github.com/wechaty/wechaty

Kind: global constant
Copyright: 2016 Huan LI (李卓桓) https://github.com/huan, and Wechaty Contributors https://github.com/wechaty.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
<a name="events_1"></a>

events_1

Wechaty Chatbot SDK - https://github.com/wechaty/wechaty

Kind: global constant
Copyright: 2016 Huan LI (李卓桓) https://github.com/huan, and Wechaty Contributors https://github.com/wechaty.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
<a name="clone_class_1"></a>

clone_class_1

Wechaty Chatbot SDK - https://github.com/wechaty/wechaty

Kind: global constant
Copyright: 2016 Huan LI (李卓桓) https://github.com/huan, and Wechaty Contributors https://github.com/wechaty.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
<a name="guardWechatify"></a>

guardWechatify()

Huan(202008): we will bind the wechaty puppet with user modules (Contact, Room, etc) together inside the start() method

Kind: global function
<a name="PuppetModuleName"></a>

PuppetModuleName

The term Puppet in Wechaty is an Abstract Class for implementing protocol plugins. The plugins are the component that helps Wechaty to control the WeChat(that's the reason we call it puppet). The plugins are named XXXPuppet, for example:

• PuppetPuppeteer:
• PuppetPadchat

Kind: global typedef
Properties

<a name="WechatyOptions"></a>

WechatyOptions

The option parameter to create a wechaty instance

Kind: global typedef
Properties

<a name="RoomQueryFilter"></a>

RoomQueryFilter

The filter to find the room: {topic: string | RegExp}

Kind: global typedef
Properties

<a name="RoomEventName"></a>

RoomEventName

Room Class Event Type

Kind: global typedef
Properties

                           If someone leaves the room by themselves, WeChat will not notice other people in the room, so the bot will never get the "leave" event. |

<a name="RoomEventFunction"></a>

RoomEventFunction

Room Class Event Function

Kind: global typedef
Properties

<a name="RoomMemberQueryFilter"></a>

RoomMemberQueryFilter

The way to search member by Room.member()

Kind: global typedef
Properties

<a name="ContactQueryFilter"></a>

ContactQueryFilter

The way to search Contact

Kind: global typedef
Properties