---
title: "Widgets e Atalhos"
description: "Controle o Potatso por widgets da Tela de Início e da Tela Bloqueada, pela Central de Controle e por URLs potatso:// nos Atalhos e nas automações."
---

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

# Widgets e Atalhos

Você pode conectar, desconectar, trocar de modo e trocar de nó sem abrir o Potatso: por um widget, pela Central de Controle ou com um atalho. Todos funcionam no perfil selecionado no Potatso.

## Widgets da Tela de Início {#widgets}

Adicione um widget do jeito de sempre: toque e segure a Tela de Início, toque em **Editar**, depois em **Adicionar Widget**, e busque por Potatso. O Potatso tem dois widgets.

### Conexão VPN {#connection-widget}

Conecte, troque de modo e escolha nós.

| Tamanho | Mostra |
| --- | --- |
| Pequeno | O perfil, seu status e um botão **Conectar** ou **Desconectar**. |
| Médio | O mesmo, mais os botões de modo: **Regra**, **Global**, **Inteligente** e **Direto**. |
| Grande | Os botões de modo e até 4 nós da saída principal, com sua latência. |

Toque em um modo ou nó para mudar para ele. Se você está conectado, a mudança vale na hora. Quando uma mudança precisa do app, o widget diz **Abra o Potatso para aplicar esta alteração.**

Com o Potatso Pro, o widget grande também tem um botão **Testar latência** que testa os nós que ele mostra.

Algumas opções não estão disponíveis em alguns perfis. Por exemplo, um perfil de VPN Pessoal não tem botões de modo nem de nó, e o modo Direto não usa um nó.

### Nós {#nodes-widget}

Um widget médio com o botão de conexão e os três nós a que você mais se conecta. Toque em um nó para mudar para ele.

## Widgets da Tela Bloqueada {#lock-screen}

O widget **Conexão VPN** também existe nos tamanhos da Tela Bloqueada:

- O widget redondo mostra se você está conectado e por quanto tempo. Toque nele para conectar ou desconectar.
- O widget retangular mostra o status, o perfil, o modo e a rota dele.
- O widget em linha mostra o status em uma linha.

## Central de Controle {#control-center}

No iOS 18 ou posterior, você pode adicionar um botão do Potatso à Central de Controle:

1. Abra a Central de Controle e toque e segure uma área vazia.
2. Toque em **Adicionar um Controle** e busque por Potatso.
3. Escolha **Conexão VPN**.

Toque no botão para conectar ou desconectar.

## Ações por URL {#urls}

O Potatso responde a estas URLs:

| URL | Ação |
| --- | --- |
| `potatso://on` | Conecta. |
| `potatso://off` | Desconecta. |
| `potatso://switch` | Conecta quando está desconectado e desconecta nos demais casos. |

Abrir uma destas URLs abre o Potatso e em seguida conecta ou desconecta.

## Usar o Potatso nos Atalhos {#shortcuts}

Para criar um atalho que conecta:

1. No app Atalhos, crie um novo atalho.
2. Adicione a ação **Abrir URLs**.
3. Digite `potatso://on`.

Use `potatso://off` para desconectar ou `potatso://switch` para alternar.

### Conectar automaticamente {#automations}

As automações dos Atalhos executam uma ação por URL para você. Por exemplo, para conectar quando você sai do Wi-Fi de casa:

1. No app Atalhos, toque em **Automação** e crie uma nova automação.
2. Escolha o gatilho **Wi-Fi**, escolha a sua rede doméstica e defina que ele execute quando o seu iPhone sair dela.
3. Escolha executar imediatamente.
4. Adicione a ação **Abrir URLs** com `potatso://on`.

Crie uma segunda automação com `potatso://off` que execute quando o seu iPhone entrar no Wi-Fi de casa, para desconectar de novo quando você chegar.

Source: https://potatso.com/docs/pt-br/guides/widgets-and-shortcuts/index.mdx