# Como funciona a integração Z-API (não oficial) na WavUps CRM

> A Z-API é uma integração **não oficial** do WhatsApp que a WavUps CRM usa só para **enviar** mensagens quando a janela de 24 horas da API oficial está fechada. Ela só aparece em **Integrações** nas contas em que foi liberada pela equipe WavUps, e funciona junto com o WhatsApp Business oficial, nunca no lugar dele.

Fonte: Central de ajuda da WavUps CRM — https://crm.wavups.com/docs/integracoes/z-api (atualizado em 8 de outubro de 2026)

## Quando a Z-API aparece

O cartão **Z-API** não aparece para todas as contas. Ele só fica disponível em **Integrações** depois que a equipe WavUps libera o recurso para a sua conta. Se você não vê o cartão e tem interesse, fale com o [Suporte](https://crm.wavups.com/docs/conta-e-equipe/suporte).

> **Integração não oficial**
> A Z-API não é uma ferramenta oficial da Meta. A WavUps CRM não se responsabiliza por sanções, restrições ou bloqueios da Meta em contas que usam ferramentas não oficiais. Prefira sempre a API oficial.

## Para que serve

- A Z-API serve **só para enviar** mensagens quando a janela de 24 horas da API oficial do WhatsApp está fechada.
- Para receber mensagens e usar a automação completa, mantenha o [WhatsApp Business oficial](https://crm.wavups.com/docs/integracoes/whatsapp-business) conectado. Quando o cliente responde, a conversa volta a seguir pela API oficial.
- As instâncias da Z-API usam o **mesmo limite de números** do WhatsApp Business do seu plano.

## Passo a passo: adicionar uma instância

### Passo 1: Pegue as credenciais na Z-API

No painel da Z-API (z-api.io), copie o **ID da instância**, o **Token da instância** e o **Client-Token** (token de segurança).

### Passo 2: Abra a tela da Z-API

Em **Integrações**, no cartão **Z-API**, clique em **Adicionar instância** (ou em **Gerenciar** e depois em **Adicionar instância**).

![Tela Z-API sem instâncias, com o aviso de integração não oficial e o botão para adicionar a primeira instância.](https://crm.wavups.com/images/docs/integracoes-zapi-vazio.png)

### Passo 3: Preencha o painel

No painel **Nova instância Z-API**, preencha **Nome ou número** (como a instância aparece na plataforma), **ID da instância**, **Token da instância** e **Client-Token (token de segurança)**.

![Painel da instância Z-API com o nome, o ID da instância, o token da instância e o token de segurança.](https://crm.wavups.com/images/docs/integracoes-zapi-painel.png)

### Passo 4: Salve

Clique em **Adicionar instância**. Aparece **Instância Z-API adicionada!** e a instância entra na lista **Instâncias**.

![Painel da instância Z-API com o botão de salvar destacado.](https://crm.wavups.com/images/docs/integracoes-zapi-painel.png)

A lista mostra a **Situação** (**Ativa** ou **Inativa**) e a **Conexão** (**Pronto**, **Não pronto** ou **Erro ao consultar**) de cada instância.

## Editar e remover

- **Editar**: no menu **...** da instância, clique em **Editar**. Deixe as credenciais em branco para manter as atuais; para trocar, preencha os três campos.
- **Remover**: no menu **...**, clique em **Remover instância** e confirme. A instância é desconectada da plataforma e a ação não pode ser desfeita.

## Se algo der errado

| Mensagem ou situação | O que fazer |
| --- | --- |
| **Não foi possível salvar a instância.** | Confira se copiou o ID, o token e o Client-Token certos no painel da Z-API. |
| **Para trocar as credenciais, preencha os três campos.** | Ao editar, preencha ID, token e Client-Token juntos, ou deixe os três em branco. |
| Conexão **Não pronto** | A instância não está conectada na Z-API. Confira o status no painel da Z-API. |
| **Limite do plano atingido** | Você já usa todos os números do plano (WhatsApp Business e Z-API somados). Remova um ou mude de plano. |

## Perguntas frequentes

### A Z-API substitui o WhatsApp Business oficial?

Não. Ela só envia mensagens quando a janela de 24 horas está fechada. O recebimento e a automação continuam pela API oficial.

### Por que não vejo a Z-API em Integrações?

Ela só aparece nas contas em que foi liberada pela equipe WavUps. Fale com o suporte se tiver interesse.

### Existe risco em usar a Z-API?

Sim. Por ser não oficial, a Meta pode aplicar restrições ao número. Use com cuidado e prefira a API oficial e os [modelos do WhatsApp](https://crm.wavups.com/docs/mensagens/modelos-do-whatsapp).

## Veja também

- [Como conectar o WhatsApp Business (API oficial) na WavUps CRM](https://crm.wavups.com/docs/integracoes/whatsapp-business)
- [Janela de 24 horas do WhatsApp: o que é e como funciona na WavUps CRM](https://crm.wavups.com/docs/mensagens/janela-de-24-horas)
- [Como criar modelos (templates) do WhatsApp na WavUps CRM](https://crm.wavups.com/docs/mensagens/modelos-do-whatsapp)