Documentação / Comece Aqui / API Não Oficial / Z-API Integrado
Comece Aqui · API Não Oficial

Z-API Integrado

Na modalidade integrada, você não precisa contratar nem administrar uma conta na Z-API: a instância já vem provisionada e o serviço entra na sua cobrança do Chat C&M. Isso elimina a etapa de credenciais e torna a conexão bem mais curta — é a escolha natural para quem quer subir um canal novo rapidamente, sem gerenciar mais um fornecedor.

✅

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

01 Integrado ou Conta Própria?

As duas modalidades usam a mesma tecnologia e entregam a mesma experiência de atendimento. O que muda é quem administra a instância e para onde vai a cobrança.

  • Integrado — a instância é provisionada automaticamente e o custo entra na sua conta do Chat C&M. Nenhuma credencial a informar, nenhum painel externo para acompanhar. Conexão em poucos cliques.
  • Conta Própria — você contrata a instância direto com a Z-API, administra o painel e recebe a cobrança deles. Dá mais autonomia, mas exige informar ID e tokens na configuração. O passo a passo está em Z-API Conta Própria.
ℹ️

Independentemente da modalidade, trata-se de uma conexão não oficial: ela não passa pela infraestrutura da Meta e segue regras diferentes das da API oficial. Vale conhecer as limitações e os riscos em Restrições em Conexões Não Oficiais antes de decidir.

02 Conectar o canal

Sem credenciais para reunir, o processo inteiro acontece dentro do Chat C&M e termina com a leitura de um QR Code pelo celular, como em qualquer aparelho conectado ao WhatsApp.

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.

No (+), passe o mouse sobre WhatsApp QRCode e selecione Z-API — “Integrar via QRCode”.
No (+), passe o mouse sobre WhatsApp QRCode e selecione Z-API — “Integrar via QRCode”.
⚠️

Cuidado para não confundir: o menu traz duas opções parecidas. Z-API (descrita como “Integrar via QRCode”) é a modalidade integrada, tratada nesta página. Z-API (Conta própria) — “Usar minha conta já existente” — é a outra modalidade, e vai pedir ID e tokens que você não tem nesse fluxo.

3
Inicie a integração

Clique em Iniciar para começar o processo.

4
Prepare o aparelho

No celular, abra o menu do WhatsApp, entre em Aparelhos conectados, toque em Conectar um aparelho 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.
5
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.
6
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 é gerenciada pela C&M nesta modalidade, qualquer questão de disponibilidade ou cobrança do serviço é tratada pelo nosso suporte.

Suporte