A Z-API é uma solução não oficial paga e gerenciada por uma empresa externa. https://www.z-api.io/
Passo a passo para conexão
1. Contratar a Z-API
Antes de qualquer configuração no painel Konvoo, é preciso contratar API por aqui: https://www.z-api.io/
Pré-requisito na Plataforma Z-API
- Diferente das outras APIs, a instância precisa ser criada primeiro no painel de controle da Z-API. O Konvoo não pode criar instâncias na Z-API, apenas conectar-se a existentes.
2. Configuração no Painel Administrativo
- Acesse o menu Configurações > Integrações > WuzAPI
- URL da API: A URL padrão do serviço (https://api.z-api.io).
- Chave Global: O seu "Token de Segurança" gerado nas configurações da sua conta na Z-API.
- Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.
3. Adicionar um canal
Passo passo geral aqui: Como conectar um canal (sessão/número)
Configuração adicional para a Z-API:
- ID da Instância
- Token da Instância
4. Gerar o QR Code
Após salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.
5. Escanear no Aparelho
- Abra o WhatsApp no seu celular.
- Vá em Configurações (ou Ajustes) > Dispositivos Conectados.
- Clique em Conectar um dispositivo.
- Aponte a câmera do celular para o QR Code exibido na tela do Konvoo.
6. Confirmar a Conexão
Aguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.
O QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.
Estabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.