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

# Seu Primeiro Agente

> Crie, treine e lance seu agente de I.A automático em menos de 10 minutos. Siga esse passo-a-passo para criar seu robô e conecta-lo diretamente no seu WhatsApp.

Em poucos minutos, você terá um agente de I.A atendendo seus clientes no WhatsApp, vendendo ou prestando suporte sem dor de cabeça. Vamos começar.

## Pré-requisitos

<Info>
  Você precisará de uma conta ativa na Converza para este tutorial. [Cadastre-se aqui](https://app.converza.io/signup) se você ainda não tem uma conta.
</Info>

## Visão geral

Aqui está o que você irá aprender neste guia:

<Steps>
  <Step title="Criar e Treinar seu Agente de I.A">
    Configure um novo agente e o treine com os dados do seu negócio
  </Step>

  <Step title="Testar e Otimizar">
    Utilize o Playground para testar o funcionamento do seu agente e realize ajustes finos
  </Step>

  <Step title="Ative no seu WhatsApp">
    Adicione seu agente de forma 100% funcional e rápida no seu WhatsApp
  </Step>
</Steps>

<Tip>
  **Tempo estimado:** 10 minutos para conclusão
</Tip>

## Etapa 1: Crie e Treine seu Agente

### Navegue até o Dashboard de Robôs

Após acessar sua conta Converza, clique na opção "Robôs" no menu lateral esquerdo.

Após isso, clique no botão  **"Novo Robô"** para começar.

<Frame>
  <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.11.05.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=1a576a95e2eeaff6e063a1d1ee6f0cee" alt="Dashboard da Converza na aba de robôs" title={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.11.05.png" />
</Frame>

### Escolha seus Dados de Treinamento

Seu agente de I.A precisa de dados para treinar e obter conhecimento. Você pode utilizar:

<Tabs>
  <Tab title="Arquivos">
    **Faça upload dos seus arquivos**

    Treine seu agente utilizando seus documentos e arquivos de texto.

    **Ideal para:** Documentos de negócio, detalhes de produtos, FAQs, detalhes de ofertas e etc...

    ### Navegue até o Dashboard de Documentos

    Clique na opção "Documentos" no menu lateral esquerdo.

    Após isso, clique no botão  **"Importar Documento"** para começar a carregar documentos de texto com conhecimento. São suportados os formatos **PDF, DOC, DOCX e TXT.**

    <Frame>
      <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.15.12.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=8221d4577ab9ce185bd149c4409f6121" alt="Dashboard de Documentos da Converza" title={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.15.12.png" />
    </Frame>

    Após isso, um modal aparecerá na tela. Siga as instruções e aguarde para efetuar o envio do seu documento. Você pode ter inúmeros documentos armazenados em sua conta e escolher quais você quer usar em cada robô na hora da criação do seu agente. Consulte os limites do seu plano para saber mais sobre os limites de upload e armazenamento disponíveis para você.

    <Frame>
      <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.15.36.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=a35a327d089f0822156887be438701e0" alt="Dashboard da Converza na aba de robôs" title={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.15.36.png" />
    </Frame>

    Após isso, ao retornar para a criação ou edição de seu robô, acesse a aba **"Documentos"** e clique no botão **"Selecionar"**

    <Frame>
      <img src="https://mintcdn.com/converza/QCRUlImeOawEeqz5/CapturadeTela2025-10-23a%CC%80s01.07.37.png?fit=max&auto=format&n=QCRUlImeOawEeqz5&q=85&s=1d4ae86e5bed0b53211e05e0b146fe62" alt="" width="2738" height="1430" data-path="CapturadeTela2025-10-23às01.07.37.png" />
    </Frame>

    Um novo modal aparecerá com a listagem dos seus documentos disponíveis para seleção. Selecione todos os documentos que deseja adicionar a base de conhecimento do seu robô e confirme a seleção. Após isso, seu robô já estará carregado com seus documentos. Não esqueça de clicar em **"Salvar"** e **"Publicar"** para treinar e atualizar seu robô após isso.

    <Frame>
      <img src="https://mintcdn.com/converza/QCRUlImeOawEeqz5/CapturadeTela2025-10-23a%CC%80s01.08.04.png?fit=max&auto=format&n=QCRUlImeOawEeqz5&q=85&s=a27e9c1a6086536473f455502af2d6c3" alt="" width="2738" height="1430" data-path="CapturadeTela2025-10-23às01.08.04.png" />
    </Frame>
  </Tab>

  <Tab title="Instruções">
    **Entrada de texto direta**

    Você também pode adicionar informações e contexto direto as instruções do seu agente. Esse tipo de entrada é recomendada para ajustes finos ou informações muito específicas que o seu robô precisa seguir com excelência. Evite adicionar contexto muito grande para evitar problemas com o pensamento do seu agente.

    **Ideal para:** Informações específicas ou conteúdo de ajuste fino

    <Frame>
      <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.26.19.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=8734a809bec8013048ff569ed11b5e63" alt={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.26.19.png" />
    </Frame>
  </Tab>

  <Tab title="P&R">
    **Add your own Q\&A**

    Adicione as \*\*perguntas e respostas \*\*do seu produto ou negócio diretamente em seu agente. Ideal para perguntas e respostas específicas que são comuns durante seus atendimentos, como requisições do cliente referente a links ou detalhes do seu produto.

    **Ideal para:** Perguntas e Respostas frequentes

    <Frame>
      <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.28.25.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=39f30a3fc9716cbe1c7fd1ec01ef38d5" alt={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.28.25.png" />
    </Frame>
  </Tab>
</Tabs>

### Revisar e Iniciar o Treinamento

Clique em **"Salvar"** para iniciar o treinamento inicial do seu robô. Caso você esteja criando este agente agora, o botão **"Publicar"** estará bloqueado devido ao primeiro salvamento já realizar a publicação inicial. É necessário **Publicar** o seu agente após salvar em edições futuras.

<Frame>
  <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.30.07.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=716ab5b58954fcdb5531c1e19376fcb0" alt={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.30.07.png" />
</Frame>

<Check>
  O treinamento normalmente leva menos de 1 minuto, mas pode ser maior dependendo do seu volume de dados de treinamento.
</Check>

<Info>
  **Limitações de Caracteres:** Planos tem diferentes limites de caracteres de treinamento por robô. Verifique os limites do seu plano caso você não reconheça.
</Info>

## Etapa 2: Teste e Otimize seu Agente

### Acesse o Playground

Após o treinamento do seu robô finalizar, você deverá acessar o **Playground** - seu ambiente de testes direto no seu Dashboard, onde você pode melhorar e validar seu robô antes de conecta-lo ao WhatsApp.

<Frame>
  <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.33.16.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=ac97f7ab169ebeb18c1596e45aaf6e40" alt={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.33.16.png" />
</Frame>

### Valide a Qualidade das Respostas

Conforme você testar, procure por:

<Check>
  **Precisão** - As respostas estão fatualmente corretas?
</Check>

<Check>
  **Relevância** - O robô responde o que foi perguntado?
</Check>

<Check>
  **Concisão** - As respostas são diretas mas também concisas?
</Check>

<Check>
  **Tom** - O agente está de acordo com o seu Branding?
</Check>

### Realize Ajustes Finos

<Tabs>
  <Tab title="Instruções">
    Defina como seu agente de I.A deve se comportar e responder aos usuários. Essas instruções moldam a personalidade, o tom e a abordagem do seu agente nas conversas. É aqui que você define se você quer um suporte, um vendedor ou qualquer outra coisa que deseje.

    <Tip>
      **Se Inspire:** Use os exemplos do menu suspenso abaixo para ver modelos de instruções para diferentes tipos de negócios e cenários. Você pode copiá-los e personalizá-los de acordo com suas necessidades específicas.

      <Frame>
        <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.36.40.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=4b8e173c73d721a84ee5076b0daa10d2" alt={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.36.40.png" />
      </Frame>
    </Tip>

    **Como escrever instruções efetivas:**

    * Seja específico sobre o tom desejado (profissional, amigável, informal, etc.)
    * Estabeleça limites claros sobre quais assuntos discutir ou evitar.
    * Inclua seus objetivos comerciais (coleta de leads, suporte, vendas, etc.)
    * Especifique quando encaminhar para o suporte humano
    * Defina a voz e a personalidade da sua marca
  </Tab>

  <Tab title="Temperatura">
    A temperatura controla a criatividade das respostas do seu agente:

    * **Baixa (0.1-0.3)** - Respostas consistentes e factuais.
    * **Média (0.4-0.7)** - Criatividade balanceada. **O mais recomendado.**
    * **Alta (0.8-1.0)** - Mais criatividade e variações. **Um valor muito alto pode deixar seu agente confuso!**
  </Tab>
</Tabs>

## Etapa 3: Conecte ao seu WhatsApp

### Navegue até a seção de Dispositivos

Quando você estiver satisfeito com seu agente, é hora de colocar tudo no ar! Não esqueça de **Salvar** e **Publicar** seu agente caso tenha feito alguma alteração até aqui.

Para começar, acesse a aba de **"Dispositivos"** no menu lateral esquerdo.

<Frame>
  <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.38.47.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=950913dfceabee4be3edcc6b554914cc" alt={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.38.47.png" />
</Frame>

<Info>
  **Web e WhatsApp:** No momento, a Converza oferece apenas suporte para WhatsApp. Em breve, as opções Web Chat e WhatsApp API estarão disponíveis para conexão.
</Info>

### Crie seu Dispositivo

Antes de conectar ao seu WhatsApp, você precisa de um dispositivo. Um dispositivo é um servidor virtual que faz a ponte entre seu agente e seu WhatsApp. Cada plano possui limites diferentes de Dispositivos. Consulte o seu para saber mais.

Para iniciar, clique no botão **"Criar Novo"**

<Frame>
  <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.40.38.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=5bba316287d45ce3115ff627a775d34e" alt={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.40.38.png" />
</Frame>

Um modal aparecerá solicitando algumas informações básicas. Dê um nome para seu dispositivo para facilitar a identificação no sistema e selecine o robô no qual você deseja conectar ao seu dispositivo. Cada dispositivo pode possuir apenas um robô ativo por vez.

<Frame>
  <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.41.23.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=4522fa6135afe33a46ed2237161a5597" alt={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.41.23.png" />
</Frame>

Após configurar seu dispositivo, clique em **Criar** e aguarde a criação do seu dispositivo no sistema.

### Conecte seu WhatsApp

Após criar seu **Dispositivo**, clique nos três pontinhos ao lado direito da listagem de dispositivos.

Um menu de ações irá aparecer, selecione **Conectar**:

<Frame>
  <img src="https://mintcdn.com/converza/e8d9zdmEZl_268Hx/CapturadeTela2025-10-15a%CC%80s20.42.52.png?fit=max&auto=format&n=e8d9zdmEZl_268Hx&q=85&s=4546e3a53302cdea4f4b41344fe795a1" alt={true} width="1881" height="950" data-path="CapturadeTela2025-10-15às20.42.52.png" />
</Frame>

Aguarde alguns segundos e uma tela com um **QR Code** irá aparecer no centro.

Neste momento, você deverá acessar seu aplicativo do WhatsApp ou WhatsApp Business em seu smartphone e deverá acessar a opção de **"Conectar Dispositivo"**, no mesmo formato que você conectaria ao WhatsApp Web. Leia o QR Code da tela com o scanner do WhatsApp e caso necessário, de um nome ao dispositivo conectado no seu WhatsApp.

Após isso, seu robô estará ativo e pronto para responder mensagens de forma automática no seu WhatsApp!

Para desconectar, basta acessar as opções do dispositivo na Converza e selecionar a opção **"Desconectar"**, evite desconectar manualmente através do WhatsApp para evitar problemas com seu Dispositivo Converza.

<Check>
  **Sucesso!** Seu agente estará ativo e pronto para conversar com visitantes.
</Check>

<Tip>
  Caso você responda uma mensagem manualmente através do seu WhatsApp e seu robô tenha a opção de transbordo de atendimentos ativo, o robô interromperá o atendimento temporiariamente para que você possa realizar o atendimento manualmente como um humano.
</Tip>

## 🎉 Parabéns!

Você criou, treinou e conectou seu primeiro agente de I.A com sucesso. Aqui está o que você aprendeu:

<Check>
  ✅ Criou um agente inteligente de I.A e treinou com seus dados
</Check>

<Check>
  ✅ Testou e validou a qualidade das respostas
</Check>

<Check>
  ✅ Conectou no seu WhatsApp
</Check>

<Check>
  ✅ Tornou seu atendimento acessível 24/7 para seus clientes!
</Check>

### E agora?

<CardGroup cols={2}>
  <Card title="Monitore a Performance" icon="chart-line" href="/best-practices">
    Acompanhe os resultados do seu agente e realize ajustes conforme necessário.
  </Card>

  <Card title="Funcionalidades Avançadas" icon="wand-magic-sparkles" href="/agent-builder/extra-options">
    Adicione ações como envio e escuta de áudios, captura de leads e muito mais!
  </Card>

  <Card title="Melhores Práticas" icon="lightbulb" href="/best-practices">
    Aprenda estratégias já validadas e aplique-as no seu agente de I.A.
  </Card>

  <Card title="Integrações de API" icon="code" href="/agent-builder/api-integrations">
    Crie integrações customizadas com nosso construtor de integrações poderoso.
  </Card>
</CardGroup>