App do Parceiro
Navegação da documentação
Integrações

Conectar o WhatsApp (Z-API)

Crie sua conta no Z-API, conecte uma instância ao WhatsApp e configure seus grupos de envio no App do Parceiro para disparar ofertas.

O App do Parceiro envia suas ofertas para grupos de WhatsApp por meio de um provedor que faz a ponte com o WhatsApp. Um dos provedores é o Z-API. Ele é o mais completo — e também o mais caro dos dois (o outro é o Wame).

A configuração tem duas partes: primeiro você conecta o Z-API ao App (criar conta, assinar, criar uma instância e ligá-la ao seu WhatsApp); depois você escolhe os grupos onde as ofertas serão enviadas.

⚠️ Importante (regras do WhatsApp): o WhatsApp (Meta) pode banir números por envio em massa ou spam. Envie com moderação e só para grupos que esperam receber as suas ofertas.

Parte 1 — Conectar o Z-API

1. Crie sua conta no Z-API

Acesse o site do Z-API e crie a sua conta:

🔗 Criar conta no Z-API

2. Assine o Z-API

No Z-API, o envio funciona a partir de uma instância — é ela que fica ligada ao seu WhatsApp. Para usar, é preciso ter uma assinatura ativa: informe os dados de pagamento e, assim que o pagamento for aprovado, você poderá conectar o seu WhatsApp.

🎁 Se você nunca assinou antes, o Z-API oferece 3 dias de teste gratuito para experimentar.

3. Crie uma instância

No menu Instâncias Web, crie uma nova instância e dê um nome para ela (no exemplo, "App do Parceiro").

Tela de criação de uma nova instância web no Z-API, com o campo Nome da instância preenchido como "App do Parceiro"

Ainda na criação da instância, recomendamos dois ajustes:

  • Ative a "Proteção anti-golpe em grupos de avisos". O Z-API apaga sozinho as mensagens de golpistas nos grupos em que a instância é administradora.
  • Ative "Desabilitar enfileiramento quando o WhatsApp estiver desconectado". Se o número cair, isso evita que as automações acumulem uma fila enorme de mensagens para disparar de uma vez quando reconectar — o que pode virar spam.

Configurações da instância no Z-API com a Proteção anti-golpe e o Desabilitar enfileiramento ativados

Clique em Salvar.

4. Conecte o seu WhatsApp e copie o ID e o Token da instância

Abra a instância. Nessa mesma tela você faz as duas coisas:

  • Conecte o seu WhatsApp — leia o QR Code (como no WhatsApp Web) ou use Conectar com número de telefone.
  • Copie o ID da Instância e o Token da Instância — eles ficam logo abaixo do QR Code, ali mesmo (mais prático do que procurar na listagem).

Tela da instância no Z-API com o QR Code para conectar o WhatsApp e, ao lado, o ID e o Token da instância para copiar

💡 As credenciais ficam disponíveis mesmo antes de conectar, mas conecte o WhatsApp à instância antes de cadastrar as chaves no App do Parceiro.

5. Copie o Token de Segurança da conta

Falta um último dado: no menu Segurança, copie o "Token de segurança da conta" (também chamado de Client-Token).

Página Segurança do Z-API com o Token de segurança da conta (Client-Token) ativo

⚠️ Guarde essas credenciais com segurança e não as compartilhe.

6. Cadastre no App do Parceiro

Com as credenciais em mãos, cadastre a integração:

  1. No painel web, abra Integrações no menu lateral.
  2. Encontre o WhatsApp (Z-API) na lista e clique para abrir.
  3. Preencha o ID da Instância, o Token da Instância e o Token de Segurança (Client-Token) e clique em Salvar. A gente valida as chaves ao salvar.

Modal Configurar Integração com WhatsApp (Via Z-API) no App do Parceiro, com os campos ID da Instância, Token da Instância e Token de Segurança

💡 Dicas: depois de conectar a instância, espere alguns minutos antes de cadastrar as chaves. Se aparecer um erro mesmo com tudo certo, tente inserir de novo o ID da Instância e o Token da Instância.

Parte 2 — Configurar os grupos

Depois de conectar, você tem acesso a uma área para gerenciar os grupos de envio — uma página na versão web e uma tela no app. É aqui que você diz ao App do Parceiro para quais grupos as ofertas devem ir (você pode ter vários).

Página do WhatsApp (Z-API) conectado no App do Parceiro, com a lista de grupos de envio e o botão Adicionar grupo

  1. No painel web, abra a página do WhatsApp (Z-API) em Integrações.
  2. Clique em Adicionar grupo.

Ao adicionar um grupo, você preenche:

  • Grupo — o App lista os grupos em que o seu número participa com permissão de envio; escolha o que você quer usar. Se a lista vier vazia, confira se a instância está conectada ao WhatsApp.
  • Descrição (opcional) — uma nota para você lembrar deste grupo.
  • Tamanho da imagem do link — como a prévia da imagem aparece na mensagem: Grande, Média ou Pequena.

Repita para cada grupo que quiser usar. Há um limite de grupos por conta, mostrado no contador (ex.: "2 de 20 grupos").

Tudo pronto! 🎯

Com o WhatsApp conectado e pelo menos um grupo configurado, a integração está pronta. Para testar, pegue uma oferta e dispare para um dos seus grupos — assim você confirma que a mensagem chega direitinho.