Maytapi
Maytapi/Документация/LID в номер
LID в номерВходит во все тарифыWhatsApp API: преобразование LID в номер телефона
WhatsApp всё чаще присылает вместо номеров приватные идентификаторы вида 112893567721673@lid. Преобразуйте их в реальные номера одним запросом — и находите LID по номеру, — чтобы CRM не создавала дубликаты контактов.
- @lid → номер
- номер → @lid
- участники групп
- без доплат
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getContacts/lidToPhone/112893567721673@lid" \ -H "x-maytapi-key: $TOKEN"
const lid = "112893567721673@lid";
const res = await fetch(
`https://api.maytapi.com/api/${PID}/${PHONE_ID}/getContacts/lidToPhone/${lid}`,
{ headers: { "x-maytapi-key": TOKEN } }
);
const { success, data } = await res.json();
if (success) console.log(data.phone); // 7916xxxxx67lid = "112893567721673@lid"
res = requests.get(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/getContacts/lidToPhone/{lid}",
headers={"x-maytapi-key": TOKEN},
timeout=10,
).json()
if res["success"]:
print(res["data"]["phone"]) # 7916xxxxx67{
"success": true,
"data": {
"id": "7916xxxxx67@c.us",
"name": "John Doe",
"phone": "7916xxxxx67",
"lid": "112893567721673@lid"
}
}
// hidden number or not resolvable
{ "success": false }Где вы встретите @lid
LID появляется везде, где WhatsApp скрывает номер от связанных устройств.
-
группы
Участники групп
В больших и новых группах участники часто приходят как @lid вместо @c.us.
-
сообщества
Сообщества
Группы объявлений и участники сообществ обычно возвращаются как LID.
-
webhook
Входящие сообщения
События webhook могут содержать отправителя только с @lid.
-
заказы
Заказы и ответы
Id сообщений и заказов могут ссылаться на @lid-форму чата.
Преобразуйте @lid в номер телефона
Передайте LID — с суффиксом @lid или без — в lidToPhone. Вы получите id чата, имя и номер, если WhatsApp их раскрывает.
- ✓Принимает 112893567721673@lid или 112893567721673
- ✓Возвращает id (@c.us), name, phone и lid
- ✓success:false, если номер скрыт
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getContacts/lidToPhone/112893567721673@lid" \ -H "x-maytapi-key: $TOKEN"
const lid = "112893567721673@lid";
const res = await fetch(
`https://api.maytapi.com/api/${PID}/${PHONE_ID}/getContacts/lidToPhone/${lid}`,
{ headers: { "x-maytapi-key": TOKEN } }
);
const { success, data } = await res.json();
if (success) console.log(data.phone); // 7916xxxxx67lid = "112893567721673@lid"
res = requests.get(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/getContacts/lidToPhone/{lid}",
headers={"x-maytapi-key": TOKEN},
timeout=10,
).json()
if res["success"]:
print(res["data"]["phone"]) # 7916xxxxx67{
"success": true,
"data": {
"id": "7916xxxxx67@c.us",
"name": "John Doe",
"phone": "7916xxxxx67",
"lid": "112893567721673@lid"
}
}
// hidden number or not resolvable
{ "success": false }Найдите LID по номеру
Обратное направление помогает сопоставлять входящие события с @lid с уже известными контактами. Передайте номер с кодом страны.
- ✓Номер с кодом страны, без + и пробелов
- ✓Тот же формат ответа, что у lidToPhone
- ✓success:false, если номера нет в WhatsApp
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getContacts/phoneToLid/7916xxxxx67" \ -H "x-maytapi-key: $TOKEN"
{
"success": true,
"data": {
"id": "7916xxxxx67@c.us",
"name": "John Doe",
"phone": "7916xxxxx67",
"lid": "112893567721673@lid"
}
}Автоматическое преобразование участников групп
Добавьте refresh=true к getGroups, если в списке участников есть @lid. Maytapi обновит группу из WhatsApp и вернёт участников как @c.us везде, где номер доступен.
- ✓Работает для getGroups и getGroups/{group_id}
- ✓Один запрос на каждую обновлённую группу — используйте только при @lid
- ✓Участники, скрывающие номер, остаются @lid
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getGroups/7916xxxxx67-1574073754@g.us?refresh=true" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/getGroups?refresh=true&sort=true&page=1" \ -H "x-maytapi-key: $TOKEN"
// before: "112893567721673@lid" // after refresh=true: "participants": [ "7916xxxxx67@c.us", "7916xxxxx43@c.us", "184412209955301@lid" // hides their number ]
Зачем преобразовывать LID
-
Чистая CRM
Привязывайте каждый диалог к одному контакту, а не создавайте новый на каждый @lid.
-
Выгрузка групп и сообществ
Выгружайте списки участников с реальными номерами для модерации и отчётов.
-
Боты, которые помнят пользователя
Храните историю и состояние привязанными к нужному человеку.
FAQ: LID в номер телефона
Задайте любой вопрос поддержке в WhatsApp. Среднее время ответа — меньше 24 часов.
Центр помощи →Что такое LID в WhatsApp?
LID (связанный идентификатор) — приватный id вида 112893567721673@lid, который WhatsApp использует вместо номера в некоторых чатах, группах и событиях.
Можно ли преобразовать любой LID?
Нет. Если человек скрывает номер или WhatsApp не передаёт его вашей сессии, API вернёт success:false и контакт останется @lid.
Это стоит дополнительно?
Нет. lidToPhone, phoneToLid и обновление групп входят во все тарифы.
Нужно ли добавлять refresh=true к каждому getGroups?
Нет. Каждая обновлённая группа — это один запрос к WhatsApp; используйте только когда в списке есть @lid или данные выглядят устаревшими.
Другие возможности WhatsApp API
Получите ключ и отправьте первое сообщение за десять минут
Без одобрения, без шаблонов, без карты. Все эндпоинты открыты на три дня.