Todos os tutoriais
Configuracao
5 min

Instalar e acessar a extensao

Instale a extensao, abra o WhatsApp Web e encontre os atalhos principais.

Dicas práticas

Neste guia: Instale a extensão no seu navegador e encontre o painel do Zhapio no WhatsApp Web.

Instalacao

A extensao Zhapio roda dentro do WhatsApp Web, no formato Manifest V3. Ela e distribuida pela Chrome Web Store, que atende Chrome, Brave e Edge, e pelo Firefox Add-ons, para o Firefox — o botao "Instalar extensao" no painel do Zhapio abre a loja certa para o navegador que voce esta usando. Outros navegadores nao sao testados nem garantidos pelo Zhapio.

Na instalacao, o navegador pede a confirmacao das permissoes da extensao: guardar dados localmente no navegador (storage), abrir e focar abas do WhatsApp Web (tabs) e agendar lembretes internos (alarms). Ela so age dentro do WhatsApp Web, do site do Zhapio e da infraestrutura de dados do Zhapio (Supabase) — nenhum outro site e acessado. Essas permissoes sao concedidas uma unica vez, na instalacao: depois disso nao aparecem novos pedidos de permissao. No Firefox, a instalacao tambem informa quais dados a extensao envia ao Zhapio (sua sessao de login, dados de contatos e leads e o conteudo das mensagens que ela gerencia) e oferece, como opcional, o envio de relatorios tecnicos de erro; essas escolhas podem ser revistas depois em about:addons.

  1. Abra a loja do seu navegador — Chrome Web Store no Chrome, Brave e Edge, ou Firefox Add-ons no Firefox — e instale a extensao Zhapio. O botao "Instalar extensao" no painel e em Configuracoes do Zhapio leva direto a pagina certa.

  2. Abra web.whatsapp.com em uma aba do navegador e faca login no WhatsApp normalmente, escaneando o QR code se for a primeira vez.

  3. A barra lateral do Zhapio aparece encostada na borda esquerda assim que a pagina carrega — ela nao espera o WhatsApp terminar de carregar para aparecer.

Dicas práticas

Clicar no icone do Zhapio na barra de extensoes do navegador nao abre um popup — a extensao nao tem um. O clique procura uma aba do WhatsApp Web ja aberta, foca nela e abre o overlay de conta do Zhapio por cima; se nao houver nenhuma aba aberta, abre uma nova automaticamente em web.whatsapp.com.

Onde fica a barra lateral

A barra do Zhapio e inserida diretamente na pagina do WhatsApp Web — nao e uma aba separada nem um popup. Ela fica presa a borda esquerda da tela, numa faixa fixa de cerca de 62 pixels de largura que ocupa toda a altura da janela, sempre acima do conteudo do WhatsApp.

No topo fica o logotipo "Z": clicar nele abre o painel web do Zhapio (o dashboard completo da plataforma) em uma nova aba. Abaixo dele ficam dois grupos de icones. O grupo principal reune os atalhos operacionais — Voltar ao WhatsApp (fecha os paineis do Zhapio e volta a tela padrao do WhatsApp, sem esconder a barra), Leads, Contatos, Disparos, Copiloto, Automacoes, Calendario e Midia, alem de Google Ads e Instagram, marcados como "em breve" e que hoje so mostram um aviso de que a funcao ainda esta por vir. O grupo inferior reune atalhos fixos — alternar tema claro/escuro, documentacao, feedback/suporte e a sua conta — mais dois icones que so aparecem depois que voce faz login: o atalho do assistente de IA (que tambem exige ter um provedor de IA configurado) e o de indicacao.

Importante

Todos os paineis operacionais — Leads, Contatos, Disparos, Copiloto, Automacoes, Calendario e Midia — dependem de voce estar autenticado no Zhapio para carregar dados; sem login, cada um mostra um aviso no lugar do conteudo. Para o passo a passo de cada painel da barra lateral, veja o guia de uso da barra lateral no WhatsApp Web.

Se a extensao nao aparecer

A barra de icones e bem resistente: se o proprio WhatsApp Web tenta escondê-la ou redimensiona a pagina por cima dela, o Zhapio verifica o estado a cada 3 segundos e reaplica a barra sozinho. Por isso, recarregar a pagina raramente e necessario so para os icones reaparecerem.

  1. Confirme se a extensao esta ativada em chrome://extensions (Chrome, Brave e Edge) ou em about:addons (Firefox) — ela pode ser desativada automaticamente depois de uma atualizacao do navegador. No Firefox, confira tambem se a permissao de acesso ao web.whatsapp.com continua concedida: sem ela a barra do Zhapio nao aparece.

  2. Recarregue a aba do WhatsApp Web.

  3. Se voce acabou de instalar a extensao ou acabou de conceder alguma permissao, feche e abra o navegador novamente.

Dicas práticas

Se os icones aparecem normalmente mas os paineis (Leads, Contatos, etc.) mostram "Login necessario" em vez de dados, o problema nao e a extensao sumida — e sessao. Veja a proxima secao.

Se aparecer "Login necessario"

Se voce instalou a extensao mas ainda nao entrou na sua conta Zhapio, o comportamento esperado nao e a barra sumir — e um aviso de login aparecer. No canto superior direito da tela surge um banner "Login necessario" com o texto "Clique abaixo para abrir o popup de login do Zhapio e entrar" e um botao "Entrar", junto com a dica "Se o navegador bloquear, abra manualmente pelo icone da extensao Z." Cada painel operacional (Leads, Contatos, Disparos, Copiloto, Calendario, Automacoes) mostra o mesmo aviso no lugar dos dados, e um chip flutuante "Entrar no Zhapio" fica fixo no canto inferior direito como lembrete.

  1. Clique em "Entrar" no banner (ou no chip "Entrar no Zhapio" no canto inferior direito) para abrir a janela de login do Zhapio.

  2. Se o navegador bloquear a janela por causa do bloqueio de pop-up, abra-a manualmente clicando no icone "Z" da extensao na barra de ferramentas do navegador.

  3. Faca login normalmente. Assim que a sessao for reconhecida, os avisos somem e os paineis carregam os dados — nao e preciso recarregar a pagina.

Continue aprendendo

Escolha o próximo guia de acordo com a tarefa que você quer concluir: