Skip to content

Como Funciona

MIDDAG Account é um hub centralizador. Ele não substitui suas ferramentas existentes. Ele fica por cima delas e as torna coerentes.

O modelo de hub

Seu negócio já usa ferramentas que são boas no que fazem:

  • WooCommerce cuida de produtos, checkout e gestão de pedidos
  • Stripe processa pagamentos e gerencia assinaturas
  • HubSpot rastreia contatos, deals e pipelines de CRM
  • Jira gerencia tickets e projetos

O problema é que nenhuma dessas ferramentas sabe da existência das outras. Um pagamento no Stripe não atualiza automaticamente uma licença. Um pedido no WooCommerce não diz ao HubSpot a que o cliente tem direito. Você acaba consultando múltiplos sistemas para responder uma única pergunta: "A que esse cliente tem acesso?"

O MIDDAG Account resolve isso puxando dados de todas essas ferramentas para uma visão única, organizada em torno de Organizações e Entitlements.

O Entitlement como espinha dorsal

O conceito central é o Entitlement: um código único que significa "Organização X tem acesso ao Produto/Serviço Y."

Quando um cliente compra algo pelo WooCommerce, o MIDDAG Account cria automaticamente um entitlement. Esse entitlement se torna o ponto único de referência para tudo relacionado àquela compra: a licença que ele concede, o contrato que o rege, as faturas que gera, as solicitações de serviço que recebe.

Em vez de verificar o Stripe para status de pagamento, o WooCommerce para detalhes do pedido e uma planilha para chaves de licença, você consulta um único código de entitlement e vê o panorama completo.

Nota: Embora o fluxo típico seja Organização → Entitlement → Recursos downstream, Entitlements não exigem uma Organização. Podem existir standalone para casos como gift cards, acesso promocional, clientes pessoa física (B2C) ou importações de migração. Todas as chaves estrangeiras são opcionais.

O ciclo de vida do entitlement

Todo entitlement segue o mesmo ciclo de vida com quatro estados:

Ativo -- O cliente tem acesso. Os recursos downstream (licenças, ambientes, serviços) estão provisionados e funcionando.

Suspenso -- O acesso está em pausa, geralmente porque um pagamento falhou. O entitlement pode retornar a ativo quando o pagamento for resolvido. Os recursos downstream ficam pausados, mas não são destruídos.

Expirado -- O entitlement atingiu sua data de término sem renovação. Há um período de carência configurável antes que o sistema o mova para cancelado. O cliente ainda pode renovar durante essa janela.

Cancelado -- O acesso está revogado. Os recursos downstream são desprovisionados de acordo com suas policies. Mesmo entitlements cancelados podem ser reativados em cenários de win-back.

O que acontece quando um cliente compra algo

Este é o fluxo típico de ponta a ponta:

  1. O cliente faz um pedido pelo WooCommerce (ou aceita um orçamento no portal).
  2. O pagamento é processado pelo Stripe (ou Banco Inter para Pix/Boleto).
  3. O MIDDAG Account cria um entitlement automaticamente, com base no produto adquirido. O entitlement recebe um código único (como PLG-2026050001) e é vinculado à organização do cliente.
  4. Os recursos downstream são provisionados de acordo com a entitlement class: uma licença de software, um ambiente gerenciado, um contrato de serviço, ou o que o produto conceder.
  5. O entitlement aparece no painel admin (para operadores) e no portal do cliente (para o cliente). Um código, um lugar para consultar.
  6. Quando chega a hora da renovação, o sistema lida com isso de acordo com as policies configuradas: renovação automática, períodos de carência, lembretes e recuperação de pagamentos falhos.

Entitlement classes

Nem todos os produtos são iguais. Uma licença de software funciona de forma diferente de um ambiente de hospedagem gerenciado. As entitlement classes dizem ao sistema que tipo de acesso está sendo concedido e como lidar com ele.

ClasseO que cobreExemplo
PluginLicença de software com ativação por site e downloads"Acme Corp tem licença do Produto X em 3 sites"
EnvironmentAmbiente de hospedagem gerenciado com monitoramento de saúde"Acme Corp tem uma instância Moodle gerenciada"
ServiceServiço ou projeto contínuo com contratos e créditos"Acme Corp tem um plano de suporte com 40 créditos/mês"
OrderEntitlement de compra geral"Acme Corp adquiriu um pacote de treinamento"
AffiliateParticipação em programa de parceiros"Acme Corp é parceiro revendedor"
EducationTreinamento, mentoria ou acesso a cursos"Acme Corp tem acesso ao Workshop Avançado"

As classes são configuráveis pelo painel admin. Você pode ajustá-las para corresponder ao que seu negócio vende.

Policies controlam as regras

Policies são regras configuráveis que governam como os entitlements se comportam. Em vez de codificar lógica de negócio no sistema, você define policies em até cinco níveis:

  1. Global -- Regras padrão para toda a sua instalação
  2. Entitlement Class -- Regras específicas de uma classe (ex.: todos os entitlements de Plugin)
  3. Organização -- Regras específicas de um cliente (ex.: um cliente VIP tem períodos de carência mais longos)
  4. Produto -- Regras específicas de um produto
  5. Entitlement Individual -- Regras para um entitlement específico

O nível mais específico prevalece. Se você definir um período de carência global de 7 dias mas conceder 30 dias a uma organização específica, essa organização terá 30 dias.

As policies cobrem comportamento de renovação, recuperação de pagamento, regras de cancelamento, metas de SLA, períodos de trial, reembolsos, notificações e mais. Consulte Conceitos-Chave para a lista completa.

Seus dados ficam no seu WordPress

Tudo vive no banco de dados do seu WordPress. Se você parar de usar o Stripe, seu histórico de entitlements permanece. Se trocar de CRM, seus registros de organizações continuam lá. O MIDDAG Account puxa dados para dentro; ele não envia seus dados para plataformas externas.

Esse é o modelo de soberania de dados: você é dono dos dados do ciclo de vida dos seus clientes, sempre.