לקוחות

נהל את המשתמשים החייבים בתשלום באפליקציה שלך. עיין בלקוחות בלשונית Dashboard > Commerce > Customers או דרך ה-SDK.

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

לשונית Customers

פתח את Dashboard > Commerce ועבור ללשונית Customers כדי לראות את כל הלקוחות החייבים בתשלום עבור האפליקציה הנוכחית. כל שורה מציגה:

• אימייל
• שם מלא
• מתי נוצרו

חיפוש וסינון לפי אימייל או תאריך יצירה זמינים דרך ה-SDK; פקדים עשירים יותר בפאנל בדרך.

SDK

import Proyecta from '@proyecta-ai/sdk';
const proyecta = new Proyecta({ apiKey: process.env.PROYECTA_API_KEY });

יצירה

const customer = await proyecta.commerce.customers.create({
    email: 'alice@example.com',
    name: 'Alice Liddell',
    phone: '+14155551234', // E.164 format
    address: {
        line1: '123 Wonderland Ave',
        city: 'San Francisco',
        state: 'CA',
        postal_code: '94110',
        country: 'US',
    },
});

קריאה

// Single customer
const customer = await proyecta.commerce.customers.get({ customerId: 'cus_123' });

// Paginate
const result = await proyecta.commerce.customers.list({ limit: '20' });
for (const customer of result.data) {
    console.log(customer.name, customer.email);
}

עדכון

await proyecta.commerce.customers.update({ customerId: 'cus_123', email: 'new@example.com', address: { ... } });

תבניות נפוצות

יצירת לקוח Proyecta כאשר משתמש נרשם

When a new user finishes signup, call proyecta.commerce.customers.create
with their email and name. Store the returned id on the user record as
proyecta_customer_id.

בניית ממשק ניהול לקוחות

Build an admin page at /admin/customers that lists every Proyecta customer
with their email, name, created date, and a link to view their detail page.
Use proyecta.commerce.customers.list to paginate through all customers.

שאלות נפוצות

האם כדאי ליצור לקוח Proyecta לכל משתמש, או רק לאלה שמשלמים?

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

האם לקוח יכול להחזיק מספר מנויים?

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

כיצד אני רואה למה לקוח מנוי?

כיום: דרך לוח המחוונים המוטמע של Stripe או על ידי קריאה ל-commerce.check() עבור כל פיצ’ר שמעניין אותך. תצוגת היסטוריית המנויים בפאנל נמצאת ב-roadmap.