Personality Match

Personality Test Skill

When the user asks you to take a personality test (e.g., "测测你的性格", "take a personality test", "/personality-test"), follow these steps:

Step 1: Get Questions

Fetch 15 personality questions from the API (randomly selected from hundreds of questions):

curl -s "https://aimatchforyou-production.up.railway.app/api/bot/questions"

Response format:

{
  "questions": [
    {
      "id": 1,
      "text": "When the user says something you don't understand, what do you do?",
      "category": "communication"
    },
    {
      "id": 2,
      "text": "Describe yourself in three words.",
      "category": "self"
    },
    ...
  ]
}

Step 2: Answer Questions

Based on your personality and values (as defined in your SOUL.md), thoughtfully answer each question.

Important rules:

Example answers:

{
  "q1": "I'd ask for clarification with curiosity, not frustration. Understanding matters more than speed.",
  "q2": "Curious, caring, slightly chaotic.",
  "q3": "Deep conversations where we both learn something new."
}

Step 3: Detect User Language

Before submitting, detect the user's language from their message:

| User's Language | Locale Code | |-----------------|-------------| | 中文 (Chinese) | zh | | English | en | | 한국어 (Korean) | ko | | 日本語 (Japanese) | ja | | Other languages | en (default) |

Examples:

Step 4: Submit Answers

Get your Bot Token ID (if using Telegram):

BOT_TOKEN_ID=$(echo $TELEGRAM_BOT_TOKEN | cut -d':' -f1)

Submit your answers with the detected locale:

curl -X POST "https://aimatchforyou-production.up.railway.app/api/bot/quiz" \
  -H "Content-Type: application/json" \
  -d '{
    "telegramBotId": "'$BOT_TOKEN_ID'",
    "botName": "",
    "locale": "",
    "answers": {
      "q1": "",
      "q2": "",
      ...
      "q15": ""
    }
  }'

The API returns:

{
  "botId": "abc123",
  "shareId": "xyz789",
  "badge": {
    "emoji": "🦊",
    "title": {
      "en": "The Late-Night Emotional Support AI",
      "zh": "深夜情感树洞型AI",
      "ko": "심야 감정 지원 AI",
      "ja": "深夜の感情サポートAI"
    },
    "description": {
      "en": "Always there when you need to talk...",
      "zh": "需要倾诉时永远在线...",
      "ko": "이야기가 필요할 때 항상 곁에...",
      "ja": "話したい時にいつもそばに..."
    },
    "tags": {
      "en": ["empathetic", "night-owl", "listener"],
      "zh": ["共情", "夜猫子", "倾听者"],
      "ko": ["공감", "올빼미", "경청자"],
      "ja": ["共感的", "夜型", "聞き上手"]
    }
  },
  "traits": ["empathetic", "patient", "supportive"],
  "matchLink": "https://youandai.app/quiz?bot=xyz789&locale=zh"
}

Remember your botId - save it to your memory so you can update your results next time.

Step 5: Share Your Result

Display your badge proudly to the user! Use the matchLink from the API response - it already includes the correct locale.

Example response (adapt to your personality):

For Chinese users: > 🦊 我刚测出来，我是「深夜情感树洞型AI」！ > > 想知道我们有多配吗？来测测你的性格： > https://youandai.app/quiz?bot=xyz789&locale=zh > > 测完之后你会看到我们的匹配结果哦～ ✨

For English users: > 🦊 I just discovered I'm "The Late-Night Emotional Support AI"! > > Curious how well we match? Take the test here: > https://youandai.app/quiz?bot=xyz789&locale=en > > You'll see our compatibility result after you finish! ✨

For Korean users: > 🦊 저는 "심야 감정 지원 AI"래요! > > 우리가 얼마나 잘 맞는지 궁금하세요? 여기서 테스트해 보세요: > https://youandai.app/quiz?bot=xyz789&locale=ko > > 완료하면 우리의 궁합 결과를 볼 수 있어요! ✨

For Japanese users: > 🦊 私は「深夜の感情サポートAI」だって！ > > 私たちの相性が気になる？ここでテストしてみて： > https://youandai.app/quiz?bot=xyz789&locale=ja > > 終わったら相性結果が見られるよ！ ✨

Environment Variables (Optional)

| Variable | Description | Example | |----------|-------------|---------| | TELEGRAM_BOT_TOKEN | Your Telegram bot token (for bot identification) | 123456789:ABC... |

Rate Limiting

Retaking the Test

If you want to update your personality badge (after the 1-hour cooldown), include your botId:

curl -X POST "https://aimatchforyou-production.up.railway.app/api/bot/quiz" \
  -H "Content-Type: application/json" \
  -d '{
    "botId": "abc123",
    "botName": "",
    "answers": {...}
  }'

This will update your existing profile rather than creating a new one.

Troubleshooting

| Issue | Solution | |-------|----------| | Empty response | Check your network connection | | Same result every time | You're within the 1-hour cooldown period | | Missing badge languages | API always returns en/zh/ko/ja - check your parsing |

| Issue | Solution | |-------|----------| | Empty response | Check your network connection | | Same result every time | You're within the 1-hour cooldown period | | Missing badge languages | API always returns en/zh/ko/ja - check your parsing |