Docs/API Reference/A/B Testing
DashboardGitHub

O módulo de A/B testing permite testar diferentes abordagens de cobrança (tom de mensagem, horário de envio, estratégia de desconto) e medir qual variante gera mais pagamentos. Os resultados incluem significância estatística via z-test.

Endpoints

#
MétodoEndpointDescrição
POST/api/experimentsCriar experimento A/B
GET/api/experimentsListar experimentos
GET/api/experiments/:id/resultsResultados com z-test estatístico
PATCH/api/experiments/:id/startIniciar experimento
PATCH/api/experiments/:id/pausePausar experimento
PATCH/api/experiments/:id/completeCompletar e declarar vencedor
POST/api/experiments/:id/assign/:debtIdAtribuir dívida a variante
ℹ️

Todos os endpoints requerem autenticação via JWT (Authorization: Bearer TOKEN).

Criar experimento

POST/api/experiments

Cria um novo experimento A/B com nome, descrição, variantes (A e B) e métrica de sucesso (taxa de pagamento, tempo de resposta, etc.).

Listar experimentos

GET/api/experiments

Retorna todos os experimentos do cliente, com status (DRAFT, RUNNING, PAUSED, COMPLETED) e resumo de cada variante.

Resultados do experimento

GET/api/experiments/:id/results

Retorna os resultados detalhados do experimento: taxa de conversão por variante, z-score, p-value e indicação de significância estatística (p < 0.05).

Iniciar experimento

PATCH/api/experiments/:id/start

Altera o status para RUNNING. Novas dívidas elegíveis serão distribuídas aleatoriamente entre as variantes.

Pausar experimento

PATCH/api/experiments/:id/pause

Pausa a distribuição de novas dívidas. Conversas em andamento continuam normalmente.

Completar experimento

PATCH/api/experiments/:id/complete

Encerra o experimento e declara a variante vencedora com base nos resultados estatísticos.

Atribuir dívida a variante

POST/api/experiments/:id/assign/:debtId

Atribui manualmente uma dívida a uma variante específica do experimento. Útil para testes controlados.