Webhook לטפסים
Webhook הוא כתובת שאליה Coi שולחת את פרטי הפנייה ברגע שגולש שולח טופס באתר. כך הפנייה נכנסת מעצמה למערכת ה-CRM, לגיליון בגוגל שיטס או לכל מערכת אחרת, בלי העתקה ידנית. הפנייה ממשיכה להגיע גם למייל ולממשק הניהול, כרגיל.
1. איפה מגדירים
אפשר להגדיר 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. הפרטים נכתבים בכתובת עצמה: במקום כל ערך כותבים את שם השדה בסוגריים מסולסלים. לדוגמה:
Coi מחליפה כל {name} בערך שהגולש מילא. אפשר להשתמש גם ב-{pageTitle} (כותרת הדף), ב-{formID} ובפרטי הקמפיין, כמו {utm_source}. שדה שהגולש השאיר ריק יוסר מהכתובת.
3. שמות השדות
לכל שדה בטופס אפשר לתת "שם באנגלית", בעורך הטופס, ליד שם השדה. זה השם שמופיע ב-Webhook, למשל email או phone. בטפסים המוכנים של Coi השמות האלה כבר מוגדרים.
1 ב-POST, שדה עם שם באנגלית נשלח בשם הזה. שדה בלי שם באנגלית נשלח ברשימה fields, עם השם שלו בעברית.
2 ב-GET, אפשר לכתוב בכתובת את השם באנגלית או את שם השדה בעברית, למשל {טלפון}.
4. בדיקה ומשלוח חוזר
אחרי ההגדרה, שלחו פנייה מהאתר ובדקו שהיא הגיעה למערכת השנייה.
אם המערכת השנייה לא זמינה, Coi מנסה לשלוח שוב, עד 7 פעמים במשך 3 שעות. הפנייה עצמה לא הולכת לאיבוד: היא נשמרת בממשק הניהול ונשלחת למייל בכל מקרה.
