Em Plugins você instala e configura as ferramentas da loja. Cada plugin pede só os dados dele, e o que for sensível, como tokens, fica guardado com criptografia e nunca volta para a tela.

Como instalar#

Escolha o plugin#
Abra Plugins e clique no plugin desejado.
Preencha os campos#
Os campos obrigatórios são conferidos na hora. O painel mostra o que está faltando e os alertas de configuração.
Ative#
Depois de instalado, use o interruptor para ligar e desligar sem perder a configuração.

Para remover um valor sensível salvo, use a opção de limpar o campo. Campo sensível deixado em branco ao salvar continua como estava.

Fiscal#

Spedy#

Emite a nota fiscal de cada venda aprovada, sem digitar nota por nota.

Campo	O que informar
Chave da API	Gere no painel da Spedy.
Ambiente	Produção ou testes. A chave de um ambiente não funciona no outro.
Emissão de notas	Liga e desliga a emissão.
Tipo de nota	NFS-e para serviços, NF-e para produtos, NFC-e para venda presencial.
Usar o CPF/CNPJ do pedido na nota	Quando o pedido tiver documento, ele vai na nota. Sem documento, a nota sai sem identificar o comprador.
Enviar a nota por e-mail ao comprador	Envio pela Spedy.
Descrição na nota	Opcional. Sem ela, a nota lista os itens do pedido.

Campos extras de cada tipo de nota:

Tipo	Campos
NFS-e	Código do serviço (LC 116), código do serviço no município e alíquota do ISS, todos opcionais.
NF-e e NFC-e	Natureza da operação, NCM, CFOP, CSOSN do ICMS, CST do PIS e CST do COFINS são obrigatórios. Forma da venda e venda do meu estado são opcionais.
NFC-e	Exige também a confirmação de que o seu contador validou o uso em venda online.

Produto digital costuma ser serviço, mas quem define é o seu contador. A NF-e exige o endereço do comprador, então ligue Endereço nas opções do checkout.

A Spedy salva mesmo incompleta, para você configurar aos poucos. A nota só começa a sair quando não falta nada e a emissão está ligada.

Marketing#

Facebook Pixel#

Campo	O que informar
ID do Pixel	Número do seu pixel no Gerenciador de Eventos.
Token Pixel API	Opcional e recomendado. Envia as compras também pelo servidor, com a Conversions API.
Código de teste	Só para validar em Eventos de teste. Remova depois.

TikTok Pixel#

Campo	O que informar
TikTok Pixel ID	ID do pixel no TikTok Ads.
Token do TikTok Pixel	Opcional e recomendado. Envia as compras também pelo servidor, com a Events API.
Código de teste	Só para validar em Test Events. Remova depois.

Google ADS#

Campo	Exemplo
Conversion ID	`AW-11450274581`
send_to	`AW-11450274581/AbCDeFGhIjKLMnOPqR`

O send_to precisa começar com o Conversion ID.

Google Merchant#

Envia os produtos da loja ao Google Shopping por um link de feed.

Campo	O que informar
ID da categoria do Google	O ID numérico da taxonomia do Google, não o nome.
Verificação do site	Opcional: o conteúdo da meta tag `google-site-verification`.

Depois de instalar, o painel mostra o link do feed para colar no Merchant Center. Só produtos públicos entram no feed.

Utmify#

Envia cada venda aprovada à Utmify para rastrear as campanhas. Informe o API Token.

Atendimento#

Crisp, Tawk.to e Chatwoot estão indisponíveis no momento: não dá para instalar nem configurar, e a loja não carrega o chat deles. Quem já tinha um deles instalado continua com a configuração guardada.

Para atender os clientes, use o chat próprio da plataforma.

Quem usa bots de vendas da Promisse Apps pode trazer os produtos deles para a loja: veja Discord e bots.

Métricas e relatórios#

Plugin	Campo	Exemplo
Google Tag Manager	Container ID	`GTM-1W7Z93VW`
Google Analytics	Measurement ID (GA4)	`G-RZF28PXYU2`

Acompanhar os envios#

Cada venda paga gera um envio separado para os plugins que trabalham pelo servidor: Facebook e TikTok com token, Utmify e Spedy. Se um falhar, os outros seguem normalmente.

O histórico do plugin mostra o pedido e o resultado de cada envio:

Status	O que significa
Pendente	Na fila.
Enviado	O destino aceitou. Na Spedy, significa aceita para emissão.
Falhou	Não foi possível enviar, ou a nota foi recusada. O motivo aparece no histórico.
Ignorado	Não se aplica, como pedido com CNPJ em NFC-e.

Plugins