Wow! Mutlu adam emojisi Geliştiriciler için tam özellikli bir sandbox — tamamen ücretsiz! Şimdi Kaydol
Kullanım Senaryosu: WhatsApp LID'den Telefon Numarasına

WhatsApp @lid Değerini Telefon Numarasına Çözümleyin

WhatsApp; API yanıtlarında, webhook'larda, grup dışa aktarımlarında veya CRM alanlarında telefon numarası yerine bir @lid gönderebilir. Ancak teknoloji yığınınızın yine de standart bir numaraya ihtiyacı vardır. Whapi.Cloud API bu sorunu çözer: WhatsApp hesabınızı bir kez bağlayın ve ardından GET /contacts/ids/{ContactLID} ile @lid değerini çözümleyin — eşleme henüz hazır olmadığında net bir davranışla.

Engellenme korumalı arama Ücretsiz Sandbox
WhatsApp LID to phone number use case
Dekoratif balon
WhatsApp'ı bir kez bağlayın — kanalınız @lid ↔ telefon verilerini saklar

3 adımda başlayın

Register and pair WhatsApp via QR

Numaranızı QR ile eşleştirin

Ücretsiz kayıt olun, Sandbox kanalınızı açın ve WhatsApp Web gibi QR kodu tarayın. Kanalınız trafikten @lid ↔ telefon eşlemelerini toplar.

Copy API token

API token'ınızı alın

Kanal Bearer token'ınızı kopyalayın ve ilk LID sorgunuzdan önce REST API'yi curl, Postman veya Swagger'da keşfedin.

Call getIdByLid API

@lid'i telefon numarasına çözün

Mesaj, webhook veya API yanıtındaki @lid ile GET /contacts/ids/{ContactLID} çağırın. Bearer token ile yetkilendirin.

Kullanım senaryosu özeti

@lid'i araçlarınızın anladığı bir telefon numarasına dönüştürün

WhatsApp; CRM'inizin, scriptlerinizin veya otomasyonlarınızın telefon numarası beklediği yerlerde bir Linked ID (@lid) iletebilir. Bağlı WhatsApp hesabınız, normal trafik üzerinden @lid ↔ telefon eşlemelerini otomatik olarak toplayan kanaldır. Whapi, kanalınızda bu eşleme zaten mevcutsa @lid değerini tam bir numaraya çözümler. Eşleme mevcut olmadığında ise dürüst bir HTTP 404 hatası döndürür; böylece @lid değerini saklayıp daha sonra tekrar deneyebilirsiniz — telefon numarası zamanla kanal verilerinizde belirecektir.

  • Kanalınız o kişiyi zaten tanıyorsa tam telefon numarasını elde edin

  • Tek bir GET isteği: Yalnızca kanal önbelleğinizi tarar, WhatsApp'a yeni bir istek göndermez

  • HTTP 404: @lid değerini saklayın ve daha sonra tekrar deneyin; eşleme zamanla oluşabilir

Sandbox'ı aç — çözmeye başla
Ne elde edersiniz

Tek API çağrısı: @lid → telefon

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

İstek (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"
}
@lid aldıktan sonra

Telefon veya @lid — ikisi de çalışır

Tarayıcı emülasyon kütüphanelerinden farklı olarak Whapi, bağlı WhatsApp hesabınıza doğrudan bir socket bağlantısı üzerinden çalışır. Sorgu, kanalınızın o oturumdaki mesaj, grup ve diğer trafikten topladığı verileri tarar. 404 hatası, entegrasyonunuzun başarısız olduğu anlamına gelmez: Sadece WhatsApp'ın henüz o telefon numarasını oturumunuzla paylaşmadığını gösterir.

1

Webhook, grup dışa aktarımı veya CRM alanında @lid değerini tespit edin: Sorgu girdiniz budur.

2

Orijinal trafiği alan aynı kanalda getIdByLid çağrısı yapın.

3

HTTP 200: Tam WhatsApp sohbet kimliğini (örn. [email protected]) alırsınız. Artık bunu CRM'inizdeki mevcut müşteri satırıyla birleştirebilirsiniz.

4

HTTP 404: @lid değerini birincil anahtar olarak saklayın. Whapi, kanal verilerinde telefon numarası görünene kadar @lid ile mesajlaşmaya ve otomasyona devam etmenizi sağlar.

Prodüksiyon numaraları için güvenli

  • Mesaj gönderilmez, contact ping'i yok — her sorgu yalnızca önbellek verisini okur
  • GET başına WhatsApp'a yeni istek yok — antispam'ın işaretleyeceği ek trafik yok

BSUID ve @lid aynı şekilde çalışır — benzer gizlilik tanımlayıcıları, farklı format. Bu sorgu ikisi için de geçerlidir. BSUID hakkında bilgi

@lid'i herhangi bir programlama dilinde çözün

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);
Çift yönlü sorgu

@lid'den veya telefondan başlayın

Webhook veya CRM'inizde zaten olan tanımlayıcıyı kullanın — aynı Bearer token, aynı kanal önbelleği.

@lid'iniz var → telefona ihtiyacınız var

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

Webhook, grup dışa aktarma veya CRM satırı @lid saklar — telefon tabanlı CRM kayıtlarına birleştirin

Telefonunuz var → @lid'e ihtiyacınız var

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

Giden API @lid bekler, CRM'inizde yalnızca telefon var. Ölçülü kullanın: getLidById WhatsApp'a ulaşabilir — yalnızca önbellek kullanan getIdByLid'den farklı. Çağrılar arasına duraklamalar ekleyin.

Girdinize uyan endpoint'i seçin — aynı kanalda zamanla her iki yönü de oluşturun.

Neden önemli

CRM'de tek contact — telefon olmasa bile

WhatsApp telefon numarası yerine @lid gönderdiğinde CRM'ler sıklıkla kopya oluşturur ve geçmişi kaybeder. Tanımlayıcıyı programatik çözün ve mevcut satıra birleştirin.

Önce

Payload'da 154662208577626@lid var — CRM yeni contact açar.

Sonra

API 34604252681 döner — CRM aynı müşteri kaydını günceller.

  • @lid'i CRM veya destek araçlarında telefon tabanlı kayıtlarla eşleştirin

  • Bağlı kanalınızda bir sonraki sorgu için telefon ↔ @lid haritaları oluşturun

  • Siparişleri ve destek geçmişini tek müşteride tutun

CRM workflow with WhatsApp LID resolution
SSS

LID çözümleme hakkında sık sorulan sorular

Hayır. Çözümleme, bağlı kanalınızın o @lid için zaten telefon verisine sahip olup olmadığına bağlıdır. API HTTP 404 dönerse @lid değerini birincil anahtar olarak kullanmaya devam edin ve sorguyu daha sonra tekrar deneyin; WhatsApp oturumunuzla paylaştıkça telefon numarası görünebilir. Belirli aralıklarla otomatik sorgulama (polling) yapmayın.
Hayır. Her sorgu, bağlı kanalınızın WhatsApp'tan zaten aldığı verileri tarar (o oturumdaki mesajlar, gruplar ve webhook'lar). GET /contacts/ids/{ContactLID} mesaj göndermez, WhatsApp'a yeni istek yapmaz veya WhatsApp'ın numaranızla henüz paylaşmadığı bilgiyi çekmez. WhatsApp'ın analiz edeceği ek trafik yoktur; bu endpoint prodüksiyon numaraları için tamamen güvenlidir.
GET https://gate.whapi.cloud/contacts/ids/{ContactLID} kullanın (operationId: getIdByLid). Kanal Bearer token'ınızla kimlik doğrulayın. URL'de @ karakterini %40 olarak kodlayın.
Bu sayfa API yanıtları, webhook'lar ve grup payload'larından gelen standart @lid desenini kapsar. Bazı özel tanımlayıcılar farklı entegrasyon yolları gerektirir — gelişmiş senaryolar için geliştirici rehberimize bakın.
@lid değerini saklayın, gerekirse @lid ile mesajlaşmaya devam edin ve sorguyu daha sonra tekrar deneyin. Sabit bir bekleme süresi yoktur. Her topluluk veya grup @lid değerinin tersine çözülebileceğini varsaymayın.
panel.whapi.cloud'da ücretsiz kayıt olun, kanal oluşturun, WhatsApp numaranızı bağlamak için QR tarayın, kanal token'ınızı kopyalayın, ardından Bearer yetkilendirmesiyle GET /contacts/ids/{ContactLID} çağırın. WhatsApp bağlamak, sorgunun taradığı kanalı oluşturur.
Bağlı WhatsApp'ınız API kanalıdır. Whapi, o oturumdaki trafikten @lid ↔ telefon eşlemelerini saklar — mesajlar, gruplar, webhook'lar. Bağlı kanal olmadan aranacak bir şey yok. QR ile eşleştirme kurulumdur, sorgunun kendisi değil; bağlandıktan sonra o kanalın verilerine karşı GET /contacts/ids/{ContactLID} çağırın.