> For the complete documentation index, see [llms.txt](https://docs.flw.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flw.chat/guide/documentacao/faq/whatsapp-nao-oficial/z-api-integrado.md).

# Z-API (integrado)

{% hint style="info" %}
Neste tutorial, será apresentado o processo de conexão de um canal Z-API Integrado. Essa modalidade se diferencia pelo modelo de faturamento, que é realizado diretamente pela plataforma, dispensando a contratação e o gerenciamento de uma conta própria na Z-API.

Essa opção é ideal para usuários que buscam praticidade e rapidez na configuração, permitindo disponibilizar novos canais de forma simples e eficiente.
{% endhint %}

{% hint style="success" %}
**Pré-requisitos:** 

Para realizar a conexão de APIs não oficiais será necessário habilitar nas configurações da conta e do parceiro esse recurso, veja abaixo os passos a seguir. 
{% endhint %}

**Passo 1: Habilitar canais não oficiais na plataforma**

1. Na tela inicial, acesse o menu **ADMIN.**
2. Clique na opção **Personalizar** para iniciar o processo de configuração de canais não oficiais na plataforma.

<figure><img src="/files/Mk1lviB28PzdhItjB5Jj" alt=""><figcaption></figcaption></figure>

**Passo 2: Procurar por configurações da plataforma**

1. Em configurações da plataforma na aba de **Detalhes** habilite as opções **Ativar canal não oficial (integrado).**
2. Salve as novas configurações no botão **Salvar.**&#x20;

<figure><img src="/files/Bu1TfcRvBEkwFd5Foe3Y" alt=""><figcaption></figcaption></figure>

**Passo 3: Habilitar canais não oficiais para a conta.**

1. Na tela inicial, acesse o menu **ADMIN.**
2. Clique na opção **Contas** para iniciar o processo de configuração de canais não oficiais na conta.

<figure><img src="/files/D0JhBk6yhDaxoccmO42S" alt=""><figcaption></figcaption></figure>

**Passo 4: Selecionar a conta que deseja habilitar os canais não oficiais**

1. Nos detalhes da conta clique em alterar.
2. Procure por **Recursos**.

<figure><img src="/files/iSxwCOxYUQbr47AjiyNW" alt=""><figcaption></figcaption></figure>

**Passo 5: Habilitar os recursos.**

1. Nos recursos da conta habilite a opção **Canal não oficial**.
2. Clique no botão salvar.

<figure><img src="/files/enTap2WC1M9uTFCHPf0j" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Após a conclusão das etapas anteriores, a comunicação com APIs não oficiais estará habilitada. A seguir, será apresentado o passo a passo para a realização da conexão do canal.
{% endhint %}

{% hint style="success" %}
**Pré-requisitos**:

* Ter uma **conta na plataforma**
  {% endhint %}

**Passo 1: Acessar as configurações da conta.**

1. Acesse o menu **Ajustes.**
2. Clique em conta.

<figure><img src="/files/OTIZBmknxNXyrALpLtoA" alt=""><figcaption></figcaption></figure>

**Passo 2: Acessar os canais de atendimento.**

1. Clique na aba **Canais de atendimento**.

<figure><img src="/files/d7vmB0NQ7t1LpXSzVacm" alt=""><figcaption></figcaption></figure>

**Passo 3: Adicione o canal.**

1. Na tela de Canais de atendimento, clique com destaque em azul.
2. Passe o mouse sobre **WhatsApp QRCode.**
3. Selecione a opção **Z-API** como mostra imagem abaixo.

<figure><img src="/files/w5az7ORhRIusujAaCqEt" alt=""><figcaption></figcaption></figure>

**Passo 4: Acesse o aplicativo do whatsapp.**

1. Em seu aparelho, procure pela icone de configuração do whatsapp
2. Procure por  **Dispositivos conectados.**
3. Clique no botão **Conectar um dispositivo**.
4. Clique em **Continuar**.

<figure><img src="/files/6PQlotFm1UtOge7GF32x" alt=""><figcaption></figcaption></figure>

**Passo 5: Ler o QRCode na tela.**

1. Leia o QRCode na tela com seu aparelho.
2. Clique em **Continuar**.

<figure><img src="/files/ia8utFf8Sktu2bJBuTLi" alt=""><figcaption></figcaption></figure>

**Passo 6: Finalizar o processo de conexão.**

1. Após seguir todos os passos acima, clique em **Finalizar**.

<figure><img src="/files/HH9TgWvzzb5kXlgZwwoC" alt=""><figcaption></figcaption></figure>


---

# 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.flw.chat/guide/documentacao/faq/whatsapp-nao-oficial/z-api-integrado.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.