diff --git a/en/partner/sdk-connector.mdx b/en/partner/sdk-connector.mdx
index d45ba4c..27a16ac 100644
--- a/en/partner/sdk-connector.mdx
+++ b/en/partner/sdk-connector.mdx
@@ -194,6 +194,16 @@ ZAPIConnector.open({ token, methods: { phone: false, migrate: false } });
modal is never left without a way to connect.
+
+ **Known limitations (outside our control):** passkey pairing depends on platform-level features (Windows/Bluetooth), not on Z-API.
+
+ - **Windows 10 (or earlier):** there is no support for passkey pairing via Bluetooth, nor for cloud passkey sync. In these cases, the system prompts for a physical "USB security key" and the flow gets stuck. Since Windows 10 reached end of support in Oct/2025, there is no expectation of a fix from Microsoft.
+
+ **This feature is exclusive to Windows 11**
+
+ - **Devices without Bluetooth:** regardless of the operating system, pairing with the phone is not possible without Bluetooth.
+
+
---
## Message queue
diff --git a/en/tips/extension-guide.mdx b/en/tips/extension-guide.mdx
index 92c2229..f5693ba 100644
--- a/en/tips/extension-guide.mdx
+++ b/en/tips/extension-guide.mdx
@@ -22,6 +22,16 @@ On some devices, WhatsApp now requires an additional verification when attemptin
This behavior **does not affect all devices** — only those where WhatsApp requires phone validation to authorize a new WhatsApp Web connection.
+
+ **Known limitations (outside our control):** passkey pairing depends on platform-level features (Windows/Bluetooth), not on Z-API.
+
+ - **Windows 10 (or earlier):** there is no support for passkey pairing via Bluetooth, nor for cloud passkey sync. In these cases, the system prompts for a physical "USB security key" and the flow gets stuck. Since Windows 10 reached end of support in Oct/2025, there is no expectation of a fix from Microsoft.
+
+ **This feature is exclusive to Windows 11**
+
+ - **Devices without Bluetooth:** regardless of the operating system, pairing with the phone is not possible without Bluetooth.
+
+
If you encounter either of these screens when trying to connect your Z-API instance, use the **[Z-API Conector](https://chromewebstore.google.com/detail/iopmkohngoecmepoheapifkafbeomphn)** Chrome extension. Through it, you can authenticate the connection securely, without needing to scan a QR Code.
---
diff --git a/partner/extension-token.mdx b/partner/extension-token.mdx
index 1057bb6..c035a07 100644
--- a/partner/extension-token.mdx
+++ b/partner/extension-token.mdx
@@ -11,6 +11,16 @@ Em alguns dispositivos, o WhatsApp passou a exigir uma verificação de seguran
Esse comportamento **não ocorre em todos os dispositivos**. Por isso, não substitua o fluxo de conexão padrão — implemente a conexão via extensão como uma **opção alternativa**, exibida apenas quando o cliente relatar dificuldades para conectar.
+
+ **Limitações conhecidas (fora do nosso controle):** o pareamento via passkey depende de recursos da própria plataforma (Windows/Bluetooth), e não da Z-API.
+
+ - **Windows 10 (ou inferior):** não há suporte a pareamento de passkey via Bluetooth nem sincronização de passkeys em nuvem. Nesses casos, o sistema solicita uma "chave de segurança USB" física e o fluxo não avança. Como o Windows 10 saiu de suporte em out/2025, não há previsão de correção pela Microsoft.
+
+ **Esse recurso é exclusivo no Windows 11**
+
+ - **Dispositivos sem Bluetooth:** independentemente do sistema operacional, o pareamento com o celular não é possível sem Bluetooth.
+
+
A recomendação é seguir o mesmo padrão do painel Z-API: exibir um aviso ou banner de "problemas ao conectar" que, ao ser clicado, inicia o fluxo de geração do código de extensão. Veja o exemplo abaixo:
diff --git a/partner/sdk-connector.mdx b/partner/sdk-connector.mdx
index 8542792..f9aff78 100644
--- a/partner/sdk-connector.mdx
+++ b/partner/sdk-connector.mdx
@@ -194,6 +194,16 @@ ZAPIConnector.open({ token, methods: { phone: false, migrate: false } });
deixar o modal sem forma de conectar.
+
+ **Limitações conhecidas (fora do nosso controle):** o pareamento via passkey depende de recursos da própria plataforma (Windows/Bluetooth), e não da Z-API.
+
+ - **Windows 10 (ou inferior):** não há suporte a pareamento de passkey via Bluetooth nem sincronização de passkeys em nuvem. Nesses casos, o sistema solicita uma "chave de segurança USB" física e o fluxo não avança. Como o Windows 10 saiu de suporte em out/2025, não há previsão de correção pela Microsoft.
+
+ **Esse recurso é exclusivo no Windows 11**
+
+ - **Dispositivos sem Bluetooth:** independentemente do sistema operacional, o pareamento com o celular não é possível sem Bluetooth.
+
+
---
## Fila de mensagens
diff --git a/tips/extension-guide.mdx b/tips/extension-guide.mdx
index 6cd0279..7dddd96 100644
--- a/tips/extension-guide.mdx
+++ b/tips/extension-guide.mdx
@@ -24,6 +24,17 @@ Em alguns dispositivos, o WhatsApp passou a exigir uma verificação adicional a
Se você se deparar com qualquer uma dessas telas ao tentar conectar sua instância Z-API, utilize a extensão **[Z-API Conector](https://chromewebstore.google.com/detail/iopmkohngoecmepoheapifkafbeomphn)** para o Google Chrome. Por meio dela, é possível autenticar a conexão de forma segura, sem precisar escanear um QR Code.
+
+
+ **Limitações conhecidas (fora do nosso controle):** o pareamento via passkey depende de recursos da própria plataforma (Windows/Bluetooth), e não da Z-API.
+
+ - **Windows 10 (ou inferior):** não há suporte a pareamento de passkey via Bluetooth nem sincronização de passkeys em nuvem. Nesses casos, o sistema solicita uma "chave de segurança USB" física e o fluxo não avança. Como o Windows 10 saiu de suporte em out/2025, não há previsão de correção pela Microsoft.
+
+ **Esse recurso é exclusivo no Windows 11**
+
+ - **Dispositivos sem Bluetooth:** independentemente do sistema operacional, o pareamento com o celular não é possível sem Bluetooth.
+
+
---
## Como funciona