Documentação / Comece Aqui / API Não Oficial / Z-API Conta Própria
Comece Aqui · API Não Oficial

Z-API Conta Própria

Nesta modalidade, a instância da Z-API é contratada por você diretamente com o provedor. Isso significa que a conta e o faturamento do serviço ficam sob sua responsabilidade, e o Chat C&M entra apenas como o ambiente onde as conversas são centralizadas. É a opção para quem quer autonomia e controle sobre a administração da integração.

✅

Pré-requisitos: ter uma conta no Chat C&M com perfil de Administrador — só administradores conseguem conectar canais não oficiais — e ter uma conta ativa na Z-API.

ℹ️

Conexões não oficiais não passam pela infraestrutura da Meta e, por isso, seguem regras diferentes das da API oficial. Antes de escolher essa modalidade, vale conhecer as limitações e os riscos envolvidos em Restrições em Conexões Não Oficiais.

01 Obter as credenciais na Z-API

A conexão pede três dados da sua instância: o ID, o token da instância e o token de segurança. Vale reunir tudo antes de começar, porque um deles tem uma pegadinha.

1
Copie o ID e o token da instância

Acesse o seu portal da Z-API, abra a aba Instâncias Web e copie o ID e o token da conta.

Na aba Instâncias Web, copie o ID e o token da instância.
Na aba Instâncias Web, copie o ID e o token da instância.
⚠️

Atenção ao token de segurança: ele aparece uma única vez, no momento em que é criado. Se você não guardou, não há como consultá-lo depois — será necessário gerar um novo para seguir com a configuração.

2
Gere um novo token de segurança, se precisar

Na Z-API, abra a aba de segurança e clique no ícone de geração de novo token.

Em Segurança, no bloco Token de segurança da conta, clique no ícone de gerar novo token.
Em Segurança, no bloco Token de segurança da conta, clique no ícone de gerar novo token.
3
Confirme por código

Escolha como deseja receber o código OTP, confirme a opção e informe o código recebido.

4
Copie e guarde o novo token

Copie o token exibido, marque a confirmação de leitura do aviso na tela e finalize a ação. Guarde esse valor em local seguro — ele não será exibido de novo.

Copie o token, marque a confirmação de leitura e clique em Finalizar.
Copie o token, marque a confirmação de leitura e clique em Finalizar.

02 Conectar o canal

Com as três credenciais em mãos, a conexão é feita dentro do Chat C&M e termina com a leitura de um QR Code pelo aplicativo do WhatsApp, como em qualquer dispositivo conectado.

1
Abra os canais de atendimento

No Chat C&M, clique em Ajustes → Conta e abra a aba Canais de atendimento.

2
Adicione o canal

Clique no ícone de adição, passe o mouse sobre WhatsApp QRCode e selecione Z-API (Conta própria).

No (+), passe o mouse sobre WhatsApp QRCode e selecione Z-API (Conta própria).
No (+), passe o mouse sobre WhatsApp QRCode e selecione Z-API (Conta própria).
3
Inicie a integração

Clique em Iniciar para começar o processo.

4
Informe os dados da instância

Preencha o ID da instância, o token da instância e o token de segurança, depois clique em Continuar.

Preencha o ID da instância, o token da instância e o token de segurança.
Preencha o ID da instância, o token da instância e o token de segurança.
5
Prepare o aparelho

No celular, abra as configurações do WhatsApp, entre em Dispositivos conectados, toque em Conectar um dispositivo e depois em Continuar.

No celular, abra Aparelhos conectados e toque em Conectar um aparelho.
No celular, abra Aparelhos conectados e toque em Conectar um aparelho.
6
Leia o QR Code

Aponte a câmera para o QR Code exibido na tela e clique em Continuar.

Leia o QR Code exibido na tela e clique em Continuar.
Leia o QR Code exibido na tela e clique em Continuar.
7
Finalize

Clique em Finalizar para concluir a conexão. O canal já aparece disponível em Canais de atendimento.

ℹ️

Com o canal conectado, as conversas passam a ser centralizadas no Chat C&M junto com os demais canais da operação. Como a instância é sua, qualquer questão de plano, cobrança ou disponibilidade do serviço é tratada diretamente com a Z-API.

Suporte