Skip to main content

Visão geral

O objetivo da ClubFix é que a integração com nossa API seja a mais simples possível para qualquer stack técnica. Este roadmap descreve as ferramentas que estão sendo planejadas para reduzir a fricção de adoção por parceiros B2B.

SDK Node.js

Status: Planejado Um pacote NPM oficial para integração com a API ClubFix em projetos Node.js e TypeScript.

O que estará disponível

Funcionalidades previstas

  • Autenticação automática com renovação de token
  • Tipagem completa (TypeScript)
  • Retry com backoff exponencial em erros 5xx
  • Logging configurável
  • Suporte a ESM e CommonJS

SDK PHP

Status: Planejado Um pacote Composer para integração nativa em projetos PHP, com suporte dedicado ao Laravel.

Instalação via Composer

Uso standalone (PHP puro)

Integração Laravel via ServiceProvider

O pacote incluirá um ClubfixServiceProvider para configuração automática no Laravel:

Funcionalidades previstas

  • Facade Clubfix:: para uso rápido no Laravel
  • Suporte a Eloquent models opcionais (sincronização de assinaturas)
  • Eventos Laravel (SubscriptionCreated, InstallmentPaid, etc.)
  • Compatível com PHP 8.1+, Laravel 10 e 11

Conector n8n

Status: Planejado Um Community Node oficial para n8n, permitindo que parceiros montem fluxos de automação com a API ClubFix sem escrever código.

Casos de uso

  • Checkout integrado: ao receber um pedido no WooCommerce/Shopify, criar automaticamente uma assinatura ClubFix e notificar o cliente
  • Cobrança recorrente: integrar com Asaas, Pagar.me ou Stripe e notificar a ClubFix quando o pagamento mensal for confirmado
  • Sincronização de CRM: criar clientes na ClubFix a partir de leads convertidos no HubSpot ou Pipedrive
  • Alertas de vencimento: monitorar parcelas pendentes e disparar notificações via WhatsApp ou e-mail

Nodes planejados

Exemplo de fluxo n8n


Próximas capacidades da API

Além das ferramentas de SDK, as seguintes capacidades da API estão no horizonte:

Interesse ou sugestões?

Se você tem interesse em algum destes itens ou quer sugerir prioridades, entre em contato com o time de parceiros ClubFix: