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

# Guia Rápido

> Crie seu primeiro agente de voz em minutos

Este guia mostra como criar e configurar seu primeiro agente de voz no Kiraa, e aponta os próximos passos para usar **Plugins**, **Templates** e **Campanhas Omnichannel**.

## Pré-requisitos

<Check>Uma conta criada no Kiraa</Check>
<Check>Acesso ao Dashboard</Check>

## Passo 1: Criar um Agente

<Steps>
  <Step title="Acessar a página de Agentes">
    No menu lateral, abra **Studio de IA** e clique em **Agentes**.
  </Step>

  <Step title="Criar novo agente">
    Clique no botão **Novo Agente** no canto superior direito. Você pode escolher um template da galeria ou começar em branco, no modo **Guiado** ou **Texto livre**.
  </Step>

  <Step title="Configurar o agente">
    Preencha as informações básicas:

    * **Nome** — identificador do agente
    * **Instruções / Prompt do Sistema** — personalidade e comportamento
    * **Mensagem de Boas-vindas** — primeira frase ao atender
  </Step>
</Steps>

## Passo 2: Adicionar Conhecimento

Para que o agente responda perguntas específicas do seu negócio, adicione documentos:

1. Vá para **Studio de IA > Base de Conhecimento**.
2. Faça upload do arquivo (PDF, TXT, DOCX, Markdown).
3. Volte ao agente e vincule o documento na seção **Documentos**.

## Passo 3: Testar no Playground

Antes de colocar em produção, valide o comportamento:

1. Acesse **Studio de IA > Playground**.
2. Selecione o agente criado (e, opcionalmente, um cliente do CRM para simular o contexto).
3. Libere o microfone e inicie uma conversa de teste.

<Tip>
  Use o Playground para refinar as instruções e a mensagem de boas-vindas antes de vincular o agente a um número.
</Tip>

## Passo 4: Conectar Plugins (opcional, mas recomendado)

Vários recursos da plataforma dependem de **Plugins** conectados em **Integrações > Plugins**:

* **Google Calendar** — necessário para a Tool de **Agendamento** e para o módulo de agendamento no cliente.
* **Gmail** — envio de e-mail nos templates, nas ações do cliente e em Campanhas de E-mail.
* **WhatsApp** — envio de mensagens nos templates, no cliente e em Campanhas de WhatsApp (até 3 números por organização).
* **Twilio SMS** — envio de SMS nos templates, no cliente e em Campanhas de SMS.
* **ClickSign** — envio de documentos para assinatura a partir da ficha do cliente.

Veja [Plugins](/plugins) para o passo a passo de cada provedor.

## Passo 5: CRM, pipeline e inbound

Quando o agente atende **números de telefone**, as **sessões** são vinculadas a **clientes** do CRM. Para organizar leads:

1. Em **CRM > Board**, crie ou edite uma **pipeline** com etapas e **descrições claras** (isso melhora a **classificação automática** após a ligação).
2. Em **Integrações > Números**, vincule uma **pipeline inbound** ao número para que **novos chamadores** entrem na **primeira etapa** desse funil. Detalhes em [Números de Telefone](/phone-numbers) e [Board](/board).

## Próximos Passos

* **Studio de IA > Tools** — crie ferramentas de [Endpoint, Handoff, Encerrar Chamada e Agendamento](/tools).
* **Integrações > Números** e **SIP Trunks** — [ligue um número BYOC](/phone-numbers) ao agente.
* **Templates > Biblioteca** — monte [templates de e-mail, documentos, WhatsApp e SMS](/files) com campos dinâmicos.
* **Operação > Campanhas** — dispare em lote por [Voz, E-mail, SMS ou WhatsApp](/campaigns).
* **CRM > Clientes** — use os [botões de ação rápida](/clients) (Discador, E-mail, SMS, WhatsApp, Gerar Documento).