API

Webhook לטפסים

כל פנייה מטופס באתר נשלחת אוטומטית גם למערכת אחרת: CRM, Make, Zapier או מערכת שפיתחתם בעצמכם.

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

1. איפה מגדירים

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

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

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

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

2. POST או GET

POST (JSON) - מומלץ. כל פרטי הפנייה נשלחים בגוף הבקשה, בפורמט JSON, ולא צריך לכתוב דבר בכתובת עצמה. זו השיטה שמתאימה ל-Make, ל-Zapier ולרוב מערכות ה-CRM. לדוגמה:

{
  "formID": "iwoth8z",
  "pageTitle": "צור קשר",
  "name": "ישראל ישראלי",
  "phone": "050-1234567",
  "email": "israel@example.com",
  "fields": [ { "Name": "נושא הפנייה", "Value": "הצעת מחיר" } ]
}

כשהגולש הגיע מקמפיין, נוסף גם utm עם פרטי הקמפיין.

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

https://example.com/lead?name={name}&phone={phone}&email={email}

Coi מחליפה כל {name} בערך שהגולש מילא. אפשר להשתמש גם ב-{pageTitle} (כותרת הדף), ב-{formID} ובפרטי הקמפיין, כמו {utm_source}. שדה שהגולש השאיר ריק יוסר מהכתובת.

3. שמות השדות

לכל שדה בטופס אפשר לתת "שם באנגלית", בעורך הטופס, ליד שם השדה. זה השם שמופיע ב-Webhook, למשל email או phone. בטפסים המוכנים של Coi השמות האלה כבר מוגדרים.

1 ב-POST, שדה עם שם באנגלית נשלח בשם הזה. שדה בלי שם באנגלית נשלח ברשימה fields, עם השם שלו בעברית.

2 ב-GET, אפשר לכתוב בכתובת את השם באנגלית או את שם השדה בעברית, למשל {טלפון}.

השם חייב להיות זהה בדיוק. שמות באנגלית נשמרים באותיות קטנות, ולכן כותבים {email} ולא {Email}.

4. בדיקה ומשלוח חוזר

אחרי ההגדרה, שלחו פנייה מהאתר ובדקו שהיא הגיעה למערכת השנייה.

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

למפתחים: כל Webhook נשלח עם הכותרת X-Coi-Signature, חתימה שמאפשרת לוודא שהבקשה הגיעה מ-Coi. את סוד החתימה מוצאים מתחת לשדה ה-Webhook. הפירוט המלא - בתיעוד של Coi API.
מדיניות פרטיותהצהרת נגישות
Coi בניית אתרים

אנו שומרים על פרטיותכם. באתר נעשה שימוש בעוגיות (Cookies) וכלים דומים לשיפור חוויית הגלישה, התאמת תוכן אישי וניתוח סטטיסטי. לפרטים נוספים: מדיניות פרטיות