Suporte

Como conectar a sua conta Kiwify, o que significa cada mensagem do add-on e como falar com a gente.

Atendimento por e-mail: contato@vendilha.com.br. Diga qual é o seu e-mail Google, copie a mensagem exata que apareceu e conte o que você estava fazendo. Nunca envie o seu client_secret, nem em print.

Como obter as credenciais na Kiwify

A Vendilha precisa de três dados da sua conta Kiwify: client_secret, client_id e account_id (nessa ordem, como a Kiwify mostra). Todos saem da mesma tela.

1. Entre no painel da Kiwify com a conta que recebe as vendas (se você é coprodutor, use a conta em que as vendas aparecem para você).
2. Abra Apps > API.
3. Clique em Criar API Key. Dê um nome fácil de reconhecer, como Planilha Google. Se a tela deixar escolher permissões, marque só as de leitura de vendas.
4. Copie o client_id e o client_secret. O account_id aparece no mesmo lugar em que você gerou a chave.
5. Na planilha, abra Extensões > Vendilha > Abrir painel, cole cada valor no campo com o mesmo nome e clique em Conectar.
6. Com a conta conectada, clique em Sincronizar agora. As abas Vendas Kiwify e Resumo Kiwify são criadas na hora.

Mensagens do add-on e o que fazer

"Preencha os três campos: client_secret, client_id e account_id."

Algum campo ficou vazio. Cole os três valores da mesma API Key e clique em Conectar de novo.

"A Kiwify recusou as credenciais. Confira client_secret, client_id e account_id em Apps > API no painel da Kiwify."

A Kiwify não aceitou a combinação dos três dados. As causas mais comuns:

• um valor foi colado no campo errado (confira os formatos acima);
• o client_id e o client_secret são de chaves diferentes;
• a API Key foi apagada ou desativada na Kiwify;
• o account_id é de outra conta.

Se nada disso resolver, crie uma API Key nova em Apps > API e cole os três dados dela. Os dados já sincronizados continuam na planilha.

"A Kiwify limitou as requisições por alguns instantes. Tente de novo em 1 minuto."

A API da Kiwify aceita um número limitado de consultas por minuto. O add-on já espera e tenta de novo sozinho; essa mensagem só aparece quando o limite continua. Aguarde um minuto e clique em Sincronizar agora. Nada foi perdido.

"A Kiwify está instável agora. Tente de novo em alguns minutos."

A Kiwify respondeu com erro do lado dela. Tente de novo mais tarde. No Pro, a próxima sincronização automática tenta de novo sozinha.

"Já existe uma sincronização em andamento nesta planilha."

Outra sincronização (sua ou a automática de hora em hora) está rodando. Espere alguns minutos e tente de novo.

"Conecte sua conta Kiwify no painel primeiro."

Você usou Extensões > Vendilha > Sincronizar agora antes de conectar. Abra o painel e siga os passos das credenciais. As credenciais são guardadas por pessoa: se outra pessoa conectou a planilha e a compartilhou com você, você precisa conectar com a sua própria chave para sincronizar.

"A sincronização automática é do plano Pro."

No Grátis, a sincronização é manual. Se você já assinou, clique em Já assinei no painel para atualizar o plano. A assinatura precisa estar no mesmo e-mail Google que você usa na planilha.

"Histórico grande: a importação continua na próxima sincronização."

Não é erro. O Google limita cada execução a 6 minutos, então históricos grandes entram em partes. Clique em Sincronizar agora de novo ou, no Pro, deixe a sincronização automática terminar o trabalho.

"(Plano grátis: últimos 30 dias.)"

No Grátis entram só as vendas dos últimos 30 dias. O histórico completo é do Pro.

"N vendas com moedas mistas ficaram fora do resumo."

Aparece na aba Resumo quando há vendas recebidas em outra moeda. Elas ficam separadas para não misturar real com dólar. Troque a moeda na célula B1 da aba Resumo para ver essas vendas.

"Erro inesperado: …"

Algo saiu do previsto. Copie a mensagem inteira e mande para contato@vendilha.com.br. Se o texto citar "Rota não permitida (o conector é só leitura)", a trava de segurança do add-on bloqueou uma chamada que não é de consulta; nos avise, porque isso não deveria acontecer.

Outros problemas comuns

O painel mostra "PERMISSION_DENIED" ou fica em "Carregando…"

Isso acontece quando há várias contas Google logadas no mesmo navegador: o Google tenta abrir o painel com a primeira conta logada, e não com a dona da planilha. É uma limitação do Google, não da Vendilha. Para resolver, abra a planilha numa janela anônima (Ctrl + Shift + N) só com a conta em que instalou, ou crie um perfil do Chrome para essa conta. Uma alternativa é sair das outras contas e entrar primeiro com a conta da planilha.

Não encontro a Vendilha no menu Extensões

Recarregue a planilha. Se você está logado em mais de uma conta Google no navegador, o Google às vezes abre o add-on na conta errada: teste numa janela anônima, só com a conta em que instalou. Para conferir a instalação, abra Extensões > Complementos > Gerenciar complementos.

Assinei o Pro, mas o painel ainda mostra Grátis

Clique em Já assinei no painel. O Pro libera sozinho quando a compra foi feita com o mesmo e-mail da sua conta Google (o painel mostra qual é). Se você comprou com outro e-mail, o painel abre o campo Vincular compra: informe o código do pedido, que está no recibo da Kiwify, e o e-mail usado na compra. Se mesmo assim não liberar, escreva para contato@vendilha.com.br com os dois e-mails e o código do pedido.

A sincronização automática parou

Ela para se a assinatura Pro terminou, se o add-on foi desinstalado ou desativado nesta planilha, ou se você revogou alguma permissão no Google. Abra o painel e ative a sincronização automática de novo.

Uma venda de hoje não aparece no Resumo

O Resumo conta a venda no mês em que ela foi aprovada. Boleto e Pix aguardando pagamento aparecem na aba Vendas, mas só entram no Resumo depois de aprovados.

Um valor não bate com o painel da Kiwify

Clique na célula do Resumo e veja a fórmula: ela soma as colunas da aba Vendas. Confira se o período e a moeda são os mesmos do painel. Se ainda assim divergir, mande para contato@vendilha.com.br o mês, o produto e os dois valores.

Quero anotar coisas na aba Vendas

Use colunas à direita da última coluna preenchida pelo add-on. Elas são preservadas a cada sincronização. Não renomeie nem apague as abas e colunas criadas pela Vendilha.

Como desconectar ou desinstalar

Para apagar suas credenciais: Extensões > Vendilha > Abrir painel e Desconectar conta. Para remover o add-on: Extensões > Complementos > Gerenciar complementos. Para revogar a chave na Kiwify: apague a API Key em Apps > API.

Segurança: detalhes técnicos

A Vendilha é um add-on do Google Apps Script. O código roda na sua conta Google, não num servidor nosso.

Onde fica a sua chave

client_secret, client_id e account_id são gravados nas propriedades de usuário do add-on (PropertiesService.getUserProperties()), que pertencem só a você. Quem recebe a planilha compartilhada vê as vendas, mas não lê nem usa a sua chave. O token de acesso temporário da Kiwify fica no cache do seu usuário por até 6 horas.

Endereços que o add-on chama na Kiwify

Todas em https://public-api.kiwify.com. O cliente da API tem uma lista fechada de rotas permitidas: qualquer chamada que não seja GET de consulta (por exemplo, reembolso ou saque) é bloqueada antes de sair, e um teste automatizado falha se alguém tentar liberar uma dessas rotas.

O que vai para o servidor da Vendilha

Só o seu e-mail Google, para responder se o seu plano é Grátis ou Pro. Nenhuma venda, nenhum dado de comprador e nenhuma credencial da Kiwify.

Permissões pedidas ao Google

• spreadsheets.currentonly: só a planilha em que o add-on está aberto, não o seu Drive.
• script.container.ui: menu e painel lateral.
• script.external_request: falar com a API da Kiwify e com o serviço de licença.
• script.scriptapp: sincronização automática de hora em hora, só se você ativar.
• userinfo.email e openid: identificar a sua licença.

Mais detalhes na Política de Privacidade.

Contato

E-mail: contato@vendilha.com.br. Respondemos em dias úteis. Para pedidos sobre seus dados pessoais (LGPD), use o mesmo endereço.