Guru
Plataforma completa de checkout e gestão de vendas online, que reúne as funções do negócio num só lugar, sem precisar de desenvolvedor.
O Digital Manager Guru é uma plataforma de checkout e gestão de vendas digitais: transações, assinaturas, cupons, afiliados e leads. Este MiniApp abre essa base para o fluxo, e traz junto os eventos de venda e de assinatura — o que permite tanto consultar a situação de um cliente durante a conversa quanto iniciar um atendimento sozinho quando algo acontece na venda.
Site oficial: digitalmanager.guru.
Nota
São necessários dois tokens, ambos na aba API da sua conta Guru: o Token da Conta (Admin Guru > Minha Conta) e o Token do Usuário (Minha Conta > Tokens API).
Ao instalar o app no canal, preencha os campos abaixo. Eles valem para todas as ações.
Campo
Obrigatório
Observação
Token da Conta
Sim
Admin Guru > Minha Conta, aba API.
Token do Usuário
Sim
Minha Conta > Tokens API.
Cada ação é um bloco que você usa dentro do fluxo. As entradas listadas são as obrigatórias; as saídas viram variáveis para as etapas seguintes.
Ação
O que faz
Entradas obrigatórias
Saídas
Recuperar um Contato (Filtros)
Procura o contato por documento, e-mail ou nome.
—
ID do Contato, Nome do Contato, Telefone, Endereço
Recuperar um Contato (ID)
Traz o contato pelo ID.
ID
Nome do Contato, Telefone, Endereço
Atualizar um Contato
Atualiza cadastro e endereço completo do contato.
ID do Contato, Nome do Contato, E-mail, Código do Telefone, Telefone
Data de Atualização
Anonimizar um Contato
Remove os dados pessoais do contato, mantendo o registro.
ID
—
Listar Transações do Contato
Lista as compras do contato.
ID
ID do Produto, Nome do Produto, Informações de Pagamento
Listar Assinaturas de um Contato
Lista as assinaturas do contato.
ID
Assinaturas
Listar Etickets de um Contato
Lista os e-tickets do contato.
ID
Etickets
Listar Alifiliações do Contato
Lista as afiliações ligadas ao contato.
ID
Afiliações
Recuperar Assinatura
Busca a assinatura por e-mail, nome, documento ou produto.
—
ID da Assinatura, ID do Produto, ID do Marketplace, Nome do Produto, Telefone do Cliente
Cancelar Assinatura
Cancela a assinatura informada.
ID da Assinatura
Status
Adicionar Cupom na Assinatura
Aplica um cupom a uma assinatura ativa.
ID da Assinatura, Código do Cupom
—
Criar Cupom
Cria um cupom com validade, incidência e produtos vinculados.
Código do Cupom, Data de Ínicio, Data de Expiração, Campo de Incidência, Tipo de Incidência, Valor da Incidencia
ID do Cupom
Atualizar Cupom
Altera um cupom existente.
ID do Cupom, Código do Cupom, Data de Ínicio, Data de Expiração, Campo de Incidência, Tipo de Incidência, Valor da Incidencia
—
Recuperar Cupom (ID)
Traz os dados do cupom pelo código.
Código do Cupom
Informações
Recuperar Cupom (Codigo Cupom)
Traz os dados do cupom pelo ID.
ID do Cupom
Informações
Deletar Cupom
Apaga o cupom.
ID do Cupom
—
Recuperar Afiliação
Traz os dados de uma afiliação.
ID da Afiliação
Dados da Afiliação
Listar Recursos da Afiliação
Lista os materiais disponíveis para o afiliado.
ID da Afiliação
Recursos
Atualizar Commissão
Altera o tipo (porcentagem ou valor fixo) e o valor da comissão.
ID da Afiliação, Tipo de Comissão, Valor
Comissão
Obter Lead
Busca leads por período, e-mail e dados de rastreio.
Data Inicial, Data Final da Busca, E-mail do Lead, Último Rastreio do Lead (Data Inicial), Último Rastreio do Lead (Data Final)
Informações do Lead
Link de Acesso (My Orders)
Gera o link que abre a área de pedidos do cliente, com prazo de validade.
E-mail do Contato
Link de Acesso, Data de Validade do Link
Webhook
Processa o conteúdo que o Guru envia ao webhook, separando vendas de assinaturas.
Corpo do Webhook, Tipo de Webhook
—
Além das ações, o app traz gatilhos: eventos que iniciam um fluxo sozinhos quando algo acontece na plataforma. Os dados do evento chegam como variáveis, prontos para usar na primeira mensagem.
Gatilho
Dispara quando
Venda ~ Aprovada
o pagamento é aprovado.
Venda ~ Compra Completa
a compra é concluída.
Venda ~ Aguardando Pagamento
o pedido fica esperando o pagamento (boleto ou PIX emitido).
Venda ~ Abandonada
o comprador desiste no meio do checkout.
Venda ~ Atrasada
o pagamento passa do prazo.
Venda ~ Compra Expirada
o prazo do pedido expira.
Venda ~ Rejeitada
o pagamento é recusado.
Venda ~ Cancelada
a venda é cancelada.
Venda ~ Reembolsada
o valor é devolvido.
Venda ~ Chargeback
o comprador contesta a cobrança junto ao banco.
Assinatura ~ Ativada
uma assinatura passa a valer.
Assinatura ~ Trial
uma assinatura entra em período de teste.
Assinatura ~ Atrasada
a renovação não é paga no prazo.
Assinatura ~ Cancelada
o cliente cancela a assinatura.
Assinatura ~ Inativada
a assinatura deixa de estar ativa.
- Os gatilhos são o coração da integração: separam venda de assinatura e cobrem o ciclo inteiro, do abandono ao chargeback. Cada um pode iniciar um fluxo próprio — recuperar carrinho, lembrar boleto, pedir novo cartão na renovação atrasada, retirar acesso no reembolso.
- Link de Acesso (My Orders) resolve o pedido mais comum do suporte — "onde vejo minha compra?" — sem senha: o bot devolve um link direto. Ele expira, e a data de validade vem junto na resposta.
- Quase toda consulta parte do ID do contato. O caminho normal é achar o contato por e-mail ou documento uma vez, guardar o ID num campo e reusar nas ações seguintes.
- Anonimizar um Contato existe para pedidos de LGPD: apaga os dados pessoais sem destruir o histórico de transações.
- No cupom, campo de incidência diz sobre o que o desconto incide (produtos, envio ou total) e tipo de incidência diz se é valor fixo ou porcentagem.
- NicoApps (MiniApps) Nativos — a lista completa de integrações prontas