> ## Documentation Index
> Fetch the complete documentation index at: https://developer.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lid

## Introdução

O `@lid` (Linked ID) é um *identificador único e privado* criado pelo WhatsApp para representar contatos sem expor diretamente o número de telefone.
Essa mudança faz parte das *atualizações de privacidade* do WhatsApp, permitindo que o usuário oculte seu número em determinados contextos.

Em alguns casos, o WhatsApp está enviando o `@lid` como identificação primária do usuário, mesmo que ele não tenha ativado nenhuma opção para esconder o número.

***

### Diferença entre `@lid` e `phone`

O WhatsApp pode retornar os identificadores de contato de diferentes formas, dependendo do tipo de conversa, grupo ou configuração de privacidade:

* `phone`: Pode conter o número real (`"554499999999"`) ou o próprio `@lid` (`"999999999999999@lid"`).

* `chatLid`: É o identificador único mais estável.

***

### Exemplo de Webhook

Nos webhooks da Z-API, o WhatsApp pode retornar o identificador do contato de diferentes formas, dependendo do tipo de interação e das configurações de privacidade do usuário.

#### Exemplo – Retorno completo com número e `@lid`:

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "chatLid": "999999999999999@lid",
  "phone": "554499999999"
}
```

#### Exemplo – Retorno apenas com o `@lid`:

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "chatLid": "65998849469@lid",
  "phone": "65998849469@lid"
}
```

***

### Envio de mensagens usando o `@lid`

É possível *enviar mensagens diretamente para um `@lid`*, substituindo o número de telefone no corpo da requisição:

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "phone": "999999999999999@lid",
  "message": "Olá! Essa mensagem foi enviada usando o identificador @lid."
}
```

O envio funciona normalmente, pois o `@lid` *já é suportado* pela API da Z-API na maioria dos endpoints.

***

### Boas práticas de implementação

* Priorize o uso de `@lid` para identificar contatos — esse atributo tende a ser o mais estável.
* Evite depender apenas de `phone`, pois ele pode conter o número ou o próprio `@lid`.
* Armazene e relacione o `@lid` em sua base de dados para manter consistência.

***

### Conversão de `@lid` para número

Não é possível converter um `@lid` em número de telefone (`phone`).
Essa limitação existe *por motivos de privacidade definidos pelo WhatsApp*.
Permitir essa conversão invalidaria o propósito do recurso de ocultação de número.

O mapeamento direto entre `@lid` e `phone` *não é disponibilizado pelo WhatsApp nem pela Z-API*.

***

### Conversão de número (`phone`) para `@lid`

Por outro lado, é possível obter o `@lid` correspondente a um número de telefone utilizando o método ["Número com Whatsapp ?"](https://developer.z-api.io/contacts/get-iswhatsapp).

Esse endpoint permite verificar se um número possui conta no WhatsApp e, quando aplicável, retorna também o *identificador `@lid`* associado a esse número.

***

### Importante

* Essa mudança é *nativa do WhatsApp*, e a Z-API apenas repassa as informações conforme recebidas.
* O comportamento de retorno (`@lid` ou `phone`) pode variar.
* O atributo `chatLid` já está implementado nos webhooks da Z-API e pode ser usado tanto para identificar quanto para enviar mensagens normalmente.
* O `@lid` é uma medida que está sendo implementada pelo próprio WhatsApp; as mudanças estão sendo aplicadas gradualmente e ele ainda não está completamente implementado, por isso o comportamento pode ser inconsistente.