איך מחברים את עצה טובה למערכות אחרות (API ו-Webhooks)

ה-API של עצה טובה עושה מבחוץ את מה שאתה עושה בתוך המערכת: יוצר הצעה מתבנית, מעדכן אותה, מפיק PDF ומייצר קישור ללקוח. ה-Webhooks עובדים בכיוון ההפוך — כשמשהו קורה להצעה, עצה טובה שולחת הודעה לכתובת שהגדרת. התיעוד המלא למפתחים, באנגלית, נמצא בכתובת etza-tova.com/developers.

באיזה מסלול זה זמין

API ו-Webhooks הם חלק ממסלול הכל באחד (₪149 לחודש). מפתח שנוצר בחשבון במסלול אחר יקבל תשובת שגיאה בשם upgrade_required — כלום לא נשבר, פשוט צריך לשדרג.

שלב 1 — יוצרים מפתח API

בתוך המערכת, שלושה צעדים:

• נכנסים ל"מפתחות API" מתפריט ההגדרות.
• לוחצים "צור מפתח חדש", נותנים לו שם (למשל "Make") ובוחרים אילו הרשאות הוא מקבל — קריאה או כתיבה על הצעות, תבניות, לקוחות ו-Webhooks.
• מעתיקים את המפתח מיד. הוא מוצג פעם אחת בלבד; אם אבד, מבטלים אותו ויוצרים חדש.

שלב 2 — מה אפשר לעשות עם המפתח

ארבעה דברים, וכולם בנויים ועובדים היום:

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

שלב 3 — Webhooks: לקבל עדכון כשמשהו קורה

רושמים כתובת (URL) ובוחרים אילו אירועים לקבל. ארבעה אירועים נשלחים היום, ורק הם:

• deal.viewed — הלקוח פתח את קישור ההצעה.
• deal.accepted — הלקוח אישר את ההצעה.
• deal.status_changed — סטטוס ההצעה השתנה (טיוטה, הופק, נשלח, נצפה, אושר).
• job.stage_changed — שלב העבודה אחרי האישור זז (בתהליך, מוכן, נמסר), או שהלקוח אישר קבלה.

כל הודעה חתומה (HMAC) כדי שתוכל לוודא שהיא באמת מעצה טובה, ואם הכתובת שלך לא ענתה — ננסה שוב, עד חמישה ניסיונות בסך הכול.

Make, Zapier ודומיהם

אין כרגע אפליקציה של עצה טובה בחנויות של Make או Zapier. מתחברים דרך המודולים הכלליים שלהם — "HTTP" ב-Make או "Webhooks by Zapier" ב-Zapier — עם המפתח שיצרת. מדריך צעד-אחר-צעד לשניהם נמצא בעמוד Integrations בתיעוד למפתחים.