> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/novos-tutoriais-organizar/configurando-o-fortics-ia-no-voz.md).

# Configurando o Fortics IA no Voz

Aqui você realiza a integração com o **Fortics IA**, informando a URL da API e a respectiva chave de autenticação da conta. Esses dados são essenciais para habilitar funcionalidades críticas do sistema, como:

**URA Inteligente**: A utilização do componente do **Fortics IA** na URA, possibilitando fluxos de atendimento mais inteligentes e automatizados.

**Geração de Insights**: Permite configurar os pipelines responsáveis pela análise das chamadas e geração de ***insights***. 

Criando uma conexão

No menu lateral esquerdo, navegue até **Configurações > Inteligência artificial**.

<img src="/files/HHsW7lUYW8f8TKyvCyKv" alt="" height="301" width="602">

Clique no **ícone de adicionar (+)** no canto superior direito para abrir o formulário de integração.

<img src="/files/fg8wD8UbxXEThxHisMHS" alt="" height="301" width="602">

Preencha os campos obrigatórios conforme os dados da sua conta do Fortics IA:&#x20;

**Nome**: Identifique a integração (ex: *IA Principal)*.

**URL**: Insira o endereço de conexão da API da sua conta.

**Playlist**: Selecione a playlist de áudios utilizada pelo sistema durante o processamento das solicitações. Essa configuração define quais mensagens serão reproduzidas enquanto a IA processa a interação.

**Chave da API (API Key)**: Insira a chave de autenticação exclusiva para validar a conexão entre o *Fortics Voz* e o motor de IA.

Clique em **Salvar** para submeter os dados.

## Configurando o Fortics IA

Para conectar o **Fortics Voz** ao seu motor de inteligência, você precisará realizar uma configuração em duas etapas: gerar a chave de API no Fortics IA e utilizá-la no Fortics Voz.&#x20;

### Gerar a Chave de API no Fortics IA

Acesse o seletor de módulos (ícone de grade no topo superior direito) e selecione o módulo **IA**.

<img src="/files/GvO26Oos9xwj3VGjc58W" alt="" height="292" width="602">

Dentro da plataforma de IA, navegue pelo menu lateral esquerdo em **Configurações > API.**

<img src="/files/1xxRWEwTwJVdwf1ola2W" alt="" height="308" width="602">

Clique no botão **+ Nova chave de API**.

<img src="/files/FfFeVaDxwo0yoSg5aiof" alt="" height="311" width="602">

No modal que abrir, nomeie sua chave (ex: Integração Voz) e copie o código gerado no campo **API KEY**. Salve a configuração para garantir a criação da chave.

### Aplicar no Fortics Voz

Retorne ao seletor de módulos e acesse o **Voz** e volte ao formulário para adicionar uma Inteligência Artificial no Fortics Voz e preencha os dados:

<img src="/files/c5xxMmASrbCp6ozoQeZy" alt="" height="301" width="602">

**Nome:** Identifique a integração (ex: *Fortics IA*).

**URL**: Insira o endereço <https://app.genier.ai/seuambiente> substituindo seuambiente pelo identificador único da sua conta.

**Playlist**: Selecione **Sistema**.

**Chave da API**: Cole a chave que você copiou no passo anterior.

Clique em **Salvar.** O sistema validará automaticamente a conexão.

## Editando uma conexão de IA

Para atualizar parâmetros como URL da API, Playlist ou Chave de Acesso, localize o card da configuração desejada na lista principal.

<img src="/files/NzMy4ioXoPmPSnR6OB5g" alt="" height="230" width="257">

Clique no **ícone de menu (três linhas)** localizado no canto superior direito do card e selecione a opção **Editar**.

O sistema abrirá o formulário **com as configurações atuais preenchidas**, permitindo atualizar apenas os campos necessários.&#x20;

## Removendo uma conexão de IA

Para excluir uma integração de IA que não é mais utilizada, no card da configuração, **clique no ícone de menu (três linhas)** e selecione a opção **Excluir**.

<img src="/files/TWPS6iWdhjf7Nxb8975e" alt="" height="230" width="259">

O sistema solicitará uma mensagem de confirmação através de um alerta de segurança. Se estiver certo da decisão, clique em **Sim, confirmar**.

<img src="/files/JW2mgMSxDzt7chTeLyYu" alt="" height="396" width="494">

#### Resultado esperado

Após concluir a configuração, o Fortics Voz estará integrado ao Fortics IA, permitindo utilizar recursos como URA Inteligente e geração de Insights baseados nas chamadas da operação.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/novos-tutoriais-organizar/configurando-o-fortics-ia-no-voz.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.