Your AI Connector Docs

שיוך מודעות “קליק לוואטסאפ” (Click-to-WhatsApp)

אם אתה מריץ מודעות “Click to WhatsApp” של Meta (פייסבוק/אינסטגרם), Your AI Connector יכול לומר לך מאיזו מודעה הגיע כל ליד בוואטסאפ — ולספק לך את מזהה הלחיצה של Meta הדרוש לך כדי לדווח על המרות אמיתיות בחזרה ל-Meta. זה מאפשר לקמפיינים הפרסומיים שלך לבצע אופטימיזציה למכירות והזמנות בפועל, ולא רק ל"אנשים שהתחילו צ’אט".

מה נתפס

כאשר מישהו מקיש על מודעת Click-to-WhatsApp ושולח הודעה לעסק שלך, Meta מצרפת מידע הפניה נסתר להודעה הראשונה הזו. Your AI Connector קורא אותו באופן אוטומטי ושומר אותו באיש הקשר. ללא הגדרה, ללא קונפיגורציה — זה פשוט קורה.

המידע שנלכד נשמר באיש הקשר תחת ad_referral ומכיל:

שדה מה זה
ctwa_clid מזהה הלחיצה של Meta. זהו הערך שאתם שולחים ל-Conversions API של Meta כדי לשייך המרה במורד הזרם ללחיצה המדויקת על המודעה. ריק עבור הפניות מפוסטים אורגניים (ראו להלן).
source_id המזהה של המודעה (או הפוסט) שעליה האדם הקיש.
source_type או ad (מודעת “קליק לוואטסאפ” בתשלום) או post (פוסט אורגני בפייסבוק/אינסטגרם).
source_url הקישור המשויך לתוכן המודעה.
headline טקסט הכותרת של המודעה.
body טקסט גוף המודעה.
channel הערוץ שדרכו הגיעה ההפניה (נכון לעכשיו תמיד whatsapp).
captured_at מתי ההפניה תועדה לראשונה באיש הקשר.

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

דבר אחד שהמטען (payload) לא אומר לך: על איזה מהמספרים שלך הגיעה השיחה. אין בו מזהה דף (page id) או מזהה חשבון WhatsApp Business. עם מספר בודד זה לא משנה; אם אתה מפעיל מספרים שונים בדפי פייסבוק שונים, תצטרך למפות זאת בצד שלך.

על איזה חיבור זה עובד

זה עובד על חיבור ה-WhatsApp API הרשמי בלבד. Meta מספקת את מידע ההפניה המובנה (כולל ctwa_clid) רק דרך ה-WhatsApp Business API הרשמי. חיבור ה-WhatsApp (web) הלא-רשמי אינו מקבל אותו — אין נתוני לחיצה על מודעות הזמינים בחיבור הזה, מעצם האופן שבו הוא עובד.

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

התנהגות מגע ראשון

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

העברת הנתונים ל-Meta או ל-Google Ads

Your AI Connector לוכד את נתוני הייחוס וחושף אותם, אך הוא לא דוחף המרות ל-Meta או ל-Google עבורך באופן טבעי כיום. עליך להעביר את הנתונים באמצעות webhooks יחד עם כלי אוטומציה.

האובייקט ad_referral כלול בסעיף contact של אירועי ה-webhook היוצאים (לדוגמה: הודעה חדשה, איש קשר חזר לפעילות, תגיות איש קשר עודכנו, ואירועי אנליטיקה כגון פגישה שנקבעה).

הגדרה טיפוסית למעגל סגור:

  1. ליד לוחץ על מודעת ה-Click-to-WhatsApp שלך ושולח לך הודעה. Your AI Connector מתעד את ad_referral (כולל ctwa_clid) באיש הקשר.
  2. ככל שהליד מתקדם — הזמין שיחה, הפך ללקוח, או אבד — אתה מסמן את התוצאה הזו (ראה “העברת שלב המשפך” להלן).
  3. Webhook מופעל לכלי האוטומציה שלך (Zapier, Make, או Pabbly) כשהוא נושא גם את התוצאה וגם את ה-ctwa_clid של איש הקשר.
  4. כלי האוטומציה שלך קורא ל-Conversions API של Meta (באמצעות action_source = business_messaging וה-ctwa_clid) או ל-Google Ads (ייבוא המרות אופליין / המרות משופרות ללידים) כדי לדווח על ההמרה.

בדרך זו, Meta ו-Google לומדות אילו מודעות הניבו תוצאות אמיתיות ומבצעות אופטימיזציה לפיהן.

העברת שלב המשפך

כדי לדווח על המרה, בדרך כלל דרושים שני דברים: מזהה הלחיצה (click id) (שנקלט באופן אוטומטי) והתוצאה (שאותה אתה מגדיר). הדרך האמינה ביותר לצרף תוצאה היא באמצעות תגיות, מכיוון שהחלת תגית מפעילה את ה-webhook מסוג contact_tags_updated — וה-payload הזה כולל את ה-ad_referral של איש הקשר. (הסרת תגית אינה מפעילה אותו; ראה עדכון תגיות איש קשר.)

ניתן להחיל תגיות באופן אוטומטי:

  • תנו לסוכן ה-AI שלכם לתייג את איש הקשר במהלך השיחה — הגדירו חוקי תיוג אוטומטיים בהגדרות הסוכן. כך עובד דפוס ה-“דף נחיתה אחד לכל מודעה ← הודעת כניסה אחת ← תגית אחת” אם ברצונכם לתייג את המקור בעצמכם.
  • או תייגו ידנית מתוך הצ’אטים או דף אנשי הקשר.

בכל פעם שתגית רלוונטית משתנה, ה-webhook מופעל עם מזהה הלחיצה המצורף, מוכן להעברה כהמרה.

כתובת ה-webhook מוגדרת על התגית עצמה, בלשונית Tags של הסוכן (או הקמפיין) שאליו שייך איש הקשר — לא בהגדרות (Settings). כל תגית מקבלת כתובת URL משלה, וכולן יכולות להצביע על אותו endpoint אם ברצונך לרכז את הכל במקום אחד.

קריאת מזהה לחיצה (click id) שכבר פספסת

ad_referral מוחזר גם על ידי ה-API ב-GET /v1/contacts/{id} (בתור adReferral) וב-endpoint של רשימת אנשי הקשר (בתור ad_referral), כך שאם המקלט שלך היה מושבת, או שאתה מבצע התאמה בדיעבד, תוכל לקרוא את מזהה הלחיצה בחזרה במקום להמתין ל-webhook הבא. לאנשי קשר שהגיעו לפני שמזהה הלחיצה תועד עליהם יש null כאן — ניתן לתפוס את הערך רק מההודעה הנכנסת עצמה, לכן אין מה למלא רטרואקטיבית.

מגבלות

  • חיבור ל-WhatsApp API הרשמי בלבד (לא החיבור הלא-רשמי מבוסס ה-Web).
  • אין עדיין אינטגרציה מובנית בלחיצה אחת ל-Meta CAPI או ל-Google Ads — עליך להעביר את הנתונים דרך Zapier/Make/Pabbly. אם ברצונך באינטגרציה מובנית, הודע על כך לתמיכה בכתובת hi@youraiconnector.com.
  • הייחוס (Attribution) נרשם מעתה ואילך, מרגע שהחיבור פעיל. לא ניתן להחיל אותו רטרואקטיבית על שיחות שהתרחשו לפני כן.

צעדים הבאים