# REST API ל-CRM עם webhooks חתומים | AiCrm

> CRM עם REST API ציבורי: יוצרים ושולפים אנשי קשר עם כותרת X-Api-Key, עד 20 מפתחות לכל אינטגרציה ו-webhooks יוצאים חתומים ב-HMAC-SHA256. הוספת לידים מהאתר בלי כפילויות.

- **מקור (source):** https://aistohire.com/he/aicrm-crm-pshot-am-api-lnihol-lkochot-vlidim-109/f/api-rest-crm-webhooks-chatumim
- **פלטפורמה (platform):** AIstoHire
- **שפה (language):** he

## בקצרה

- REST API ציבורי עם כמה מפתחות API ו-webhooks חתומים
- הוסיפו לקוחות מהאתר, מהטופס או מהבק־אנד בקריאת HTTP אחת, וקבלו כל שינוי בשרת שלכם חתום ב-HMAC-SHA256.
- הוספת אנשי קשר בקריאה אחת
- בלי כפילויות בעיצוב
- עד 20 מפתחות עם שם

## REST API ציבורי עם כמה מפתחות API ו-webhooks חתומים

AiCrm, אפליקציית ה-CRM של AIsToHire, חושפת REST API ציבורי על אנשי הקשר שלך עצמך. עם מפתח בכותרת `X-Api-Key` אפשר ליצור, לרשום, לשלוף, לעדכן ולמחוק אנשי קשר, ולהוסיף פעילויות לכל אחד מהם, מטופס האתר, מצ'אטבוט, מ-Zap, מסקריפט Python או מהבק־אנד שלך. התשובות הן JSON בצורת `{ success, data }`, והמגבלה היא 100 בקשות לדקה לכל מפתח.

ההוספה דרך ה-API לא משכפלת: אם האימייל ששולחים כבר קיים במסד שלך, AiCrm מעדכנת את הכרטיס שכבר היה לך (משלימה את הטלפון, השם או החברה שחסרו, מאחדת את התוויות) ורושמת שליחה חדשה בציר הזמן שלו, ומחזירה HTTP 200; אם הוא חדש, היא יוצרת אותו ומחזירה 201. כל איש קשר שנכנס דרך ה-API מתויג אוטומטית כ-`api-lead`, שומר את התוויות ששולחים ושומר את ה-`subId` של המקור, בנוסף למדינה, ל-IP ולדפדפן שממנו הגיע.

אפשר להחזיק עד 20 מפתחות API עם שם משלהם, בנוסף למפתח הפנימי של האפליקציה. כך נותנים מפתח שונה לכל אינטגרציה — האתר, טופס הקמפיין של מאי, המתמחה, הספק — ומבטלים אותו לבדו כשהאינטגרציה הזו מסתיימת, בלי לגעת בשאר. הערך המלא של מפתח מוצג פעם אחת בלבד, ביצירה; אחר כך רואים אותו רק מוסתר ברשימה.

בכיוון ההפוך, ה-webhooks מודיעים למערכות שלך. מגדירים עד 10 יעדים, בוחרים לאילו אירועים כל אחד נרשם (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`) ו-AiCrm שולחת POST ל-URL שלך עם הכותרות `X-AiCrm-Event` ו-`X-AiCrm-Signature: sha256=…`, חתימת HMAC-SHA256 של הגוף עם הסוד של אותו webhook, כדי שתוכל לוודא שהמשלוח לגיטימי. בשמירת ה-URL, הגנת anti-SSRF דוחה localhost, 127.0.0.0/8, 10.x, 192,168.x, 172.16-31.x, ::1, 0.0.0.0 ואת הדומיינים `.local` ו-`.internal`.

## מה כלול

- **הוספת אנשי קשר בקריאה אחת** — POST אל `/api/apps/public/crm/customers` עם האימייל והתוויות שרוצים, והליד כבר ב-CRM שלך, מסווג.
- **בלי כפילויות בעיצוב** — אם האימייל כבר קיים, הכרטיס מתעדכן והשליחה החדשה נרשמת בציר הזמן שלו במקום ליצור כרטיס שני.
- **עד 20 מפתחות עם שם** — אחד לכל אינטגרציה, ניתנים לביטול בנפרד. אם מפתח דולף, מוחקים אותו ושום דבר אחר לא מפסיק לעבוד.
- **Webhooks חתומים ב-HMAC-SHA256** — מאמתים את הכותרת `X-AiCrm-Signature` עם הסוד שלך וידועים שההודעה מגיעה מה-CRM שלך ולא מצד שלישי.
- **הגנת anti-SSRF כלולה** — האפליקציה מסרבת לשלוח webhooks אל localhost או אל טווחי רשת פרטיים, כך שאי אפשר להשתמש ב-CRM שלך כדי לסרוק רשת פנימית.
- **CRUD מלא, לא רק הוספות** — רשימה עם עימוד ומסננים (חיפוש, מצב, תוויות, מדינה), שליפת איש קשר עם הפעילות שלו, עדכון, מחיקה ורישום פעילויות עבורו.
- **המקור נרשם אוטומטית** — כל הוספה דרך ה-API שומרת את ה-`subId` ששולחים בתוספת המדינה, ה-IP והדפדפן, ומתויגת כ-`api-lead` כדי לסנן אותה אחר כך באפליקציה.
- **בדיקות בלי ניחושים** — האפליקציה מגיעה עם תיעוד של ה-endpoints עם דוגמת `curl` שאפשר להעתיק וכפתור לשליחת משלוח ניסיון לכל webhook, עם המצב והשעה של הניסיון האחרון.

## שאלות נפוצות

### איך יוצרים איש קשר ב-CRM מהאתר שלי?

שולחים POST אל `/api/apps/public/crm/customers` עם הכותרת `X-Api-Key` ו-JSON עם לפחות האימייל או הטלפון. אפשר לשלוח גם שם, טלפון, חברה, מדינה, מצב, הערות, תוויות ו-`subId` כדי לזהות את הקמפיין או הטופס שממנו הגיע. AiCrm מחזירה 201 אם היא יוצרת ו-200 אם איש הקשר כבר היה קיים.

### מה קורה אם אותו אימייל נכנס פעמיים דרך ה-API?

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

### כמה מפתחות API אפשר לקבל והאם אפשר לבטל רק אחד?

אפשר ליצור עד 20 מפתחות עם שם משלהם, בנוסף למפתח הפנימי של האפליקציה, שאי אפשר למחוק. כל מפתח נמחק בנפרד, כך שאפשר לתת מפתח שונה לכל אינטגרציה ולבטל אותו בלי להשפיע על השאר. הערך המלא מוצג רק ברגע היצירה; אחר כך הוא מופיע מוסתר ברשימה. כל המפתחות חולקים את המגבלה של 100 בקשות לדקה לכל מפתח.

### איך אני מאמת שה-webhook באמת מגיע מה-CRM שלי?

כל משלוח נושא את הכותרת `X-AiCrm-Signature: sha256=<firma>`, שהיא ה-HMAC-SHA256 של גוף הבקשה המדויק באמצעות הסוד שהאפליקציה מציגה לך ביצירת ה-webhook. מחשבים את ה-HMAC הזה בשרת שלך על הגוף שהתקבל ומשווים. בנוסף נשלחת הכותרת `X-AiCrm-Event` עם שם האירוע: `customer.created`, `customer.updated`, `customer.deleted` או `activity.created`.

### מה קורה אם ה-endpoint של ה-webhook שלי מושבת?

המשלוח הוא best-effort: AiCrm ממתינה עד 5 שניות ואם נכשל היא מנסה שוב אחרי שנייה וחצי. אין תור קבוע של ניסיונות חוזרים, ולכן השבתה ארוכה של השרת שלך עלולה לגרום לאובדן הודעות; במקרה כזה מסנכרנים עם GET אל `/api/apps/public/crm/customers`. האפליקציה מציגה את המצב והשעה של הניסיון האחרון של כל webhook ואפשר להפעיל משלוח ניסיון מתי שרוצים.

- [AiCrm — מערכת CRM קלה עם API להוספת לקוחות מכל מערכת](https://aistohire.com/he/aicrm-crm-pshot-am-api-lnihol-lkochot-vlidim-109)

## על הפלטפורמה

**AiCrm — מערכת CRM קלה עם API להוספת לקוחות מכל מערכת** — אפליקציה של AIstoHire. זמין ב־: https://aistohire.com/he/aicrm-crm-pshot-am-api-lnihol-lkochot-vlidim-109/f/api-rest-crm-webhooks-chatumim

### שפות נוספות

- `es`: https://aistohire.com/es/aicrm-crm-ligero-con-api-109/f/api-rest-crm-webhooks-firmados
- `en`: https://aistohire.com/aicrm-lightweight-crm-with-api-109/f/api-rest-crm-signed-webhooks
- `fr`: https://aistohire.com/fr/aicrm-crm-leger-avec-api-109/f/api-rest-crm-webhooks-signes
- `it`: https://aistohire.com/it/aicrm-crm-leggero-con-api-109/f/api-rest-crm-webhook-firmati
- `pt`: https://aistohire.com/pt/aicrm-crm-leve-com-api-109/f/api-rest-crm-webhooks-assinados
- `de`: https://aistohire.com/de/aicrm-leichtes-crm-mit-api-109/f/api-rest-crm-signierte-webhooks
- `bg`: https://aistohire.com/bg/aicrm-lesen-crm-s-api-za-upravlenie-na-klienti-i-liydove-109/f/rest-api-crm-podpisani-uebhukove
- `ja`: https://aistohire.com/ja/aicrm-lightweight-crm-with-api-109/f/crm-rest-api-signed-webhooks
- `nl`: https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109/f/rest-api-crm-ondertekende-webhooks
- `ko`: https://aistohire.com/ko/aicrm-api-gyeongnyang-crm-109/f/crm-rest-api-seomyeong-webhook
- `sv`: https://aistohire.com/sv/aicrm-enkelt-crm-med-api-for-att-hantera-kunder-och-leads-109/f/rest-api-crm-signerade-webhooks
- `da`: https://aistohire.com/da/aicrm-enkelt-crm-med-api-til-at-styre-kunder-og-leads-109/f/rest-api-crm-signerede-webhooks
- `ar`: https://aistohire.com/ar/aicrm-nzam-crm-bsit-ma-api-lidara-alamla-walamla-almhtmlin-109/f/crm-rest-api-webhooks
- `no`: https://aistohire.com/no/aicrm-enkelt-crm-med-api-for-a-styre-kunder-og-leads-109/f/rest-api-crm-signerte-webhooks
- `fi`: https://aistohire.com/fi/aicrm-yksinkertainen-crm-rajapinnalla-asiakkaille-ja-liideille-109/f/crm-rest-api-allekirjoitetut-webhookit
- `zh`: https://aistohire.com/zh/ai-crm-rest-api-webhooks-109/f/crm-rest-api-webhook
- `pl`: https://aistohire.com/pl/aicrm-prosty-crm-z-api-do-zarzadzania-klientami-i-leadami-109/f/api-rest-crm-podpisane-webhooki
- `cs`: https://aistohire.com/cs/aicrm-jednoduche-crm-s-api-pro-spravu-klientu-a-leadu-109/f/rest-api-crm-podepsane-webhooky
- `id`: https://aistohire.com/id/aicrm-crm-sederhana-dengan-api-untuk-mengelola-pelanggan-dan-lead-109/f/api-rest-crm-webhook-bertanda-tangan
