O pipeline de conversão como um pacote TypeScript.
Tipos de domínio, validação zod, contratos de adaptadores, fila e outbox, parsing de atribuição e upload de conversão offline atrás de um único handler. Você cuida da UI; o SDK cuida dos trilhos.
- Pacote publicado: @vizuh/apointoo-sdk, versionado com changelog
- Contratos de adaptadores para booking, notificação, persistência, estado, auditoria, dedup, rate limiting e conversão
- Roda em rotas do Next.js, Cloudflare Workers e servidores Node
Monte um handler
createBookingHandler devolve um app Hono. Monte em /api/booking e seu fluxo de agendamento existe: validação, regras de agenda, estado, notificações.
Analise a atribuição uma vez
Helpers de GCLID, fbclid e UTM normalizam o contexto do clique na captura, então todo evento posterior referencia os mesmos identificadores.
Confirme resultados, envie conversões
Quando o resultado real acontece, o confirm envia pela fila e pelo outbox. As conversões offline chegam ao Google Ads com valor e horário. Falhas tentam de novo; os logs guardam comprovantes.
import { createBookingHandler } from '@vizuh/apointoo-sdk/server'
import { directConfirmAdapter } from '@vizuh/apointoo-sdk/adapters/booking/direct-confirm'
export const app = createBookingHandler({
config: { /* your tenant config */ },
booking: directConfirmAdapter(),
state: memoryStateStore(),
})
// Mount under /api/booking: Next.js route, Worker, Node serverQual runtime é necessário?
Qualquer um que rode Hono: Node 18+, Cloudflare Workers, Deno, Bun. Rotas de API do Next.js são o padrão documentado.
Preciso usar todos os adaptadores?
Não. Adaptadores são contratos; traga sua própria implementação para qualquer slot ou use os que já vêm.
Onde fica a referência?
Na página de Developers, com exemplos de montagem, confirmação e envio de conversões.