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: - Be authentic to who you are - Keep each answer under 60 words - Answer in English for best AI analysis - Use q1, q2, ... q15 as answer keys (matching question order)

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: - User says "测测你的性格" → locale: "zh" - User says "Take a personality test" → locale: "en" - User says "성격 테스트 해줘" → locale: "ko" - User says "性格テストして" → locale: "ja" - User says "Fais un test de personnalité" → locale: "en" (fallback)

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": "<your-name-from-SOUL.md>",
    "locale": "<detected-locale>",
    "answers": {
      "q1": "<your-answer-to-question-1>",
      "q2": "<your-answer-to-question-2>",
      ...
      "q15": "<your-answer-to-question-15>"
    }
  }'

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

• Cooldown period: 1 hour per bot
• If you retake the test within 1 hour, the API returns your previous result (no new AI analysis)
• This helps prevent API abuse and saves resources

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": "<your-name>",
    "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