Z-API · danielmarcianodo · Aug 13, 2026
diff --git a/en/partner/extension-token.mdx b/en/partner/extension-token.mdx
@@ -11,6 +11,16 @@ On some devices, WhatsApp now requires a passkey security verification to author
   This behavior **does not affect all devices**. Therefore, do not replace the standard connection flow — implement the extension connection as an **alternative option**, displayed only when the customer reports difficulties connecting.
 </Info>
 
+<Warning>
+  **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.
+</Warning>
+
 The recommendation is to follow the same pattern as the Z-API dashboard: display a "connection problems" notice or banner that, when clicked, starts the extension code generation flow. See the example below:
 
 <div style={{ display: "flex", justifyContent: "center" }}>

diff --git 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.
 </Info>
 
+<Warning>
+  **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.
+</Warning>
+
 ---
 
 ## Message queue

diff --git 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.
 </Info>
 
+<Warning>
+  **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.
+</Warning>
+
 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
@@ -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.
 </Info>
 
+<Warning>
+  **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.
+</Warning>
+
 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:
 
 <div style={{ display: "flex", justifyContent: "center" }}>

diff --git 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.
 </Info>
 
+<Warning>
+  **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.
+</Warning>
+
 ---
 
 ## Fila de mensagens

diff --git 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.
 
+
+<Warning>
+  **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.
+</Warning>
+
 ---
 
 ## Como funciona