Como Adicionar Videochamada ao Seu SaaS e Cobrar por Isso

Exemplo de payload do webhook session.ended:

{
  "event": "session.ended",
  "data": {
    "sessionId": "sess_abc123",
    "projectId": "proj_xyz789",
    "duration": 1847,
    "participants": [
      {
        "id": "part_001",
        "name": "Dr. Silva",
        "duration": 1847,
        "metadata": {
          "clientId": "seu-cliente-id-123",
          "planId": "pro"
        }
      },
      {
        "id": "part_002",
        "name": "Paciente Maria",
        "duration": 1802,
        "metadata": {
          "clientId": "seu-cliente-id-123"
        }
      }
    ],
    "recording": true,
    "transcription": true
  },
  "timestamp": "2026-03-05T14:30:00Z"
}

Exemplo: Processando webhook e reportando uso ao Stripe

// Endpoint para receber webhooks do videochamada.com.br
app.post('/webhooks/videochamada', async (req, res) => {
  const { event, data } = req.body;

  if (event === 'session.ended') {
    // 1. Calcular minutos-participante totais
    const totalMinutes = data.participants.reduce(
      (sum, p) => sum + Math.ceil(p.duration / 60), 0
    );

    // 2. Identificar o cliente (via metadata)
    const clientId = data.participants[0]?.metadata?.clientId;

    // 3. Buscar plano do cliente
    const client = await db.clients.findById(clientId);
    const plan = await db.plans.findById(client.planId);

    // 4. Calcular excedente (se modelo hibrido)
    const currentUsage = await db.usage.getMonthTotal(clientId);
    const newTotal = currentUsage + totalMinutes;
    const overage = Math.max(0, newTotal - plan.includedMinutes);

    // 5. Reportar uso ao Stripe (metered billing)
    if (overage > 0) {
      await stripe.subscriptionItems.createUsageRecord(
        client.stripeSubscriptionItemId,
        {
          quantity: totalMinutes,
          timestamp: Math.floor(Date.now() / 1000),
          action: 'increment',
        }
      );
    }

    // 6. Salvar registro de uso
    await db.usage.create({
      clientId,
      sessionId: data.sessionId,
      minutes: totalMinutes,
      recording: data.recording,
      transcription: data.transcription,
      date: new Date(),
    });
  }

  res.status(200).json({ received: true });
});