#Renovação
Há dois momentos: antes de vencer (convencer a renovar) e quando renova (agradecer e atualizar datas).
#Antes de vencer (régua)
Estes avisos vêm do fluxo kb_access e saem da varredura diária, não na hora de uma venda (pergunte à KB o horário em que ela roda):
| Evento | Quando | O que fazer |
|---|---|---|
access.renewal_window_opened | A varredura passa pela data da janela (renewal_window_at). Plano que renova sozinho na plataforma não abre janela. | Começar a régua de renovação. |
access.renewal_reminder | Cada toque do plano. Padrão (renewal_reminder_days vazio): 60, 45, 30, 15, 7, 3 e 1 dia antes do fim. | Mensagem daquele ponto. Use data.reminder.days_left: a de 60 dias é diferente da de 1 dia. |
access.winback_reminder | Depois que acabou: campanhas de volta. | "Sentimos sua falta" com oferta. Pare se vier access.reactivated. |
Regras da régua:
- Cada toque sai uma vez por assinatura e ciclo.
- Não sai em rajada: um toque por data, mesmo que a varredura fique dias sem rodar.
- Renovou? A régua recomeça para o fim novo. Concessão de tempo ou ajuste do fim também refazem a conta.
#Quando a pessoa renova
Uma renovação paga gera dois avisos, em dois fluxos:
| Fluxo | Evento | Significa |
|---|---|---|
payments | payment.approved | O dinheiro entrou (é uma venda nova, com sale_key nova). |
platform_subscriptions | subscription.renewed | A assinatura da plataforma renovou. |
kb_access | access.renewed | O acesso foi estendido. data.previous.ends_at é o fim de antes, data.object.ends_at o novo. |
Não conte a renovação duas vezes. Escolha o evento de cada finalidade:
- Para o financeiro (receita):
payment.approved. - Para acesso e CRM (nova data de fim):
access.renewed. subscription.renewed: só registrar.
Ao receber access.renewed: agradeça, pare a régua de renovação, atualize a data de fim no CRM e na área de membros.
#Reativação (voltou depois de acabar)
access.reactivated sai quando há pagamento válido depois do fim (mais a tolerância). Começa um período novo:
- é a mesma assinatura (
subject.id), não cliente novo; started_atcontinua sendo o primeiro acesso de todos, eterm_started_atmarca o período novo;- devolva o acesso e dê "bem-vindo de volta".
#Mudança de plano
subscription.plan_changed avisa troca de plano numa assinatura da plataforma. Atualize o plano conforme o corpo. O aviso não traz o cálculo de uma eventual diferença cobrada; não presuma.
#Porém
subscription.renewedpode chegar antes depayment.approved(ordem não garantida).- A renovação de plano que renova sozinho (cartão recorrente) chega como
payment.approvedtodo ciclo, comsale_keynova a cada vez. - Com o tempo real desligado,
access.renewedpode demorar até cerca de um dia.