Uau! Emoji cu un bărbat fericit Mediu sandbox complet pentru dezvoltatori — gratuit pentru totdeauna! Înregistrați-vă acum
Caz de utilizare: de la WhatsApp LID la număr de telefon

Rezolvați @lid-ul WhatsApp într-un număr de telefon

WhatsApp poate trimite un identificator @lid în loc de un număr de telefon — în răspunsurile API, webhook-uri, exporturile de grupuri sau câmpurile CRM. Totuși, stack-ul dumneavoastră tehnologic are nevoie de un număr standard. API-ul Whapi.Cloud rezolvă această problemă: conectați contul de WhatsApp o singură dată și rezolvați @lid-ul cu GET /contacts/ids/{ContactLID}, având un comportament clar atunci când potrivirea nu este încă disponibilă.

Căutare sigură împotriva blocării Sandbox gratuit
WhatsApp LID to phone number use case
Bulă decorativă
Leagă WhatsApp o dată — canalul tău stochează datele @lid ↔ telefon

Începe în 3 pași

Register and pair WhatsApp via QR

Asociază numărul via QR

Înregistrează-te gratuit, deschide canalul Sandbox și scanează codul QR ca pe WhatsApp Web. Canalul tău colectează mapări @lid ↔ telefon din trafic.

Copy API token

Obține token-ul API

Copiază Bearer token-ul canalului și explorează REST API în curl, Postman sau Swagger — înainte de prima căutare LID.

Call getIdByLid API

Rezolvă @lid la un număr de telefon

Apelează GET /contacts/ids/{ContactLID} cu @lid dintr-un mesaj, webhook sau răspuns API. Autorizează cu Bearer token.

Prezentare caz de utilizare

Transformă @lid într-un număr pe care instrumentele tale îl înțeleg

WhatsApp vă poate furniza un Linked ID (@lid) acolo unde CRM-ul, scripturile sau automatizările dumneavoastră așteaptă un număr de telefon. Contul de WhatsApp conectat funcționează ca un canal care colectează mapările @lid ↔ telefon din traficul normal. Whapi rezolvă @lid-ul într-un număr complet atunci când acel canal are deja maparea și returnează un HTTP 404 onest când nu o are, permițându-vă să stocați @lid-ul și să reîncercați mai târziu, deoarece numărul de telefon poate apărea în datele canalului în timp.

  • Obțineți numărul de telefon complet dacă canalul dumneavoastră cunoaște deja acel contact

  • Un singur apel GET: caută exclusiv în cache-ul canalului, fără a trimite o nouă cerere către WhatsApp

  • HTTP 404: stocați @lid-ul și reîncercați mai târziu; maparea poate apărea în timp

Deschide Sandbox — începe rezolvarea
Ce obții

Un apel API: @lid → telefon

154662208577626@lidGET /contacts/ids/{ContactLID}[email protected]

Cerere (curl)

curl --request GET \
  --url "https://gate.whapi.cloud/contacts/ids/154662208577626%40lid" \
  --header "authorization: Bearer <CHANNEL_TOKEN>"

HTTP 200

{
  "id": "[email protected]"
}

HTTP 404

{
  "error": "User not found"
}
După ce primești @lid

Telefon sau @lid — ambele funcționează

Spre deosebire de bibliotecile care emulează browserul, Whapi rulează pe o conexiune socket directă la contul dumneavoastră de WhatsApp conectat. Căutarea explorează datele pe care canalul le-a colectat deja din mesaje, grupuri și alt trafic din acea sesiune. Un status 404 nu înseamnă că integrarea a eșuat: indică pur și simplu că WhatsApp nu a partajat încă acel număr de telefon cu sesiunea dumneavoastră.

1

Identificați @lid-ul într-un webhook, export de grup sau câmp CRM: acesta este parametrul de intrare pentru căutare.

2

Apelați getIdByLid pe același canal care a primit traficul original.

3

HTTP 200: obțineți ID-ul de chat WhatsApp complet (ex. [email protected]). Acum îl puteți fuziona în rândul de client existent în CRM-ul dumneavoastră.

4

HTTP 404: stocați @lid-ul ca cheie primară. Whapi vă permite să continuați trimiterea de mesaje și automatizarea cu @lid până când un număr de telefon apare în datele canalului.

Sigur pentru numere de producție

  • Fără mesaje trimise, fără ping-uri la contacte — fiecare căutare citește doar date cache
  • Fără cereri noi WhatsApp per GET — nimic extra pentru antispam să marcheze

BSUID și @lid funcționează la fel — identificatori de confidențialitate similari, format diferit. Această căutare se aplică ambilor. Află despre BSUID

Rezolvă @lid în orice limbaj de programare

curl --request GET \
     --url https://gate.whapi.cloud/contacts/ids/154662208577626%40lid \
     --header 'accept: application/json' \
     --header 'authorization: Bearer {your_token}'
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gate.whapi.cloud/contacts/ids/154662208577626%40lid",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer {your_token}"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
import requests

url = "https://gate.whapi.cloud/contacts/ids/154662208577626%40lid"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {your_token}"
}

response = requests.get(url, headers=headers)

print(response.text)
const url = 'https://gate.whapi.cloud/contacts/ids/154662208577626%40lid';

const response = await fetch(url, {
  method: 'GET',
  headers: {
    accept: 'application/json',
    authorization: 'Bearer {your_token}',
  },
});

console.log(await response.text());
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/contacts/ids/154662208577626%40lid")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer {your_token}")
  .build();

Response response = client.newCall(request).execute();
using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/contacts/ids/154662208577626%40lid");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("Authorization", "Bearer {your_token}");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);
Căutare bidirecțională

Începe de la @lid sau de la telefon

Folosește identificatorul pe care webhook-ul sau CRM-ul îl are deja — același Bearer token, același cache de canal.

Ai @lid → ai nevoie de telefon

GET /contacts/ids/{ContactLID} (getIdByLid)

Webhook, export grup sau rând CRM stochează @lid — fuzionează în înregistrări CRM bazate pe telefon

Ai telefon → ai nevoie de @lid

GET /contacts/lids/{ContactID} (getLidById)

API-ul outbound așteaptă @lid, dar CRM-ul tău are doar numărul. Folosește cu moderație: getLidById poate contacta WhatsApp — spre deosebire de getIdByLid, care consultă doar cache. Adaugă pauze între apeluri.

Alege endpoint-ul care se potrivește inputului — construiește ambele direcții în timp pe același canal.

De ce contează

Un contact în CRM — chiar fără telefon

Când WhatsApp trimite @lid în loc de număr, CRM-urile creează adesea duplicate și pierd istoricul. Rezolvă identificatorul programatic și fuzionează în rândul existent.

Înainte

Payload-ul are 154662208577626@lid — CRM-ul deschide un contact nou.

După

API-ul returnează 34604252681 — CRM-ul actualizează același record client.

  • Potrivește @lid cu înregistrări bazate pe telefon în CRM sau instrumente de suport

  • Construiește mapări telefon ↔ @lid pe canalul conectat pentru următoarea căutare

  • Păstrează comenzile și istoricul suport pe un singur client

CRM workflow with WhatsApp LID resolution
FAQ

Întrebări frecvente despre rezolvarea LID

Nu. Rezolvarea depinde dacă canalul conectat are deja date de telefon pentru acel @lid. Dacă API-ul returnează HTTP 404, continuați să folosiți @lid ca cheie primară și reîncearcă căutarea mai târziu; telefonul poate apărea când WhatsApp îl partajează cu sesiunea dumneavoastră. Nu efectuați interogări periodice automate (polling) pe bază de temporizator.
Nu. Fiecare căutare explorează datele pe care canalul conectat le-a primit deja de la WhatsApp (mesaje, grupuri și webhook-uri în acea sesiune). GET /contacts/ids/{ContactLID} nu trimite mesaje, nu face cereri noi către WhatsApp și nu preia informații pe care WhatsApp nu le-a partajat deja cu numărul dumneavoastră. Nu există trafic suplimentar pe care WhatsApp să-l analizeze, deci acest endpoint este complet sigur pentru numerele de producție.
Folosește GET https://gate.whapi.cloud/contacts/ids/{ContactLID} (operationId: getIdByLid). Autentifică-te cu Bearer token-ul canalului. Codifică @ în URL ca %40.
Această pagină acoperă pattern-ul standard @lid din răspunsuri API, webhook-uri și payload-uri de grup. Unele identificatoare speciale necesită alte căi de integrare — vezi ghidul developer pentru scenarii avansate.
Stochează @lid, continuați trimiterea de mesaje via @lid dacă este nevoie și reîncercați căutarea mai târziu. Nu există un interval de așteptare fix. Nu presupuneți că fiecare @lid de comunitate sau grup poate fi rezolvat invers.
Înregistrează-te gratuit pe panel.whapi.cloud, creează un canal, scanează QR pentru a conecta numărul WhatsApp, copiază token-ul canalului, apoi apelează GET /contacts/ids/{ContactLID} cu autorizare Bearer. Conectarea WhatsApp creează canalul al cărui date le caută lookup-ul.
WhatsApp-ul conectat e canalul API. Whapi stochează mapări @lid ↔ telefon din traficul acelei sesiuni — mesaje, grupuri, webhook-uri. Fără canal conectat nu e nimic de căutat. Asocierea via QR e setup, nu lookup în sine; odată conectat, apelează GET /contacts/ids/{ContactLID} pe datele acelui canal.