> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trellistech.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Contas conectadas
> Salve credenciais de sites para que seu agente de IA possa fazer login no Airbnb, Booking.com e outras plataformas em seu nome
## Deixe seu agente de IA navegar na web por você
Seu agente de IA pode visitar sites externos - verificando anúncios em OTAs, obtendo relatórios, conferindo preços - mas muitos desses sites exigem login. As contas conectadas permitem que você salve suas credenciais uma vez para que o agente possa fazer login automaticamente sempre que precisar acessar um site.
Em vez de copiar e colar dados do Airbnb ou Booking.com para o Trellis, você diz ao agente o que precisa e ele faz login, encontra a informação e traz de volta.
***
## Como funciona
Vá para **Base de conhecimento > Agents**, selecione o agente, abra a aba **Integrations** e clique em **Conectar site**. Insira o domínio do site (ou escolha entre Airbnb, Booking.com, Guesty, Breezeway, Hostaway ou Krossbooking), seu e-mail ou nome de usuário e sua senha.
Clique em **Verificar** para que o agente de IA teste o login. Um navegador seguro na nuvem é aberto e o agente insere suas credenciais automaticamente. Você pode assistir ao login acontecendo em tempo real através de uma janela de visualização ao vivo.
Se o site exigir um código do seu aplicativo autenticador, o agente pausa e espera você concluir a etapa de 2FA. Você também pode adicionar seu segredo do autenticador TOTP para que o agente lide com os códigos de 2FA automaticamente - sem necessidade de intervenção manual.
Uma vez verificadas, o agente reutiliza sua sessão salva sempre que precisar acessar aquele site. Os cookies são preservados entre sessões, então o agente não precisa fazer login toda vez.
***
## Adicionando credenciais
Na aba **Integrations** do agente, clique em **Conectar site** para adicionar uma nova credencial.
| Campo | Descrição |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Site** | O domínio para fazer login (ex.: airbnb.com, booking.com). Escolha entre as sugestões ou digite qualquer domínio. |
| **E-mail ou nome de usuário** | Seu login para o site. Se você inserir um endereço de e-mail, ele será usado tanto no campo de e-mail quanto no de nome de usuário durante o login. |
| **Senha** | Sua senha para o site. Armazenada de forma criptografada - o agente só a utiliza durante o processo de login. |
| **Segredo do autenticador** | Opcional. O segredo TOTP da configuração do seu aplicativo autenticador. Quando fornecido, o agente gera códigos de 2FA automaticamente. |
Para encontrar seu segredo do autenticador, procure a opção "chave de configuração" ou "chave secreta" ao adicionar uma nova conta no seu aplicativo autenticador (Google Authenticator, Authy, 1Password, etc.). Geralmente é uma longa sequência alfanumérica.
***
## Status da credencial
Cada credencial exibe um status para que você saiba de relance se o agente consegue acessar aquele site.
| Status | Significado |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Pronta** | A credencial está verificada e o agente consegue fazer login com sucesso. |
| **Não conectada** | A credencial ainda não foi verificada, ou foi alterada recentemente. Clique em **Verificar** para testá-la. |
| **Precisa de código** | O site exige um código de 2FA que o agente não consegue gerar. Adicione seu segredo do autenticador para resolver isso. |
| **Falhou** | A última tentativa de login falhou. Atualize suas credenciais e verifique novamente. |
Quando o agente usa uma credencial durante uma tarefa no chat - por exemplo, fazendo login no Airbnb para verificar um anúncio - o status é atualizado automaticamente com base no sucesso ou falha do login.
***
## Autenticação de dois fatores
Muitas plataformas de viagem exigem autenticação de dois fatores. As contas conectadas lidam com isso de duas formas:
Adicione seu segredo do autenticador TOTP ao criar a credencial. O agente gera códigos baseados em tempo automaticamente durante o login - sem necessidade de etapa manual. Esta é a abordagem recomendada para sites que você acessa com frequência.
Se você não adicionar um segredo do autenticador, o agente pausa quando encontra uma solicitação de 2FA e abre uma visualização ao vivo do navegador. Você digita o código do seu aplicativo autenticador diretamente no navegador, e o agente continua assim que você passar pela etapa de 2FA.
O segredo do autenticador é criptografado em repouso e limitado ao domínio específico - ele nunca é exposto a outros sites ou usado fora do fluxo de login.
***
## Visualização ao vivo do navegador
Quando o agente abre um navegador para fazer login em um site ou executar uma tarefa, você pode assistir à sessão em tempo real através de uma janela de visualização ao vivo. Isso é útil para:
* **Verificar credenciais** - assista o agente preencher seu login e confirme que funciona
* **Lidar com solicitações de 2FA** - digite um código diretamente no navegador ao vivo quando o agente pausar
* **Monitorar tarefas** - veja exatamente o que o agente está fazendo no site externo
A visualização ao vivo aparece automaticamente durante a verificação de credenciais e quando o agente encontra uma etapa que precisa da sua intervenção.
***
## Sessões de navegador no chat
Quando você pede ao agente de IA para fazer algo que requer visitar um site - como "verifique meu anúncio do Airbnb para a unidade 4B" ou "obtenha o último relatório de pagamento do Booking.com" - um cartão de sessão de navegador aparece no chat.
O cartão de sessão mostra:
* **Progresso passo a passo** - cada ação que o agente realiza (navegar para uma página, clicar em um botão, ler conteúdo) aparece como uma etapa com um registro de tempo
* **Capturas de tela** - o agente captura telas enquanto trabalha para que você possa ver o que ele viu
* **Visualização ao vivo** - clique para abrir uma visualização em tempo real da sessão do navegador enquanto ela está em execução
* **Resultado final** - quando a tarefa é concluída, o agente resume o que encontrou e inclui no chat
Se o agente encontrar um problema durante uma sessão de navegador - como um popup inesperado ou uma mudança no layout da página - ele pausa e você pode assumir o controle através da visualização ao vivo para ajudá-lo a superar o obstáculo.
***
## Sites sugeridos
Ao adicionar uma credencial, o Trellis sugere domínios comumente usados em hotelaria e gestão de propriedades:
* Airbnb
* Booking.com
* Guesty
* Breezeway
* Hostaway
* Krossbooking
Você também pode digitar qualquer domínio para conectar o agente a sites que não estão na lista.
***
## Gerenciando credenciais
Na aba **Integrations** do agente, você pode:
* **Editar** uma credencial para atualizar o nome de usuário, senha ou segredo do autenticador
* **Verificar novamente** uma credencial após fazer alterações para confirmar que o agente ainda consegue fazer login
* **Excluir** uma credencial para remover o acesso do agente àquele site
Atualizar seu e-mail, nome de usuário ou segredo do autenticador redefine automaticamente o status da credencial para "Não conectada". Verifique novamente após fazer alterações.
***
## FAQ
As credenciais são criptografadas em repouso e limitadas ao domínio específico. O agente só as descriptografa durante o processo de login daquele domínio - elas nunca são expostas a outros sites, outros usuários ou outros espaços de trabalho.
Sim. Após um login bem-sucedido, o agente salva os cookies de sessão para que não precise inserir suas credenciais novamente toda vez. Isso funciona como permanecer conectado em um navegador comum.
O status da credencial muda para "Falhou" na próxima vez que o agente tentar fazer login. Atualize a senha na aba Integrations do agente e verifique novamente.
As credenciais estão vinculadas ao agente de IA, não a membros individuais da equipe. Todos os membros da equipe no espaço de trabalho compartilham o mesmo conjunto de contas conectadas para cada agente.
O agente pode fazer login na maioria dos sites que usam formulários de login padrão com e-mail/senha. Sites com fluxos de login incomuns (como segurança de nível bancário ou requisitos de token de hardware) podem não funcionar de forma confiável.