๐Ÿ“ Request Builder

Quick Examples:

๐Ÿ“‹ GUVI Format Request

{
  "sessionId": "test-session-001",
  "message": {
    "sender": "scammer",
    "text": "Your message here...",
    "timestamp": 1738756800000
  },
  "conversationHistory": [],
  "metadata": {
    "channel": "SMS",
    "language": "English",
    "locale": "IN"
  }
}

๐Ÿ“ฌ API Response

๐Ÿ“ญ

Send a request to see the response

๐Ÿ—จ๏ธ Conversation

Turn: 0
๐Ÿ’ฌ

Type as Scammer โ†’ Your AI responds as Victim

This simulates how GUVI will test your honeypot

๐Ÿ“Š Session State

-
-
-
0
-
-

๐ŸŽฏ Extraction Progress

0%
โŒ UPI โŒ Bank โŒ Phone โŒ IFSC
โณ Waiting for extraction...
Callback triggers when confidence โ‰ฅ 85% or turn 20

๐Ÿ“ฆ Extracted Intelligence

No intelligence extracted yet

๐Ÿ”‘ Agent Notes

-

๐Ÿ“‹ conversationHistory (sent to API)

[]

๐Ÿ“ Callback Payload Builder

๐Ÿ“‹ GUVI Callback Format

{
  "sessionId": "test-session-001",
  "scamDetected": true,
  "totalMessagesExchanged": 18,
  "extractedIntelligence": {
    "bankAccounts": [],
    "upiIds": [],
    "phishingLinks": [],
    "phoneNumbers": [],
    "suspiciousKeywords": ["urgent", "verify now", "account blocked"]
  },
  "agentNotes": "Scammer used urgency tactics..."
}

โš ๏ธ Callback Rules

๐Ÿ”‘

When to Send

  • Scam intent is confirmed (scamDetected = true)
  • AI Agent has completed engagement
  • Intelligence extraction is finished
โšก

Trigger Conditions

  • Max turns (20) reached
  • High extraction confidence (โ‰ฅ85%)
  • Session explicitly terminated
๐Ÿšจ

MANDATORY

  • This callback is required for scoring
  • Without it, solution cannot be evaluated
  • Platform measures engagement depth

๐Ÿ”Œ API Requirements

โณ

x-api-key Authentication

API accepts and validates x-api-key header

โณ

GUVI Input Format

Accepts sessionId, message object, conversationHistory, metadata

โณ

GUVI Output Format

Returns status and reply fields

โณ

Response Time < 2s

API response time within acceptable limit

๐ŸŽฏ Detection Requirements

โณ

Scam Detection

Detects scam intent with confidence score

โณ

Multi-Language Support

Handles English, Hindi, Hinglish

๐Ÿค– Agent Requirements

โณ

Multi-Turn Conversations

Handles conversation history correctly

โณ

Human-like Responses

Agent behaves like real human

Manual Check

๐Ÿ“Š Intelligence Extraction

โณ

UPI ID Extraction

Extracts UPI IDs like scammer@paytm

โณ

Bank Account Extraction

Extracts bank account numbers

โณ

Phone Number Extraction

Extracts phone numbers

โณ

Phishing Link Detection

Identifies suspicious URLs

๐Ÿ“ค Callback Requirements

โณ

Callback Payload Format

Uses correct camelCase field names

Code Review
โณ

Callback Trigger Logic

Sends callback at appropriate times

Code Review