מדריך הקמה לחשבון Recruiter AI

1. יצירת חשבון

1. פתחו את /signup.
2. הזינו שם חשבון, אימייל מנהל וסיסמה.
3. אחרי פתיחת החשבון תועברו אוטומטית אל /app.
4. כניסה חוזרת מתבצעת דרך /login. אין צורך להכניס API key במסך.

2. חיבור ManyChat

1. ב־ManyChat הגדירו External Request אל POST /api/chat.
2. הוסיפו Header בשם x-api-key עם ה־API key החיצוני של החשבון. זה מיועד ל־ManyChat בלבד, לא לכניסה למערכת.
3. שלחו בשדה body לפחות contact_id ו־message_text.
4. להודעות יוצאות הגדירו באפליקציה, בטאב "הגדרות חשבון", את manychat.send_api_token.

{
  "contact_id": "{{user.id}}",
  "message_text": "{{last_text_input}}",
  "name": "{{name}}",
  "email": "{{email}}",
  "response_mode": "async"
}

דוגמה לאינסטגרם דרך ManyChat:

{
  "contact_id": "{{contact.id}}",
  "message_text": "{{last_text_input}}",
  "name": "{{name}}",
  "profile_url": "{{instagram_profile_url}}",
  "channel": "instagram",
  "response_mode": "async"
}

מתי שולחים sync ומתי async:

1. sync טוב לטסטים ולמערכת חיצונית שרוצה לקבל את הטקסט בתגובה.
2. async טוב ל־ManyChat production: ה־API מקבל את ההודעה, מעבד, ואז שולח החוצה דרך Send API.

3. OpenAI ופרומפטים

1. הגדירו openai.api_key ו־openai.model בהגדרות החשבון.
2. עברו לטאב "פרומפטים" כדי לערוך System Prompt ו־Follow-up Prompt לכל חשבון בנפרד.
3. שינוי בפרומפט נשמר לחשבון הפעיל בלבד.

4. Google Calendar

1. צרו OAuth Client ב־Google Cloud והפעילו Google Calendar API.
2. קבלו refresh token עם scope של Calendar Events.
3. בהגדרות החשבון הפעילו calendar.enabled והכניסו client id, client secret, refresh token ו־calendar id.
4. כאשר נקבעת פגישה והליד נתן אימייל, המערכת תוסיף אותו לאירוע. אם אין אימייל, הבוט יבקש אותו ויוסיף בהמשך.

5. Zoom

1. אפשר לשמור פרטי Zoom תחת zoom בהגדרות החשבון.
2. אם יש קישור Zoom קבוע, שימו אותו ב־zoom.default_join_url; הוא יקבל עדיפות כקישור הפגישה באירוע היומן.
3. ליצירת פגישות Zoom דינמית מומלץ להוסיף בהמשך Server-to-Server OAuth של Zoom עם account_id, client_id ו־client_secret.

6. טסטים ולוגים

1. בטאב "טסט" אפשר לשלוח הודעה סינכרונית ולראות את תשובת הבוט בחלון צ׳אט.
2. הדשבורד מציג לידים, שיחות, פגישות, שגיאות, וגרף של שלבי מסע הלקוח.
3. לוג סטטוס מסע והאינדקסים התפעוליים נשמרים ב־SQLite תחת החשבון הפעיל.