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

# AI Step | App Integration

Seus agentes na Tess podem fazer muito mais do que apenas processar informações — eles podem agir. Os Steps de Integração de Apps (App Integration) são a funcionalidade que conecta seus agentes a sistemas externos, permitindo que eles executem tarefas no mundo real ou coletem informações de outras plataformas.

Este guia explica a lógica por trás desse poderoso bloco de steps, mostrando como você pode dar "braços e pernas" aos seus agentes para que eles se tornem participantes ativos nos seus fluxos de trabalho.

### **A Lógica do Step: Obter Informação vs. Executar Ação**

Para entender a Integração de Apps, é útil contrastá-la com outros tipos de steps.

<Columns cols={2}>
  <Card title="Steps de Coleta de Dados">
    São projetados para COLETAR AS INFORMAÇÕES e trazê-las para dentro do agente, para que  possa analisá-las.
  </Card>

  <Card title="Steps de Integração de Apps">
    São projetados para EXECUTAR AÇÕES fora do agente, usando as informações que ele já possui.
  </Card>
</Columns>

<Info>
  É a diferença entre um agente que lê um relatório de vendas e um agente que atualiza o status de um cliente no seu CRM.
</Info>

### **Como Funciona na Prática**

A configuração de uma integração segue um fluxo lógico simples no AI Studio:

* Adicionar um Step: Em seu agente, adicione uma nova etapa do App Integration.
* Escolher o App e a Ação: Selecione o aplicativo que deseja conectar (ex: Google Agenda) e a ação específica que o agente deve realizar (ex: "Criar Evento").
* Mapear as Informações: Configure os campos da ação (como "Título do Evento" ou "E-mail do Convidado"), preenchendo-os com as variáveis correspondentes das suas Entradas de Usuário.

<Frame>
  <img src="https://mintcdn.com/tess-dfe1edf0/T8BXCjKeHQ3OqfdE/images/image-113.png?fit=max&auto=format&n=T8BXCjKeHQ3OqfdE&q=85&s=b6c602706bc7ecd187bff5a78b059085" alt="Image" width="411" height="407" data-path="images/image-113.png" />
</Frame>

<Info>
  O ponto crucial é que o agente não executa essa ação aleatoriamente. O seu **prompt** serve como o cérebro da operação, definindo as regras para que esses steps aconteçam no início do chat (agente de chat) ou antes do resultado final (agente de texto).
</Info>

### **Exemplo Rápido: Qualificação e Agendamento**

Imagine um processo de ganho e agendamento automatizado, onde um cliente cai em sua plataforma de comunicação interna (ex: Slack), avisando ao time de atendimento a nova venda. Isso será um gatilho para acionar a Tess e preencher as informações do step do google agenda, com nome, email e detalhamentos da demonstração através do Step de Integração. 

O agente então pega as variáveis coletadas no Slack e as usa para preencher e executar a ação "Criar Evento" no Google Agenda, enviando o convite automaticamente.

<Frame>
  <img src="https://mintcdn.com/tess-dfe1edf0/T8BXCjKeHQ3OqfdE/images/image-114.png?fit=max&auto=format&n=T8BXCjKeHQ3OqfdE&q=85&s=9a934c9f659ded14344c09161f280407" alt="Image" width="407" height="509" data-path="images/image-114.png" />
</Frame>

Neste caso, a mensagem no Slack foi o gatilho, e o Step de Integração foi a ferramenta de ação.

<Note>
  OBSERVAÇÃO\
  \
  Para que tudo isso aconteça, será necessário integrar esse app com o seu acesso na Tess. Esse será o mecanismo de segurança para que o processo seja feito e a ferramenta acionada.
</Note>

### **Expandindo as Possibilidades**

As aplicações são vastas e permitem automatizar inúmeros processos:

* Atualizar planilha do Google Sheets
* Coletar informações de campanhas do Google ou Meta
* Fazer upload de um arquivo no Drive ou Box 

<Info>
  Os Steps de Integração de Apps transformam seu agente de um assistente informativo em um membro proativo e funcional da sua equipe.
</Info>

Ao dominar a lógica de conectar a inteligência do seu agente com as ferramentas que impulsionam seu negócio, você pode automatizar processos, aumentar a eficiência e criar soluções verdadeiramente integradas.