Webhooks

{
  "event": "interview.transcript",
  "data": {
    "meetingCode": "Boooply-AI-1234567890",
    "title": "Senior Frontend Engineer Interview",
    "meetingType": "AI_ONLY",
    "isTeamMeeting": false,
    "candidateName": "Jane Doe",
    "jobRole": "Senior Frontend Engineer",
    "source": "Acme Corp",
    "sourceId": "org_7234567890",
    "sourcePlatform": "AI TalentFlow",
    "transcript": [
      {
        "speaker": "AI Interviewer",
        "text": "Tell me about your experience with React.",
        "startMs": 12400
      },
      {
        "speaker": "Jane Doe",
        "text": "I've been working with React for 5 years...",
        "startMs": 15200,
        "endMs": 28900
      }
    ],
    "transcriptCount": 24,
    "timestamp": "2026-03-21T18:30:00.000Z"
  }
}

{
  "event": "interview.evaluation",
  "data": {
    "meetingCode": "Boooply-AI-1234567890",
    "title": "Senior Frontend Engineer Interview",
    "meetingType": "AI_ONLY",
    "candidateName": "Jane Doe",
    "jobRole": "Senior Frontend Engineer",
    "source": "Acme Corp",
    "sourceId": "org_7234567890",
    "sourcePlatform": "AI TalentFlow",
    "summary": "Jane demonstrated strong technical skills in React and TypeScript...",
    "oneLineSummary": "Strong React skills but needs improvement in system design",
    "overallRating": 3,
    "recommendation": "PASS",
    "confidenceLevel": "HIGH",
    "scores": {
      "overall": 72,
      "communication": 80,
      "technicalSkills": 70,
      "problemSolving": 65,
      "cultureFit": 85,
      "experienceMatch": 70
    },
    "recruiterSummary": { "tldr": "Solid mid-level React developer", "quickDecision": "ADVANCE" },
    "skillsAssessment": [
      { "skill": "React", "rating": 4, "evidence": "Explained hooks and context API well" }
    ],
    "strengthsAndWeaknesses": {
      "strengths": [{ "point": "Strong React fundamentals", "evidence": "..." }],
      "weaknesses": [{ "point": "Limited system design", "evidence": "..." }]
    },
    "redFlags": [{ "flag": "Vague on past projects", "severity": "WARNING", "context": "..." }],
    "positiveSignals": [{ "signal": "Enthusiastic about the role", "context": "..." }],
    "sentimentAnalysis": { "enthusiasm": "HIGH", "authenticity": "GENUINE", "stressLevel": "LOW" },
    "questionsAsked": [
      { "topic": "Technical", "question": "How do you handle state?", "candidateAnswer": "...", "answerQuality": 4, "timestamp": "02:15" }
    ],
    "nextSteps": {
      "recommendation": "Proceed to technical round",
      "questionsToAsk": ["Describe a system you designed"],
      "focusAreasForNextRound": ["System design", "TypeScript generics"]
    },
    "ratingsForRecruiters": { "technicalSkills": 70, "communication": 80, "cultureFit": 85, "overall": 72 },
    "timestamp": "2026-03-21T18:35:00.000Z"
  }
}

{
  "event": "interview.scores",
  "data": {
    "meetingCode": "Boooply-AI-1234567890",
    "candidateName": "Jane Doe",
    "jobRole": "Senior Frontend Engineer",
    "source": "Acme Corp",
    "sourceId": "org_7234567890",
    "sourcePlatform": "AI TalentFlow",
    "overallRating": 3,
    "recommendation": "PASS",
    "confidenceLevel": "HIGH",
    "scores": {
      "overall": 72,
      "communication": 80,
      "technicalSkills": 70,
      "problemSolving": 65,
      "cultureFit": 85,
      "experienceMatch": 70
    },
    "ratingsForRecruiters": { "technicalSkills": 70, "communication": 80, "cultureFit": 85, "overall": 72 },
    "oneLineSummary": "Strong React skills but needs improvement in system design",
    "timestamp": "2026-03-21T18:35:00.000Z"
  }
}

{
  "event": "interview.recording",
  "data": {
    "meetingCode": "Boooply-AI-1234567890",
    "title": "Senior Frontend Engineer Interview",
    "source": "Acme Corp",
    "sourceId": "org_7234567890",
    "sourcePlatform": "AI TalentFlow",
    "duration": 1234,
    "format": "mp4",
    "videoUrl": "https://s3.amazonaws.com/...?X-Amz-Expires=604800&...",
    "videoApiUrl": "https://api.meetings.boooply.com/api/integration/interviews/Boooply-AI-1234567890/recording",
    "timestamp": "2026-03-21T18:40:00.000Z"
  }
}

const crypto = require('crypto');
 
function verifyWebhookSignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(payload))
    .digest('hex');
 
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}
 
// Express example
app.post('/webhooks/boooply', express.json(), (req, res) => {
  const signature = req.headers['x-boooply-signature'];
  const isValid = verifyWebhookSignature(req.body, signature, process.env.BOOOPLY_WEBHOOK_SECRET);
 
  if (!isValid) {
    return res.status(401).send('Invalid signature');
  }
 
  const { event, data } = req.body;
 
  switch (event) {
    case 'interview.evaluation':
      console.log(`Score: ${data.overallRating}/100 — ${data.recommendation}`);
      console.log(`Organization: ${data.sourceId}`); // your org ID
      break;
    case 'interview.transcript':
      console.log(`Transcript: ${data.transcriptCount} messages`);
      break;
    case 'interview.scores':
      console.log(`Technical: ${data.technical}, Communication: ${data.communication}`);
      break;
    case 'interview.recording':
      console.log(`Recording: ${data.videoApiUrl}`);
      break;
  }
 
  res.status(200).send('OK');
});

import hmac
import hashlib
import json
 
def verify_webhook_signature(payload: dict, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(),
        json.dumps(payload, separators=(',', ':')).encode(),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected)