Documentation Index
Fetch the complete documentation index at: https://docs.gcvendas.com/llms.txt
Use this file to discover all available pages before exploring further.
Passo a passo para administradores conectarem o número WhatsApp comercial da empresa ao gc vendas via Z-API.
Para quem é este tutorial
Somente usuários com perfil Administrador podem cadastrar ou alterar credenciais. Vendedores enxergam o status da integração, mas não editam tokens.Pré-requisitos
Antes de começar, confirme que sua empresa possui:- Módulo WhatsApp liberado no gc vendas (se aparecer Em breve, solicite ao suporte.
Onde configurar no gc vendas
- Acesse Integrações no menu (ou pela área de configurações, conforme sua navegação).
- Clique no card WhatsApp (Z-API).
- Preencha o formulário de credenciais e salve.
| Campo | O que é |
|---|---|
| Instance ID | Identificador da instância no painel Z-API |
| Instance token | Token da instância |
| Client token | Client token da conta Z-API |
Validar que está funcionando
Teste inbound (cliente → empresa)
- De um celular pessoal, envie Olá para o número conectado à Z-API.
- Abra WhatsApp no gc vendas.
- A conversa deve aparecer na aba Caixa de entrada em alguns segundos.
Teste outbound (empresa → cliente)
- Abra a conversa de teste.
- Clique em Assumir conversa (vendedor) ou atribua um responsável (admin).
- Envie uma mensagem de texto pelo chat.
- Confirme no celular que a mensagem chegou pelo WhatsApp.
Alterar credenciais
- Na página Integrações → WhatsApp (Z-API), clique em Alterar credenciais.
- Informe todos os campos novamente (Instance ID, Instance token e Client token atuais do painel Z-API).
- Salve.
- A Z-API gerar novos tokens
- Trocar de instância ou de número
- Rotacionar credenciais por segurança
Papéis após a configuração
| Ação | Admin | Vendedor |
|---|---|---|
| Ver status Integração ativa | Sim | Sim |
| Cadastrar / alterar credenciais | Sim | Não |
| Atender na inbox | Sim | Sim (conforme atribuição) |
Problemas comuns
Página mostra Integração não configurada (vendedor)
Peça a um administrador da empresa para concluir o cadastro em Integrações → WhatsApp (Z-API).Credenciais salvas, mas inbox vazia
Verifique:- Webhook configurado na Z-API apontando para a URL correta do ambiente
- Instância Z-API conectada (QR code / sessão ativa no painel)
- Número de teste enviando mensagem individual (não grupo)