איך לאפשר למשתמשים שלכם לחבר חשבונות WhatsApp, Instagram ו-TikTok לאפליקציה שלכם
כדי לאפשר למשתמשים שלכם לחבר חשבונות WhatsApp, Instagram ו-TikTok לאפליקציה, יוצרים סשן חיבור ב-Partner API של easyCoexistence ושולחים את המשתמש אל כתובת ה-URL של הדף המאוחסן שלו. שם הוא מחבר מספר WhatsApp דרך Embedded Signup של Meta, או נכנס לחשבון Instagram, Facebook, TikTok, YouTube, LinkedIn וערוצים נוספים. לאחר מכן הוא חוזר אל redirect_url שלכם עם מזהה החיבור או מזהה הערוץ החדש. הקישורים תקפים שעה.
כמה זמן פועל קישור חיבור; לאחר מכן הסשן מציג סטטוס פג תוקף, ונדרש קישור חדש.
כמה סשנים פתוחים יכול חשבון אחד להחזיק בו-זמנית, ולצדם מגבלה של 100 סשנים חדשים בשעה.
סשן נוצר, נפתח, מתחבר, מבוטל או פג תוקף, והמצב מוחזר על ידי GET /connect-sessions/:id לפי מזהה הסשן.
הכתובת החלופית (callback) הארוכה ביותר ש-Meta מקבלת לניתוב הודעות הוובהוק (Webhook) של מספר WhatsApp.
איך פועל קישור חיבור?
בדומה לדף תשלום. השרת שלכם יוצר סשן, הממשק שלכם שולח את הלקוח לכתובת ה-URL שלו, הלקוח מתחבר בדף ב-easycoexistence.com, והדפדפן חוזר אל redirect_url שלכם. לאחר מכן השרת שלכם מאשר את התוצאה ומביא את פרטי הגישה של החיבור החדש, הכול עם מפתח ה-API שלכם.
מה נכלל בבקשה?
גוף JSON שנשלח אל https://easycoexistence.com/api/v1/connect-sessions, עם מפתח ה-API שלכם כאסימון Bearer. חובה לשלוח שדה אחד בלבד, redirect_url. השאר אופציונלי:
redirect_url: כתובת https שאליה הלקוח מגיע לאחר מכן.- channel: whatsapp, שהיא ברירת המחדל, או רשת חברתית פתוחה לחשבון לפי שמה באותיות קטנות, כמו instagram, tiktok ו-youtube, ועוד.
external_ref: המזהה שלכם ללקוח הזה, עד 200 תווים.partner_name: השם שמציג הדף המאוחסן, עד 80 תווים; כברירת מחדל שם החשבון שלכם.webhook_urlעםwebhook_verify_token: למספרים בלבד, ותמיד יחד. Meta מעבירה לשם את ההודעות של המספר מהרגע שהוא מתחבר.
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "whatsapp",
"redirect_url": "https://app.example.com/connect/return",
"external_ref": "customer_4821",
"partner_name": "ClinicApp",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"webhook_verify_token": "another-long-random-string"
}'מה חוזר?
תשובה 201 עם הסשן. שלחו את הלקוח אל url, ושמרו את id, שמתחיל בתווים cs_, כדי לחפש את הסשן מאוחר יותר. expires_at חל שעה אחרי היצירה, ו-connection_id או channel_id מתמלא כשהלקוח מתחבר, בהתאם לערוץ של הסשן. GET /connect-sessions/:id מחזיר את אותו מבנה בכל זמן.
{
"id": "cs_…",
"url": "https://easycoexistence.com/connect/cs_…",
"channel": "whatsapp",
"status": "created",
"external_ref": "customer_4821",
"connection_id": null,
"channel_id": null,
"token_ready": false,
"redirect_url": "https://app.example.com/connect/return",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"last_error": null,
"expires_at": "2026-10-31T15:00:00.000Z",
"opened_at": null,
"finished_at": null,
"created_at": "2026-10-31T14:00:00.000Z"
}אילו שגיאות יכולות לחזור ביצירת סשן?
לכל שגיאה אותו גוף, אובייקט עם code והודעה, וההודעה אומרת מה לתקן. יצירת סשן יכולה להחזיר:
- 400
invalid_jsonאוinvalid_request: הגוף אינו אובייקט JSON, או שדה נכשל בבדיקה, למשל כש-redirect_urlאינו מאובטח. - 400
channel_unavailable: הערוץ אינו פתוח לחשבון הזה; ההודעה מפרטת אילו ערוצים פתוחים. - 401 unauthorized: מפתח ה-API חסר או שגוי.
- 402
billing_required: לחשבון אין עדיין כרטיס, וכל מה שמחובר דרכו מחויב אליו. - 429
cap_reached: כבר פתוחים 50 סשנים; המתינו עד שחלק מהם יסתיימו או יפוג תוקפם. - 429
rate_limited: יותר מ-100 סשנים בשעה זו; ההודעה מציינת כמה זמן להמתין.
לאן הלקוח מגיע לאחר מכן?
אל redirect_url שלכם, עם התוצאה שנוספה למחרוזת השאילתה. אותם ערכים נמצאים בסשן, והשרת שלכם קורא אותו עם GET /connect-sessions/:id. אלה הערכים:
- session: מזהה הסשן, cs_ ואחריו תווים אקראיים.
- status: connected, או cancelled כשהלקוח בחר באפשרות הביטול.
external_ref: המזהה שלכם ללקוח, אם הסשן נשא אחד.connection_id: מזהה המספר החדש, לשימוש עם נתיב /connections בשליפה.channel_id: מזהה חשבון הרשת החברתית החדש, לשימוש עם נתיב /channels בשליפה.
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…אילו סטטוסים יכולים להיות לסשן?
חמישה. GET /connect-sessions/:id מדווח על הסטטוס הנוכחי, יחד עם opened_at, finished_at ו-last_error, שמסביר למה הניסיון האחרון נכשל:
- created: נוצר על ידי השרת שלכם, ועדיין לא נפתח.
- opened: הלקוח טען את הדף המאוחסן.
- connected: מספר או חשבון חברתי התחבר, ומזהה שלו מופיע בסשן.
- cancelled: הלקוח יצא באמצעות כפתור הביטול.
- expired: השעה נגמרה לפני שהסשן הסתיים.
כמה זמן קישור פועל?
שעה מרגע היצירה. לאחר מכן הדף המאוחסן מודיע ללקוח שהקישור פג תוקף, עם לחצן חזרה אל redirect_url עם status=cancelled, והסשן מציג expired. לחשבון יכולים להיות עד 50 סשנים פתוחים וליצור 100 בשעה, כי Meta סופרת כל הצטרפות ראשונה מול מכסה אחת לכל האפליקציה, שכל החשבונות חולקים.
מה עושה external_ref?
הוא מקשר כל חיבור ללקוח שלכם. הערך ששלחתם נשמר במספר או בערוץ שהסשן יוצר, מתווסף להפניה, ומופיע בכל אירוע סטטוס הנוגע לו. כך אפשר לראות מה הלקוח חיבר דרך GET /connections?external_ref=customer_4821 וגם דרך GET /channels?external_ref=customer_4821. התחברות דרך Facebook או LinkedIn יכולה להביא כמה עמודים בבת אחת: ההפניה מציינת את הראשון, והמסנן מציג את השאר. השתמשו במזהה יציב ממסד הנתונים שלכם, לא באימייל שיכול להשתנות.
מה קורה אם הלקוח מבטל או שההתחברות נכשלת?
זה תלוי היכן זה קרה, והסשן שומר את הרישום:
- החלון של Meta נכשל או נסגר: הלקוח לוחץ שוב על Connect באותו דף, כל עוד הקישור פתוח.
- כניסה לרשת חברתית בוטלה או נדחתה: הלקוח חוזר לדף המאוחסן עם הסיבה, ויכול לנסות שוב עד שהקישור יפוג.
- החשבון כבר מחובר דרך חשבון easyCoexistence אחר:
last_errorאומר זאת, והלקוח נכנס עם חשבון אחר. - הלקוח בחר Cancel and go back:
redirect_urlמקבל status=cancelled והסשן נסגר, לכן יוצרים סשן חדש לניסיון נוסף. - הקישור פג תוקף: יוצרים סשן חדש.
מה קורה אם מספר מתחבר בלי אסימון הלקוח?
לפעמים Meta מסיימת את Embedded Signup בלי להנפיק לעסק של הלקוח אסימון משלו. הדף המאוחסן מבקש אז הרצה נוספת, שלוקחת כמה שניות. אם הלקוח מדלג עליה, הסשן מציג connected עם token_ready false, וכתובת אירועי הסטטוס שלכם מקבלת connection.token_missing: המספר מקבל הודעות, כי המזהים שלו תקינים, אך אינו יכול לשלוח עד שסשן חיבור חדש יחבר אותו מחדש ויוציא אסימון.
מה קורה אם webhook_url נכשל בבדיקה של Meta?
המספר מתחבר בכל מקרה. Meta בודקת את webhook_url בבקשת GET, ונקודת הקצה שלכם עוברת את הבדיקה כשהיא מחזירה את hub.challenge, כאשר הערך של hub.verify_token תואם. אם הבדיקה נכשלת, last_error בסשן מתחיל בטקסט webhook_url was not applied ומציג את הסיבה של Meta, וכתובת PUT /connections/:id/webhook קובעת את היעד ברגע שנקודת הקצה עונה. אם הוגדר תוך 24 שעות מההתחברות, היעד עדיין מקבל את הייבוא החד-פעמי של אנשי הקשר, ואם הלקוח הסכים לשתף אותה, גם את היסטוריית הצ'אט.
מה הלקוח רואה?
דף ב-easycoexistence.com עם השם מהשדה partner_name, וללא חשבון, אימייל או כרטיס למילוי. למספר WhatsApp הוא מציג רשימת תנאים קצרה, ואחריה החלון של Meta וקוד QR לסריקה באפליקציית WhatsApp Business. לחשבון חברתי הוא מציג לחצן אחד, כמו Continue with TikTok, הפותח את מסך ההסכמה של הרשת באותה לשונית, כך שזה עובד גם בטלפונים.
טעויות נפוצות
- הסתמכות על מחרוזת השאילתה בלבד. כל אחד יכול להקליד status=connected בכתובת, ולכן יש לאשר עם GET /connect-sessions/:id מהשרת שלכם לפני שמסמנים את הלקוח כמחובר.
- הטמעת הקישור בתוך iframe. שלחו את הלקוח אליו בהפניה או בלשונית חדשה, כך שהדף המאוחסן ומסכי ההתחברות שנפתחים ממנו יפעלו כמתוכנן.
- יצירת קישורים מראש. כל קישור פועל שעה, וכל קישור פתוח נספר במכסה של 50, לכן צרו את הסשן כשהלקוח עומד להתחבר.
- שליחת webhook_url ארוך מ-200 תווים. Meta מקבלת כתובות callback חלופיות של עד 200 תווים, ולכן כתובת ארוכה יותר לא תוחל והמספר יתחבר בלעדיה.
easyCoexistence מחברת את מספרי WhatsApp של הלקוחות שלכם ואת חשבונות Instagram, Facebook, TikTok, YouTube ו-LinkedIn שלהם, וערוצים נוספים, לתוכנה שלכם דרך קישור מאורח אחד. לאחר מכן היא נותנת לשרת שלכם את פרטי הגישה של כל חיבור, וגם וובהוקים ואירועי סטטוס חתומים. US$ 9 עד US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, וכולל תקופת ניסיון של 3 ימים בחינם.
שאלות נפוצות
האם אפשר להשתמש בקישור חיבור פעמיים?
לא. קישור מסתיים במספר אחד או בכניסה חברתית אחת, וכניסה דרך Facebook או LinkedIn יכולה להביא כמה עמודים. אחר כך הקישור מציג connected, ולכן יוצרים סשן חדש לחיבור הבא.
אפשר לשלוח את הקישור באימייל או בצ'אט?
כן, כל עוד הלקוח פותח אותו בתוך השעה. מזהה הסשן בכתובת הוא מה שמאשר את הדף, לכן שלחו כל קישור רק ללקוח שאליו הוא נוצר.
האם הדף המאוחסן עובד בטלפונים?
כניסות לרשתות חברתיות כן, כי הן נפתחות באותה לשונית. מספר WhatsApp מתחבר הכי טוב ממחשב: בטלפון החלון של Meta נפתח כלשונית חדשה, והטלפון עצמו נחוץ לסריקת קוד QR.
איך מקבלים הודעה שלקוח התחבר בלי לבדוק כל הזמן?
מגדירים כתובת לאירועי סטטוס בלוח הבקרה תחת Profile, Developers. easyCoexistence שולחת אז connection.connected או channel.connected, חתומים ונושאים את external_ref שלכם, ברגע שהחיבור נוצר.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-