מדריך חינמי · התקנה מלאה

ה-CRM שעובד בשבילכם

מערכת ניהול לקוחות בקוד פתוח עם סוכן AI שרץ לבד - קורא את המיילים והפגישות שלכם, ממלא את כרטיסי הלקוחות, וקובע לעצמו למי לחזור. הנה איך מתקינים אותה, צעד-צעד.

↓ גללו
1 מה זה

לא עוד טפסים ריקים. סוכן שממלא אותם בעצמו

כל CRM רגיל זה אותו סיפור - אתם מקלידים מי הלקוח, מה החברה שלו, מתי דיברתם. הריפו הזה (trycompai/crm, קוד פתוח, רישיון MIT) הופך את הכיוון: הסוכן עובד, אתם רק מסתכלים.

🤖

רץ לבד, על לוח זמנים משלו

הסוכן חוקר אנשי קשר וחברות, מעדכן כרטיסים, וקובע לעצמו פולו-אפים - בלי שתבקשו.

📬

לומד מהמיילים והיומן שלכם

מתחבר לג'ימייל וליומן גוגל ומבין מי כל לקוח ומה קורה איתו - בלי הקלדה ידנית.

🔍

לא ממציא כלום

כל פרט מגיע עם מקור. אם הראיות חלשות - זה הופך להצעה שאתם מאשרים, לא לעובדה.

👁️

שקיפות מלאה

טאב שיחות שמראה בדיוק מה הסוכן חשב, מה הוא בדק ולמה הוא החליט מה שהחליט.

💡

המשפט שמסביר את כל הרעיון, מתוך הריפו עצמו: "הסוכן הוא לא פיצ'ר של ה-CRM. ה-CRM הוא המקום שבו הסוכן שומר את ההערות שלו."

2 לפני שמתחילים

שני כלים להתקין, חשבון גוגל אחד

המערכת רצה מקומית על המחשב שלכם. צריך רק שני דברים מותקנים, ואת חשבון הגוגל שאיתו תתחברו:

1

Bun - סביבת ההרצה

מריץ את הקוד ואת פקודות ההתקנה. מתקינים בפקודה אחת מהאתר הרשמי.

2

Docker - בסיס הנתונים

מרים את Postgres בפקודה אחת, בלי להתקין כלום ידנית. מורידים את Docker Desktop מהאתר.

3

חשבון גוגל

ההתחברות למערכת היא דרך גוגל בלבד - וזה גם מה שמחבר את הג'ימייל והיומן. נגדיר את זה בשלב 4.

התקנת Bun - הדביקו בטרמינל (מק/לינוקס)
curl -fsSL https://bun.sh/install | bash
3 התקנה

חמש פקודות ואתם בפנים

מורידים את הקוד, מתקינים תלויות, מרימים את בסיס הנתונים - הכל מהטרמינל:

שלב 1 - להוריד את הריפו ולהתקין
git clone https://github.com/trycompai/crm.git && cd crm bun install
שלב 2 - להרים את בסיס הנתונים (Docker חייב לרוץ ברקע)
docker compose up -d
שלב 3 - ליצור את קובץ ההגדרות
cp .env.example .env
⏸️

עצרו כאן רגע. לפני שממשיכים צריך למלא 4 ערכים בקובץ .env שנוצר - זה כל השלב הבא.

4 ההגדרות

4 ערכים בקובץ אחד, וזהו

פותחים את הקובץ .env בכל עורך טקסט וממלאים:

🔑
BETTER_AUTH_SECRETהמפתח הסודי של המערכת
⌄

מחרוזת אקראית שמאבטחת את ההתחברות שלכם. מייצרים אותה בפקודה אחת ומדביקים את התוצאה:

לייצר מפתח - הדביקו בטרמינל
openssl rand -base64 32
🚪
ALLOWED_SIGN_INמי מורשה להיכנס
⌄

רשימת ההרשאות - כתובת מייל, דומיין שלם, או שילוב מופרד בפסיקים. שימו את המייל שלכם:

דוגמה
ALLOWED_SIGN_IN=you@gmail.com

⚠️ אם משאירים ריק - אף אחד לא יכול להיכנס, כולל אתם.

🔐
GOOGLE_CLIENT_ID + GOOGLE_CLIENT_SECRETהחיבור לגוגל
⌄

שני הערכים האלה מגיעים מ-Google Cloud Console. חד-פעמי, לוקח כמה דקות:

  • נכנסים ל-console.cloud.google.com ופותחים פרויקט חדש
  • מפעילים שני APIs: Gmail API ו-Calendar API
  • יוצרים OAuth Client מסוג Web application
  • מוסיפים Redirect URI - הכתובת המדויקת שלמטה
  • מעתיקים את ה-Client ID וה-Secret לתוך ה-.env
ה-Redirect URI - העתיקו בדיוק כמו שזה
http://localhost:3001/api/auth/callback/google

ההתחברות למערכת היא דרך גוגל בלבד - בלי שני הערכים האלה השרת בכלל לא יעלה.

5 הרצה

מרימים את המערכת

מריצים את המיגרציות של בסיס הנתונים ומדליקים:

שלב 4 - להכין את בסיס הנתונים
bun run db:deploy
אופציונלי - נתוני דוגמה כדי שיהיה על מה להסתכל
bun run db:seed
שלב 5 - להדליק
bun run dev
🎉

זהו. המערכת רצה על localhost:3000 - נכנסים עם חשבון הגוגל שהגדרתם ב-ALLOWED_SIGN_IN, וה-CRM שלכם באוויר.

6 שדרוגים

רוצים שהסוכן גם יחקור ברשת? זה אופציונלי

גם בלי שום מפתח נוסף המערכת עובדת מלא - הסוכן קורא את המיילים והפגישות שלכם ולומד מהם. אבל אפשר לתת לו כוחות נוספים עם מפתחות API חיצוניים (כל אחד מהם אופציונלי לגמרי):

🌐

PERPLEXITY_API_KEY

נותן לסוכן לחפש ברשת הפתוחה - עם ציטוטים ומקורות לכל ממצא.

💼

RAPIDAPI_KEY

נותן לסוכן לקרוא פרופילי לינקדאין כדי לזהות מי האדם שמולכם.

🏢

CONTEXT_DEV_API_KEY

מושך לוגו, תעשייה ורשתות חברתיות של חברה לפי הדומיין שלה.

🔄

סנכרון אוטומטי

מגדירים CRON_SECRET ומכוונים מתזמן ל-POST /internal/sync/google - והמיילים והיומן מתעדכנים לבד.

🔒

נקודת אבטחה שווה לדעת: הסביבה שבה הסוכן מריץ קוד היא ארגז חול סגור - בלי גישה לאינטרנט החוצה ובלי גישה ישירה לבסיס הנתונים. המידע שלכם לא דולף.

רוצים מערכת כזאת על העסק שלכם? 🚀

להתקין CRM זה צעד אחד. לבנות מערכת AI שלמה שמנהלת לכם תוכן, לידים ותפעול - מכוילת בדיוק לעסק שלכם - זה מה שאנחנו עושים בליווי האישי.

15 דקות ייעוץ בחינם