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[
{
"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=asclimit/offset— Paginierung.sortBy—idodername.sortOrder—descoderasc.
Kontakt abrufen
GET /api/contacts?contactId=5215551234567&session=S0001Die 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}{
"firstName": "Juan",
"lastName": "Pérez"
}Überprüfen, ob die Nummer existiert
GET /api/contacts/check-exists?phone=5215551234567&session=S0001{
"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{ "about": "Hallo, ich nutze WhatsApp!" }Profilbild abrufen
GET /api/contacts/profile-picture?contactId=5215551234567&session=S0001&refresh=true{ "profilePictureURL": "https://ejemplo.com/perfil.jpg" }Kontakt blockieren / entsperren
POST /api/contacts/blockPOST /api/contacts/unblock{
"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[
{
"lid": "5215551234567@lid",
"pn": "5215551234567@c.us"
}
]Anzahl der LIDs abrufen
GET /api/{session}/lids/count{ "count": 123 }Nummer per LID abrufen
GET /api/{session}/lids/{lid}Denke daran, @ mit %40 zu escapen, oder verwende nur die Nummer.
{
"lid": "5215551234567@lid",
"pn": "5215551234567@c.us"
}LID per Telefonnummer abrufen
GET /api/{session}/lids/pn/{phoneNumber}{
"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.