Skip to Content
Wazend

Kontakte

Verwalte WhatsApp-Kontakte mit Wazend: auflisten, abrufen, aktualisieren, Nummern überprüfen, blockieren und LIDs abfragen.

Methoden zum Verwalten von WhatsApp-Kontakten. WhatsApp Web erlaubt das Hinzufügen von Kontakten nicht, daher unterstützt die API es auch nicht.

@lid und @c.us

WhatsApp weist jedem Nutzer eine eindeutige LID (lokale Kennung) zu, um seine Telefonnummer in Gruppen und an anderen Orten zu verbergen. Du kannst jeden über seine LID oder seine PN (Telefonnummer, @c.us) anschreiben.

Tipp

Verwende die LIDs-API, um zwischen einer Telefonnummer (@c.us) und einer @lid zuzuordnen.

Alle Kontakte abrufen

GET /api/contacts/all?session=S0001
Antwort
[
  {
    "id": "5215551234567@c.us",
    "number": "5215551234567",
    "name": "Juan Pérez",
    "pushname": "Juan",
    "shortName": "Juan",
    "isMe": false,
    "isGroup": false,
    "isWAContact": true,
    "isMyContact": true,
    "isBlocked": false
  }
]

Abfrageparameter:

GET /api/contacts/all?session=S0001&limit=100&offset=0&sortBy=id&sortOrder=asc
  • limit / offset — Paginierung.
  • sortBy — id oder name.
  • sortOrder — desc oder asc.

Kontakt abrufen

GET /api/contacts?contactId=5215551234567&session=S0001

Die contactId kann eine Telefonnummer (5215551234567) oder eine Chat-ID (5215551234567@c.us oder 5215551234567@lid) sein.

Kontakt aktualisieren

Aktualisiere den Kontakt in deinem Telefonbuch und in WhatsApp:

PUT /api/{session}/contacts/{chatId}
Body
{
  "firstName": "Juan",
  "lastName": "Pérez"
}

Überprüfen, ob die Nummer existiert

GET /api/contacts/check-exists?phone=5215551234567&session=S0001
Antwort
{
  "numberExists": true,
  "chatId": "5215551234567@c.us",
  "pn": "5215551234567@c.us"
}

Nummern aus Brasilien

Verwende check-exists, bevor du an eine neue Nummer sendest, um die richtige chatId zu erhalten (wegen der nach 2012 hinzugefügten Ziffer 9).

"about" des Kontakts abrufen

GET /api/contacts/about?contactId=5215551234567&session=S0001
Antwort
{ "about": "Hallo, ich nutze WhatsApp!" }

Profilbild abrufen

GET /api/contacts/profile-picture?contactId=5215551234567&session=S0001&refresh=true
Antwort
{ "profilePictureURL": "https://ejemplo.com/perfil.jpg" }

Kontakt blockieren / entsperren

POST /api/contacts/block
POST /api/contacts/unblock
Body
{
  "contactId": "5215551234567",
  "session": "S0001"
}

LIDs-API

Ordne eine verknüpfte Kennung (@lid) einer Telefonnummer (@c.us) in beide Richtungen zu.

Alle bekannten LIDs abrufen

GET /api/{session}/lids?limit=100&offset=0
Antwort
[
  {
    "lid": "5215551234567@lid",
    "pn": "5215551234567@c.us"
  }
]

Anzahl der LIDs abrufen

GET /api/{session}/lids/count
Antwort
{ "count": 123 }

Nummer per LID abrufen

GET /api/{session}/lids/{lid}

Denke daran, @ mit %40 zu escapen, oder verwende nur die Nummer.

Antwort
{
  "lid": "5215551234567@lid",
  "pn": "5215551234567@c.us"
}

LID per Telefonnummer abrufen

GET /api/{session}/lids/pn/{phoneNumber}
Antwort
{
  "lid": "5215551234567@lid",
  "pn": "5215551234567@c.us"
}

Lids FAQ

Wenn du eine Nummer per LID nicht findest, hast du diese Nummer nicht in deiner Kontaktliste oder du bist kein Gruppenadministrator. Versuche es für Gruppen mit Gruppen aktualisieren.