👤 Contacts

Methods for contacts.

Features #

Here’s the list of features that are available by 🏭 Engines:

1. NOWEB - you need to Enable Store to get chats, contacts and messages

If you see the feature is not available in the above list, please create a feature request or leave “+1” comment on the existing one.

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
  }
]

Pagination #

If you see timeout or the request takes too long - consider using limit parameter to get contacts in smaller chunks

GET /api/{session}/contacts/all?limit=100&offset=0&sortBy=id&sortOrder=asc

• limit=100 - limit the number of chats to return
• offset=0 - skip the number of chats from the start
• sortBy={field} - sort by field
  • sortBy=id - sort by contact id
  • sortBy=name - sort by contact name
• sortOrder=desc|asc - sort order
  • desc - descending order (A-Z)
  • asc - ascending order (Z-A)

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"
}