התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

איך לאפשר למשתמשים שלכם לחבר חשבונות WhatsApp, Instagram ו-TikTok לאפליקציה שלכם

כדי לאפשר למשתמשים שלכם לחבר חשבונות WhatsApp, Instagram ו-TikTok לאפליקציה, יוצרים סשן חיבור ב-Partner API של easyCoexistence ושולחים את המשתמש אל כתובת ה-URL של הדף המאוחסן שלו. שם הוא מחבר מספר WhatsApp דרך Embedded Signup של Meta, או נכנס לחשבון Instagram, Facebook, TikTok, YouTube, LinkedIn וערוצים נוספים. לאחר מכן הוא חוזר אל redirect_url שלכם עם מזהה החיבור או מזהה הערוץ החדש. הקישורים תקפים שעה.

1 hour

כמה זמן פועל קישור חיבור; לאחר מכן הסשן מציג סטטוס פג תוקף, ונדרש קישור חדש.

50 open

כמה סשנים פתוחים יכול חשבון אחד להחזיק בו-זמנית, ולצדם מגבלה של 100 סשנים חדשים בשעה.

5 statuses

סשן נוצר, נפתח, מתחבר, מבוטל או פג תוקף, והמצב מוחזר על ידי GET /connect-sessions/:id לפי מזהה הסשן.

200 characters

הכתובת החלופית (callback) הארוכה ביותר ש-Meta מקבלת לניתוב הודעות הוובהוק (Webhook) של מספר WhatsApp.

איך פועל קישור חיבור?

בדומה לדף תשלום. השרת שלכם יוצר סשן, הממשק שלכם שולח את הלקוח לכתובת ה-URL שלו, הלקוח מתחבר בדף ב-easycoexistence.com, והדפדפן חוזר אל redirect_url שלכם. לאחר מכן השרת שלכם מאשר את התוצאה ומביא את פרטי הגישה של החיבור החדש, הכול עם מפתח ה-API שלכם.

1CreatePOST /connect-sessions from your backend
2SendA redirect or a new tab to the session's url
3ConnectMeta's Embedded Signup, or the network's own sign-in
4ReturnYour redirect_url, with the session, status and new id
5ConfirmGET /connect-sessions/:id, then the credentials

מה נכלל בבקשה?

גוף 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 מעבירה לשם את ההודעות של המספר מהרגע שהוא מתחבר.
Create a session for a WhatsApp number
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 מחזיר את אותו מבנה בכל זמן.

201 Created
{
  "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 בשליפה.
A number connected
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

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 שלכם, ברגע שהחיבור נוצר.

המשיכו לקרוא

Embedded Signup של WhatsApp ללקוחות שלכם: אפליקציית Tech Provider משלכם או עמוד מתארחאיך SaaS מחבר את מספרי WhatsApp של לקוחותיו עם Coexistence: מה Meta דורשת מ-Tech Provider, מה עמוד מתארח לוקח על עצמו ומה הלקוחות רואים.אימות Partner API: מפתחות Bearer מסוג ec_live_, החלפה ושגיאות 401איך בקשות ה-Partner API מאומתות: מפתח ec_live_ אחד לחשבון, שנוצר בלוח הבקרה או באמצעות create_api_key, מוצג פעם אחת ומוחלף מיד, וה-401.מגבלות ודרישות ה-Partner API: מדיניות Meta, 20 הודעות לשנייה וכלל 14 ימיםהכללים שפלטפורמה שומרת לערוצי לקוחותיה: מדיניות Meta ל-WhatsApp, 20 הודעות לשנייה למספר Coexistence וכלל 14 הימים.חיבור מספר, שלב אחר שלבמה קורה כשמחברים מספר דרך Coexistence, מה בעל העסק צריך לעשות ומה נקבע פעם אחת ואי אפשר לשנות.אילו מספרים זכאים ל-Coexistenceגרסת האפליקציה, סוג החשבון והרשאות התיק, ומה גורם ל-Meta לדחות מספר בתהליך ההצטרפות ל-Coexistence.ממשק API לרשתות חברתיות לסוכני AI: פרסום, תזמון, תגובות ומדידהממשק API ושרת MCP שמאפשרים לסוכני AI לפרסם, לתזמן, להגיב ולקרוא אנליטיקה ברשתות חברתיות, דרך ה-API הרשמי של כל רשת.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-