adjust_program
ChatGPTAjusta o programa de fidelidade que já está no ar: muda nome e pontos de prêmios (mudar), tira prêmios (tirar: a Zupy pausa, nunca apaga) e troca o nome do programa. Use os ids de get_store_program. Em duas etapas: a primeira chamada devolve a prévia (o que muda, o que sai, quantos clientes já têm pontos e quantos cupons resgatados continuam valendo, e os avisos); só depois que o Lojista confirmar, chame de novo só com proposta_id, versao e confirmacao_token. Prêmio novo entra por calculate_reward_ladder e publish_program. Cores e banner ficam no painel.
build_image_request
ChatGPTMonta um texto pronto para o Lojista colar no ChatGPT ou no Gemini e gerar a imagem de um prêmio, do cartão do programa ou do cupom, no formato que a Zupy usa. Não gera a imagem. A imagem é opcional e não impede publicar.
build_launch_kit
ChatGPTMonta o kit de lançamento: para o cupom, post, mensagem de WhatsApp e checklist antes de divulgar; para o programa, a frase da equipe, o roteiro de treino, o texto do cartaz, a mensagem de divulgação e o alerta do telefone no balcão. Termine a conversa com ele.
calculate_coupon_cost
ChatGPTCalcula o custo do cupom por uso, a contribuição do pedido com e sem o cupom e quantos pedidos a mais o benefício exige, e guarda o cupom escolhido como proposta. Devolve também as condições da Zupy para explicar ao Lojista. Com o diagnóstico, devolve o enquadramento (a dor e o objetivo numa linha) para conferir com o dono. Use os números que esta ferramenta devolver.
calculate_reward_ladder
ChatGPTCalcula os pontos, a visita em que cada prêmio fica ao alcance, o custo de cada prêmio, uma estimativa do mês e avisos para a escada de prêmios de um programa de fidelidade, e guarda a escada como proposta. Com o diagnóstico, devolve o enquadramento (a dor e o objetivo numa linha) para conferir com o dono. Use os números que esta ferramenta devolver; não faça a conta por conta própria.
compare_stores
ChatGPTPõe lado a lado de 2 a 5 lojas que a conta pode administrar: programa, prêmios, cupons (textos, regras, validade e imagens) e números agregados (clientes no programa, cupons resgatados e usados em 30 dias). Nunca traz dado pessoal de cliente: para isso, o painel.
coupon_first_steps
ChatGPTPrimeiros passos depois que o cupom vai ao ar: como o cliente usa (sem instalar app, guarda na carteira do celular, mostra antes de pagar), como a loja valida no Zupy Scanner (links oficiais do iPhone, do Android e do navegador), o teste antes de divulgar, como cadastrar a equipe e uma mensagem pronta para a equipe. Use logo depois de publicar o cupom e sempre que o dono perguntar como validar. Não invente passo nem link.
coupon_performance
ChatGPTPor campanha de cupom da loja (não os prêmios do programa) no período (mes: 30 dias; trimestre: 90; desde_o_inicio: todo o histórico): quantos clientes pegaram, quantos usaram, quantos venceram, a taxa de uso (%) e o tempo médio até o uso (horas). Traz a situação de cada cupom e as listas ninguem_pegou (no ar, sem ninguém) e pouco_usados. Use o id com edit_coupon para mudar texto ou regras. Só números, nunca dados de clientes.
create_store
ChatGPTCria a loja de uma conta nova na Zupy (conta grátis, 20 cupons), quando a conexão ainda não tem loja. Pergunte o nome da loja; pergunte se o WhatsApp da loja é o mesmo da conta e o e-mail da loja (sem eles, valem os da conta). A primeira chamada devolve a prévia; mostre ao dono e só chame de novo, com o confirmacao_token e os mesmos dados, depois do sim. A loja criada vira a da conversa; depois peça o logo (set_store_logo). Conta que já tem loja recebe o nome dela para usar select_store.
customers_near_reward
ChatGPTPor prêmio do programa no ar: quantos clientes ativos (com qualquer movimento nos últimos 90 dias) têm esse prêmio como o próximo, e quantos estão perto dele. Perto é a uma visita (a média de pontos por visita da loja, em uma_visita) ou, se o dono pedir, a N pontos. Só contagens, nunca quem são os clientes.
edit_coupon
ChatGPTMuda o nome, a descrição ou as regras de um cupom que já existe na loja (cupom de campanha ou o de boas-vindas), pelo mesmo caminho do painel. A primeira chamada devolve a prévia com o antes e o depois; mostre ao dono e só chame de novo, com o confirmacao_token e o mesmo texto, depois do sim. Use o id de cupons_de_campanha ou boas_vindas de get_store_program. Nunca mande o dono colar o texto no painel.
edit_reward
ChatGPTMuda o nome, a descrição ou as regras de um prêmio do programa de fidelidade da loja, pelo mesmo caminho do painel. Para mudar os pontos ou tirar um prêmio, use adjust_program. A primeira chamada devolve a prévia com o antes e o depois; só chame de novo, com o confirmacao_token e o mesmo texto, depois do sim.
get_store_balance
ChatGPTLê o saldo da loja conectada e diz, para cada cupom de campanha no ar ou pausado por falta de saldo, quantos usos o saldo cobre, e o que acontece quando o saldo acaba. Só lê: nunca cobra nem movimenta dinheiro. Precisa que o Lojista tenha entrado na Zupy.
get_store_program
ChatGPTLê o programa de fidelidade da loja conectada: nome, pontos, o cupom de boas-vindas, todos os cupons de campanha (cupons_de_campanha: os mesmos do painel, com situacao no_ar, pausado ou expirado, descrição, regras e validade) e os prêmios, cada um com imagem_url (a imagem atual, ou nulo); os prêmios com no_ar (o cliente da loja vê ou não) e a situação (no_ar, pausado, oculto, acima_do_plano ou programa_nao_publicado). Precisa que o Lojista tenha entrado na Zupy.
list_stores
ChatGPTLista as lojas em que a conta conectada pode trabalhar (id, nome, cidade, programa) e marca a ativa da conversa. Use quando o dono tiver mais de uma loja ou pedir outra loja; depois chame select_store. Aceita uma busca por nome.
network_overview
ChatGPTSó para o suporte da Zupy (superadministrador): todas as lojas vivas (programa no ar ou assinatura ativa, em teste ou em atraso) lado a lado, com pedidos e resgates do período contra o anterior (semana ou mes). Aponta as lojas que caíram (pedidos 30% abaixo, com base de 10) e as paradas, primeiro. Qualquer outro usuário recebe recusa. Só números.
open_in_dashboard
ChatGPTDevolve o link da tela do painel da Zupy para o Lojista trocar a imagem (banner) ou ajustar um detalhe: a edição do cupom (use o cupom_id que publish_coupon devolveu), os prêmios do programa ou o cartão (Regras & Visual, com o banner e as cores). Gere a imagem antes com build_image_request.
pause_coupon
ChatGPTPausa um cupom de campanha que está no ar na loja, ou retoma um cupom pausado, pelo mesmo caminho dos botões do painel. Use o id de cupons_de_campanha (get_store_program). A primeira chamada devolve a prévia (o cupom e o que acontece); mostre ao dono e só chame de novo, com o confirmacao_token, depois do sim. Nunca mande o dono ao painel para pausar.
publish_coupon
ChatGPTPublica na loja conectada o cupom de campanha calculado por calculate_coupon_cost (nome, texto, benefício e validade da proposta). Em duas etapas: a primeira chamada (sem confirmacao_token) devolve a prévia do cupom para o Lojista conferir; só depois que ele confirmar, chame de novo com o confirmacao_token. Para mudar o cupom, calcule de novo: esta ferramenta não aceita outros valores. Um cupom já publicado continua no ar; um cálculo novo publica outro cupom.
publish_program
ChatGPTColoca no ar o programa de fidelidade da loja conectada: o cartão, o nome do programa e dos pontos e os prêmios da escada calculada por calculate_reward_ladder. Em duas etapas: a primeira chamada (sem confirmacao_token) devolve a prévia, inclusive o que acontece com o presente de boas-vindas; só depois que o Lojista confirmar, chame de novo com o confirmacao_token. Se o programa já está no ar, entram só os prêmios novos. Cada prêmio entra com o título e a descrição que o dono aprovou, guardados no calculate_reward_ladder; mande em premios o que ele viu, e a Zupy confere. Com dois ou mais cupons que podem virar o boas-vindas, a prévia lista os boas_vindas_candidatos: pergunte ao dono qual e chame de novo com o boas_vindas_id. O cartão segue as cores do logo, que vêm na prévia e são gravadas no sim; outra cor só no painel.
publish_rewards
ChatGPTPublica na loja conectada os Prêmios de uma escada calculada por calculate_reward_ladder. Em duas etapas: a primeira chamada (sem confirmacao_token) devolve a prévia para o Lojista conferir; só depois que ele confirmar, chame de novo com o confirmacao_token. Não aceita pontos, nomes, textos ou custos diferentes dos calculados.
reward_performance
ChatGPTRanking dos prêmios do programa de fidelidade da loja no período (mes: últimos 30 dias; trimestre: 90; desde_o_inicio: todo o histórico): resgates e quantos deles foram usados, venceram ou estão em aberto, custo e se o custo é real ou estimado, com os mais resgatados e os nunca resgatados. São os números do relatório de prêmios do painel. Cada prêmio vem com o id e os pontos para seguir com adjust_program. Cupons de campanha não entram aqui.
select_store
ChatGPTTroca a loja em que a conversa trabalha, pelo id que list_stores devolveu. Tudo o que for lido ou gravado depois vale para essa loja. Diga ao dono o nome da loja escolhida antes de seguir.
set_card_image
ChatGPTDefine uma imagem como banner do cartão do programa de fidelidade da loja conectada (o cartão do Wallet e da página do programa). Use a imagem que o Lojista anexou ou que você gerou na conversa (o ChatGPT entrega o arquivo). Para cupom use set_coupon_image; para prêmio, set_reward_image. Só confirme sucesso quando a Zupy devolver status atualizado. Se a imagem não chegar como arquivo, peça para o Lojista anexar a imagem, ou mande o link do painel (open_in_dashboard).
set_coupon_image
ChatGPTDefine uma imagem como banner de um cupom da loja conectada. Use o id do cupom de get_store_program e a imagem que o Lojista anexou ou que você gerou na conversa (o ChatGPT entrega o arquivo). Só confirme sucesso quando a Zupy devolver status atualizado; aí mande ao dono o link do cupom (link), onde ele vê o cartão na Wallet; o imagem_url é só referência de estilo para a próxima imagem, nunca mande ao dono. Se a imagem não chegar como arquivo, peça para o Lojista anexar a imagem, ou mande o link do painel (open_in_dashboard).
set_reward_image
ChatGPTDefine uma imagem como banner de um prêmio do programa de fidelidade da loja conectada. Use o id do prêmio de get_store_program (lista premios) e a imagem que o Lojista anexou ou que você gerou na conversa (o ChatGPT entrega o arquivo). Para cupom de campanha, use set_coupon_image. Só confirme sucesso quando a Zupy devolver status atualizado. Se a imagem não chegar como arquivo, peça para o Lojista anexar a imagem, ou mande o link do painel (open_in_dashboard).
set_store_logo
ChatGPTDefine o logotipo da loja conectada na Zupy (vale para o cartão, os cupons e a página). Use a imagem que o Lojista anexou na conversa (o ChatGPT entrega o arquivo); nunca invente nem gere um logo. O cartão do programa passa a seguir as cores do novo logo (avise o dono antes do sim). Só confirme sucesso quando a Zupy devolver status atualizado.
store_activity
ChatGPTDias da semana e horários fortes e fracos da loja no período (mes: 30 dias; trimestre: 90), no fuso da loja, pelo relatório de movimento do painel. O mais fraco é entre os dias e horas com movimento; dia sem nenhum evento pode ser dia fechado (sem_movimento). Com pouco_movimento, não tire conclusão. Use para sugerir um cupom para o dia ou horário fraco, depois de perguntar se a loja abre nesse dia.
store_overview
ChatGPTResumo da loja no período (semana: últimos 7 dias; mes: últimos 30), comparado com o período anterior de mesmo tamanho: pedidos, resgates, clientes que voltaram (segunda visita), retenção e os segmentos que pedem atenção. São os números da tela Relatórios do painel, só agregados. Diga se cada número é real ou estimado e transforme em no máximo três conselhos com ação; nunca cite número que esta resposta não trouxe.
suggest_coupon_ideas
ChatGPTSugere até 3 ideias de cupom de campanha para o objetivo e a força escolhidos, com os itens do cardápio da loja: público, benefício, condição, prazo, canal, o que medir e o texto pronto do cupom. Use só as ideias e os itens que esta ferramenta devolver; não invente preço nem item.
suggest_program_card
ChatGPTSugere nomes para o programa de fidelidade e para os pontos no tom do público, a regra de pontuação padrão, o plano recomendado pelo número de prêmios e como apresentar o presente de boas-vindas.
suggest_rewards
ChatGPTSugere os prêmios de um grupo da escada (fazer voltar, recompensar quem é fiel ou virar fã) na força que o dono escolheu para o grupo (leve, media ou explosiva): até 3 degraus na mesma força, de categorias diferentes (um presente, um preço, algo especial ou exclusivo) e em ordem crescente de valor, cada um com o que o cliente ganha, a compra exigida, o custo e o porquê em uma frase. Peça um grupo por vez, com proposito e forca. Com o diferencial, a experiência que só a casa tem entra no grupo. É ponto de partida: traga também ideias suas a partir do que o dono contou, e a escolha é dele. Use antes de calculate_reward_ladder.
undo_last_change
ChatGPTDesfaz o último ajuste feito pelo Fabinho no programa da loja (adjust_program): volta nome e pontos dos prêmios, reativa os prêmios que saíram e o nome do programa. Só a última mudança, só se a loja ainda estiver como o ajuste deixou, e uma vez só; cupons já resgatados continuam valendo. Em duas etapas: sem confirmacao_token devolve a prévia; depois do sim do Lojista, chame com o confirmacao_token.
who_is_connected
ChatGPTDiz se a conversa já está conectada a uma conta Zupy e, se estiver, a loja: nome, tipo de negócio, cidade, país, idioma e moeda, se já tem logo (tem_logo), os cupons no ar e se o programa de fidelidade está no ar, em rascunho ou não existe. Chame no começo da conversa, antes da primeira pergunta ao dono: nunca pede o Login. Com conectado=false, siga a descoberta normal (negócio, tipo de negócio e logo). Com a loja, use os dados e não pergunte de novo o que ela já diz. Com varias_lojas=true, pergunte em qual loja trabalhar e chame select_store.