wppconnect-api / docs /getting-started /basic-functions.md
AUXteam's picture
Upload folder using huggingface_hub
4c34106 verified

Basic functions (usage)

Not every available function will be listed, for further look, every function available can be found in {@link Whatsapp}

Summary

Chatting

Here, chatId could be <phoneNumber>@c.us or <phoneNumber>-<groupId>@g.us

sendContactVcard

Send contact

await client
  .sendContactVcard('000000000000@c.us', '111111111111@c.us', 'Name of contact')
  .then((result) => {
    console.log('Result: ', result); //return object success
  })
  .catch((erro) => {
    console.error('Error when sending: ', erro); //return object error
  });

sendContactVcardList

Send a list of contact cards

await client
  .sendContactVcardList('000000000000@c.us', [
    '111111111111@c.us',
    '222222222222@c.us',
  ])
  .then((result) => {
    console.log('Result: ', result); //return object success
  })
  .catch((erro) => {
    console.error('Error when sending: ', erro); //return object error
  });

sendText

Send basic text

await client
  .sendText('000000000000@c.us', '👋 Hello from wppconnect!')
  .then((result) => {
    console.log('Result: ', result); //return object success
  })
  .catch((erro) => {
    console.error('Error when sending: ', erro); //return object error
  });

sendLocation

Send location

await client
  .sendLocation('000000000000@c.us', '-13.6561589', '-69.7309264', 'Brasil')
  .then((result) => {
    console.log('Result: ', result); //return object success
  })
  .catch((erro) => {
    console.error('Error when sending: ', erro); //return object error
  });

sendLinkPreview

Automatically sends a link with the auto-generated link preview. You can also add a custom message to be added.

await client
  .sendLinkPreview(
    '000000000000@c.us',
    'https://www.youtube.com/watch?v=V1bFr2SWP1I',
    'Kamakawiwo ole'
  )
  .then((result) => {
    console.log('Result: ', result); //return object success
  })
  .catch((erro) => {
    console.error('Error when sending: ', erro); //return object error
  });

sendImage

Send an image (you can also upload an image using a valid HTTP protocol)

await client
  .sendImage(
    '000000000000@c.us',
    'path/to/img.jpg',
    'image-name',
    'Caption text'
  )
  .then((result) => {
    console.log('Result: ', result); //return object success
  })
  .catch((erro) => {
    console.error('Error when sending: ', erro); //return object error
  });

sendFile

Send a file (wppconnect will take care of mime types, just needs the path).
You can also upload an image using a valid HTTP protocol

await client
  .sendFile(
    '000000000000@c.us',
    'path/to/file.pdf',
    'file_name',
    'See my file in pdf'
  )
  .then((result) => {
    console.log('Result: ', result); //return object success
  })
  .catch((erro) => {
    console.error('Error when sending: ', erro); //return object error
  });

sendFileFromBase64

Sends a file.

base64 parameter should have mime type already defined

await client
  .sendFileFromBase64(
    '000000000000@c.us',
    base64PDF,
    'file_name.pdf',
    'See my file in pdf'
  )
  .then((result) => {
    console.log('Result: ', result); //return object success
  })
  .catch((erro) => {
    console.error('Error when sending: ', erro); //return object error
  });

sendImageAsStickerGif

Generates a sticker from the provided animated gif image and sends it (Send an image as an animated sticker)
Image path imageBase64 A valid gif and webp image will be required. You can also send it via HTTP/HTTPS (http://www.website.com/img.gif)

await client
  .sendImageAsStickerGif('000000000000@c.us', './image.gif')
  .then((result) => {
    console.log('Result: ', result); //return object success
  })
  .catch((erro) => {
    console.error('Error when sending: ', erro); //return object error
  });

sendImageAsSticker

Generates a sticker from a given image and sends it (Send Image As Sticker)
image path imageBase64 A valid PNG, JPG, and WebP image will be required. You can also send it via HTTP/HTTPS (http://www.website.com/img.jpg)

await client
  .sendImageAsSticker('000000000000@c.us', './image.jpg')
  .then((result) => {
    console.log('Result: ', result); //return object success
  })
  .catch((erro) => {
    console.error('Error when sending: ', erro); //return object error
  });

sendMentioned

Send @tagged message

await client.sendMentioned(
  '000000000000@c.us',
  'Hello @5218113130740 and @5218243160777!',
  ['5218113130740', '5218243160777']
);

reply

Reply to a message

await client.sendText(
  '000000000000@c.us',
  'This is a reply!',
  { quotedMsg: message.id.toString() }
);

reply with mention

Reply to a message with a mention

await client.sendText(
  '000000000000@c.us',
  'Hello @5218113130740 and @5218243160777! This is a reply with mention!',
  {
    quotedMsg: message.id.toString(),
    detectMentioned: true, //either automatically detect the mentions
    mentionedList: ['5218113130740', '5218243160777'] //or supply them manually
  }
}
);

sendMessageOptions

Send a message with options

await client
    .sendMessageOptions(
      '000000000000@c.us',
      'This is a reply!',
       {
          quotedMessage: message.id,
        }
    )
    .then((result) => {
        console.log(result);
    })
    .catch((e) => {
      console.log(e);
    });

sendVideoAsGif

Send a gif

await client.sendVideoAsGif(
  '000000000000@c.us',
  'path/to/video.mp4',
  'video.gif',
  'Gif image file'
);

forwardMessages

Forwards messages

await client.forwardMessages(
  '000000000000@c.us',
  [message.id.toString()],
  true
);

sendSeen

Send seen ✔️✔️

await client.sendSeen('000000000000@c.us');

startTyping

Start typing...

await client.startTyping('000000000000@c.us');

stopTyping

Stop typing

await client.stopTyping('000000000000@c.us');

setChatState

Set chat state (0: Typing, 1: Recording, 2: Paused)

await client.setChatState('000000000000@c.us', 0 | 1 | 2);