REST API ו-webhooks

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

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

ה-CRM שלך מפסיק להיות מקום שצריך להיכנס אליו כדי לכתוב: הוא הופך ל-endpoint שהמערכות שלך קוראות אליו.

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`.

היתרונות של REST API ו-webhooks

הוספת אנשי קשר בקריאה אחת

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, עם המצב והשעה של הניסיון האחרון.

Claire Donovan

חברו את האתר שלכם ל-CRM כבר הערב

AiCrm היא כלי ה-CRM של AIsToHire שמקבל את אנשי הקשר שלכם דרך REST API ומודיע למערכות שלכם עם webhooks חתומים. פתחו חשבון, צרו מפתח ובצעו את הקריאה הראשונה.

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