> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/avancado-recursos-tecnicos/integrando-o-chat-gpt.md).

# Integrando o chat GPT

Este tutorial irá guiá-lo pelo processo de integração do ChatGPT em sua plataforma Z-PRO, permitindo que você automatize conversas e utilize o poder da inteligência artificial da OpenAI em seus canais

## PRÉ-REQUISITOS

#### Vídeo configurando a sua conta na Open IA:

{% embed url="<https://youtu.be/Ikbd2_8VXAw>" %}

**Pré-requisitos: Configurando sua conta na OpenAI**

Antes de iniciar a integração no Z-PRO, é indispensável que você tenha uma conta configurada na plataforma de desenvolvedores da OpenAI.

1. **Crie sua Conta:** Acesse o site da API da OpenAI em [https://openai.com/pt-BR/api/](https://www.google.com/url?sa=E\&q=https%3A%2F%2Fopenai.com%2Fpt-BR%2Fapi%2F) e crie sua conta.
2. **Adicione Créditos:** A utilização da API da OpenAI é um serviço pago. Você precisará adicionar créditos à sua conta para que as requisições funcionem.
3. **Gere sua Chave de API (API Key):** Dentro do painel da OpenAI, navegue até a seção de chaves de API e gere uma nova chave. **Guarde esta chave em um local seguro, pois você precisará dela para configurar a integração no Z-PRO.**

Com a chave de API em mãos, você está pronto para configurar a integração.

## INTEGRAÇÃO NO Z-PRO

#### Vídeo integrando o ChatGPT no Z-PRO:

{% embed url="<https://youtu.be/-L7vUILb9Zw>" %}

#### **Passo 1: Ativando a Integração no Z-PRO**

A primeira etapa é habilitar a funcionalidade do ChatGPT dentro do seu sistema Z-PRO.

1. No menu lateral esquerdo, acesse **Configurações**.
2. Clique na aba **Bots e IA**.
3. No menu secundário que aparecerá, selecione a opção **Chat GPT**.
4. Ative a opção **"Ativar integração com ChatGPT"**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FnZ7KqUnZBWBD9bOSeqQi%2Fimage.png?alt=media&amp;token=8bf5b190-e22b-46e6-b365-b4d51e92083f" alt=""><figcaption></figcaption></figure>

*Opcional: Você também pode ativar a chave "Ativar integração com ChatGPT para todos os atendimentos por padrão" se desejar que o bot responda em todos os canais automaticamente. Caso contrário, você configurará canal por canal, como mostrado no próximo passo.*

#### **Passo 2: Configurando o ChatGPT em um Canal de Comunicação**

Após ativar a integração, você precisa configurar sua chave de API e as instruções do seu assistente em cada canal que desejar.

1. No menu principal, acesse **Canais de Comunicação**.
2. Localize o canal desejado (ex: WhatsApp, Webchat) e clique no ícone de **Configurações (engrenagem)**.
3. Caso não tenha nenhum canal criado ainda. Clique no botão + Adicionar Canal. Uma janela de configurações se abrirá.&#x20;

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FBQKA4DkZ7VBxwajXkrgM%2Fimage.png?alt=media&amp;token=96ef6550-3116-46a0-8fbc-f378739fd6c3" alt=""><figcaption></figcaption></figure>

#### **Passo 3: Integrando o chat GPT no seu canal**

**Para conectar o canal do z-pro com sua api da openIA, você precisa inserir:**

* **ChatGPT API Key:** Cole a chave de API que você gerou na plataforma da OpenAI.
* **ChatGPT Organization Key:** Cole a chave de ID da sua organização.

Você tem duas opções principais para definir como seu assistente de IA irá se comportar:

* **Opção 1: Prompt direto no Z-PRO (Prompt ChatGPT)**
  * Use este campo para escrever as instruções do seu assistente diretamente no Z-PRO. Defina sua personalidade, o tom de voz, as regras de negócio e como ele deve interagir com os usuários.
* **Opção 2: Usar um Assistant da OpenAI (AssistantId ChatGPT)**
  * Se você já criou e configurou um "Assistant" na interface (Playground) da própria OpenAI, basta colar o **ID do Assistant** neste campo. O Z-PRO utilizará todas as configurações que você já definiu por lá.
  * **Importante:** Ao usar um Assistant ID, as instruções do campo "Prompt ChatGPT" serão desconsideradas.

#### **Passo 4: Configurações Adicionais (Opcional)**

Ainda na mesma janela, você pode refinar a integração:

* **Palavra para desligar o ChatGPT:** Defina um termo específico (ex: "falar com atendente") que, ao ser enviado pelo cliente, desativará o bot e transferirá a conversa para um atendente humano.
* **ChatGPT Model:** Escolha o modelo de linguagem (LLM) que deseja utilizar (ex: gpt-4, gpt-3.5-turbo).
* **ChatGPT Voice Model:** Caso opte por respostas em áudio, selecione o modelo de voz desejado (ex: alloy, onyx, nova).
* **Ativar Respostas de Voz (ChatGPT Voice):** Ative esta opção para que o bot responda às mensagens com áudios em vez de texto.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2Fx4sydncOzLuTGilKnElV%2Fimage.png?alt=media&amp;token=6d99250d-ceab-4682-bbb3-46e72f5df7fc" alt=""><figcaption></figcaption></figure>

Após preencher as informações, salve as configurações. Seu canal estará pronto para utilizar o ChatGPT nos atendimentos.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/integrando-o-chat-gpt.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.