איסוף פרטי לקוח: קישור הרשמה וטיוטה דרך API

מה עושה קישור ההרשמה?#

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

שולחים קישור ומסיימים את קליטת הלקוח#

1. פתחו לקוחות → יצירת קישור הרשמה ללקוח.
2. בחרו שפה אם האפשרות מוצגת. אנגלית זמינה כש־מטבע חוץ ומסמכים באנגלית פעיל. לחצו יצירת קישור.
3. בדקו את מועד התוקף. שתפו דרך העתקת קישור, אימייל או WhatsApp עם הלקוח המתאים.
4. אחרי שהלקוח מילא את הטופס, חזרו לטיוטת ההרשמה בלקוחות, בדקו את פרטיו ושמרו את כרטיס הלקוח. זהו איסוף פרטים, ולא רישום לחוג או שמירת מקום. להזמנת פעילות שולחים את אתר העסק או קישור למפגש.

הקמת טיוטת לקוח דרך API#

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

אפשר גם לקלוט פרטים מטופס באתר שלכם: שרת האתר שולח POST /customer-drafts עם מפתח API בעל הרשאת customers:write ועם כותרת Idempotency-Key. הפעולה מכינה טיוטת הרשמה; הצוות בודק ומשלים אותה מתוך הלקוחות ושומר את כרטיס הלקוח. מפתח ה־API נשמר בשרת האתר בלבד ואינו נשלח לדפדפן. המפתח לבקשה החוזרת הוא מזהה בן 16–100 אותיות אנגליות, ספרות, מקפים או קווים תחתונים. שומרים אותו לפני השליחה ומשתמשים באותו מזהה ובאותם פרטים אם התשובה אבדה. פרטים שונים באותו מזהה מחזירים שגיאת התנגשות; הרשמה חדשה דורשת מזהה חדש. אין איחוד אוטומטי לפי אימייל או מספר עסק. POST /customers הוא מסלול אחר שמקים לקוח ישירות, בלי הבטחת בקשות חוזרות כללית. לקוח לא פעיל אינו טיוטה. השדה registration_draft_id משלים טיוטה קיימת באותו עסק. תיעוד לקוחות וספקים למפתחים מפרט שדות, הרשאות ותשובות.

קישור שפג או כבר נוצל#

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