התאמת טופס

התאמת מראה הטופס, תוויות וצבעים באמצעות Agent API.

קבלת פרטי טופס

Endpoint: GET /api/agent/form
Headers: Authorization: Bearer sr_live_your_api_key

התגובה כוללת אובייקט form (id, title, description, background_color, button_color, text_color, logo_url, button_text, שדות label ו-placeholder) ואובייקט embed.

עדכון טופס

Endpoint: PUT /api/agent/form
Headers: Authorization, Content-Type: application/json
Body (כל השדות אופציונליים): title, description, background_color, button_color, text_color, logo_url, button_text, field_name_label, field_email_label, field_message_label, field_name_placeholder, field_email_placeholder, field_message_placeholder

תגובה: { "success": true, "form": { ... } }

שדות ניתנים להתאמה

הגדרות ויזואליות

title (מקסימום 100 תווים), description, background_color, button_color, text_color (hex בלי #), logo_url, button_text.

תוויות שדות

field_name_label, field_email_label, field_message_label.

מציין מיקוםs

field_name_placeholder, field_email_placeholder, field_message_placeholder.

שדות מוגנים

לא ניתנים לשינוי דרך ה-API (מתעלמים בשקט): recipient_email, custom_email_domain, custom_email_username, userID, id, created_at.
למה: recipient_email מונע חטיפת הודעות לקוחות; השאר מנוהלים במערכת.

פורמט צבע

Hex בלי סימן #: נכון – "ffffff", "3f3ea2"; לא נכון – "#ffffff", "rgb(...)", "white".

עדכונים חלקיים

אפשר לשלוח רק את השדות שרוצים לשנות; השאר נשארים ללא שינוי.

שיטות עבודה מומלצות

• ניגודיות: רקע בהיר וטקסט כהה; כפתור בניגוד לרקע
• כותרת קצרה (עד 50 תווים), פעולה ברורה
• תיאור קצר (1–2 משפטים)
• טקסט כפתור ברור ("שליחה", "Submit", "צור קשר")

נושאים קשורים

• אפשרויות הטמעה
• תחילת עבודה
• קודי שגיאה