Eduzz
Integração com a plataforma de cursos Eduzz.
A Eduzz é uma plataforma de venda de produtos digitais e cursos. A integração tem duas metades: os gatilhos, que fazem o fluxo começar sozinho a cada acontecimento da fatura ou do contrato, e as ações, que consultam vendas, afiliados e contratos durante a conversa.
Site oficial: www.eduzz.com/pt-br.
Nota
Além das chaves, esta integração exige uma configuração manual do webhook no painel da Eduzz, com um trecho de código no pré-processamento. Veja o passo a passo abaixo.
Ao instalar o app no canal, preencha os campos abaixo. Eles valem para todas as ações.
Campo
Obrigatório
Observação
E-mail da Conta
Sim
O e-mail usado na sua conta Eduzz.
Public Key
Sim
Em orbita.eduzz.com/producer/config-api.
API Key
Sim
No mesmo lugar da Public Key.
Origin Key
Não
No mesmo lugar, quando aplicável.
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
Criar Link com Dados do Comprador e de Campanha
Monta o link de checkout já preenchido com os dados do contato e os parâmetros de campanha.
URL de Checkout
URL Completa
Obter Venda por ID
Traz os dados de uma venda.
ID da Venda
Dados Da Venda (JSON)
Obter Total de Vendas
Soma as vendas de um período informado.
Data de início, Data Final
Desconto de vendas, Ganho no valor de vendas, Ganho líquido de vendas
Obter Vendas dos Últimos Dias
Soma as vendas dos últimos N dias.
Periodo
Desconto de vendas, Ganho no valor de vendas, Ganho líquido de vendas
Obter Afiliado por ID
Traz os dados de um afiliado.
ID do afiliado
Dados do Afiliado (JSON)
Obter Top Afiliados
Lista os afiliados que mais venderam.
—
Dados dos Afiliados (JSON)
Obter Contrato por ID
Traz os dados de um contrato.
ID do contrato
Dados do Contrato (JSON)
Webhook
Processa o conteúdo que a Eduzz envia ao webhook.
Body do 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
Pagamento de Fatura
a fatura é paga. É o gatilho de entrega.
Geração de Fatura
a fatura é emitida.
Aguardando Pagamento de Fatura/Contrato
a fatura fica esperando o pagamento.
Abandono de Carrinho
o comprador desiste no checkout.
Cartão Recusado (Fatura)
o cartão é negado.
Fatura Expirada
a fatura vence sem pagamento.
Fatura/Contrato Expirou
o contrato chega ao fim do prazo.
Cancelamento de Fatura/Contrato
a compra ou o contrato é cancelado.
Fatura Reembolsada
o valor é devolvido — hora de remover o acesso.
Fatura Aguardando Reembolso
o reembolso foi pedido e está em processamento.
Fatura em Disputa
o comprador contesta a cobrança.
Fatura/Contrato Trial
a compra entra em período de teste.
Recuperação de Fatura
uma fatura antes perdida é recuperada.
Análise de Fatura
a fatura entra em análise.
Fatura Aguardando Documentos
falta documentação do comprador.
Processamento de Fatura
a fatura está sendo processada.
Fatura Agendada
a cobrança fica agendada para depois.
Fatura Duplicada
a plataforma detecta duplicidade.
Fatura Deletada
a fatura é apagada.
Contratos e Situações Específicas
eventos de contrato fora dos casos acima.
- A configuração do webhook é manual e tem um passo fácil de esquecer. Em orbita.eduzz.com/producer/webhook, cole no campo de pré-processamento o trecho fornecido pelo app — ele é o que normaliza telefone e e-mail, que a Eduzz manda em nomes de campo diferentes conforme o produto. Depois mapeie
Phonepara$.phone,Emailpara$.emaile o corpo para$.body. - Sem esse pré-processamento os gatilhos até chegam, mas o NicoChat não consegue identificar de qual contato é o evento — é a causa mais comum de "a Eduzz avisou e nada aconteceu".
- São 20 gatilhos, bem mais granulares que o normal. Na prática, a maioria das operações usa quatro: pagamento, abandono, expiração e reembolso. Os demais existem para casos específicos de contrato e disputa.
- As consultas de venda e afiliado devolvem JSON: use um bloco de tratamento para extrair o campo que interessa antes de mostrar ao contato.
- NicoApps (MiniApps) Nativos — a lista completa de integrações prontas