> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intention.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Emparelhamento com telemóvel

> Como ligar uma carteira de telemóvel à Intention Exchange através de um código QR, e o que fazer quando o emparelhamento falha.

Esta página cobre o fluxo de emparelhamento com telemóvel: abre a exchange num browser de computador, a aplicação mostra um código QR e digitaliza-o com uma aplicação de carteira no telemóvel para estabelecer uma sessão de assinatura.

<h2 id="the-normal-flow">
  O fluxo normal
</h2>

1. No browser do computador, clique em **Connect wallet** (ligar carteira) e escolha a opção de emparelhamento com telemóvel.
2. A aplicação apresenta um código QR com uma janela de validade curta.
3. Abra a aplicação da carteira no telemóvel e use o leitor integrado — não a câmara do sistema, a menos que a sua carteira suporte deep links a partir da aplicação de câmara.
4. Aprove o pedido de emparelhamento que aparece na carteira.
5. O separador no computador passa ao estado ligado e pede uma [assinatura de sessão](/pt/help/session-signature).

<h2 id="common-failure-modes">
  Falhas comuns
</h2>

**A câmara não abre.** A sua aplicação de carteira não tem permissão de acesso à câmara. Conceda-a nas definições do sistema operativo e tente de novo. No iOS a permissão está em Definições, Privacidade, Câmara; no Android está em Informação da aplicação, Permissões.

**O código QR expirou antes de o conseguir digitalizar.** Os códigos são de curta duração por razões de segurança. Clique em «atualizar» ou «mostrar novo código» do lado do computador e digitalize o novo sem demora.

**A carteira diz «pairing failed» ou não acontece nada.** O protocolo de emparelhamento depende de um servidor de retransmissão acessível a partir dos dois dispositivos. Se o seu telemóvel estiver numa Wi-Fi empresarial, na rede de um hotel ou numa VPN que bloqueie tráfego WebSocket de saída, o servidor nunca receberá nada do telemóvel. Passe o telemóvel para a rede móvel, ou para outra rede, e tente de novo.

**O emparelhamento funciona mas todas as ações falham.** A sessão chegou a ligar-se, mas algo no caminho de assinatura está partido. As causas habituais são uma carteira emparelhada com a conta errada, uma carteira que não suporta o esquema de assinatura de sessão (atualizar), ou um telemóvel que adormeceu e desligou a retransmissão em segundo plano. Desemparelhe do lado da carteira, reabra a carteira e repita o fluxo.

<h2 id="what-to-send-us-if-none-of-this-works">
  O que nos enviar se nada disto resultar
</h2>

Envie um email para `contact@intention.xyz` com:

* O nome e a versão da sua carteira de telemóvel.
* O sistema operativo do telemóvel e a respetiva versão.
* O browser do computador e a respetiva versão.
* Uma fotografia ou captura de ecrã do erro apresentado no telemóvel.
* A hora UTC aproximada da tentativa de emparelhamento.

Podemos cruzar essa hora com os registos do servidor de retransmissão para ver onde falhou o handshake.