👤 Contacts

Methods for contacts.

Endpoints #

See the list of engines that support the feature ->.

Get all contacts #

Get your contacts - GET /api/contacts/all

[
  {
    "id": "11231231231@c.us",
    "number": "11231231231",
    "name": "Contact Name",
    "pushname": "Pushname",
    "shortName": "Shortname",
    "isMe": true,
    "isGroup": false,
    "isWAContact": true,
    "isMyContact": true,
    "isBlocked": false
  }
]

Get contact #

Get contact

• GET /api/contacts?contactId=11231231231&session=default
• GET /api/contacts?contactId=11231231231@c.us&session=default

{
  "id": "11231231231@c.us",
  "number": "11231231231",
  "name": "Contact Name",
  "pushname": "Pushname",
  "shortName": "Shortname",
  "isMe": true,
  "isGroup": false,
  "isWAContact": true,
  "isMyContact": true,
  "isBlocked": false
}

Check phone number exists #

If you want to check if phone number is registered in WhatsApp (even if the number is not in your contact list) - use this endpoint for that.

GET /api/contacts/check-exists?phone=11231231231&session=default

It returns numberExists field with true or false value and chatId field with chat ID of the number (if exists).

{
  "numberExists": true,
  "chatId": "123123123@c.us"
}

Note for Brazilian Phone Numbers

You should use the GET /api/contacts/check-exists endpoint before sending a message to a new phone number to get the correct chatId because of the additional 9-digit number added after 2012.

Read more about error sending text to half of Brazilian numbers (every number registered before 2012) ->

It’s fine to send the response to chatId for incoming messages, though - the payload already has the correct chatId.

Get “about” contact #

• GET /api/contacts/about?contactId=11231231231&session=default

{
  "about": "Hi, I use WhatsApp!"
}

Get contact profile picture #

• GET /api/contacts/profile-picture?contactId=11231231231&session=default

{
  "profilePictureURL": "https://example.com/profile.jpg"
}

Block (unblock) contact #

• To block contact - POST /api/contacts/block
• To unblock contact - POST /api/contacts/unblock

Request:

{
  "contactId": "11231231231",
  "session": "default"
}