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

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

ה-Partner API של easyCoexistence מחזיר את אסימון ה-API של הלקוח המחובר ואת המזהים שלו, בקריאת GET אחת עם ?credentials=1. במספר WhatsApp, הקריאה /connections/{id} מחזירה את waba_id, את phone_number_id, את הבסיס של Graph API, את נקודת הקצה לשליחה ואת אסימון העסק של הלקוח עצמו. בחשבון רשת חברתית, הקריאה /channels/{id} מחזירה את הבסיס של ה-API של הרשת, את מזהה החשבון שם ואסימון גישה (Access Token) שמתחדש עבורכם, ולכן מומלץ לשלוף אותו בתחילת כל משימה.

?credentials=1

מוסיפה את האובייקט credentials לתשובה של GET /connections/{id} עבור מספר WhatsApp ושל GET /channels/{id} עבור חשבון רשת חברתית.

1 hour

משך החיים של אסימון גישה למשתמש Google, מסוג האסימון שנושאות קריאות ה-API של ערוץ YouTube.

1 day

תוקפו של אסימון גישה לחשבון TikTok מ-API for Business, ואסימון הרענון שלו תקף לשנה אחת.

60 days

משך התוקף של אסימון Instagram ארוך טווח לאחר רענון, מחושב מהיום שבו רוענן.

No expiry

לאסימוני ה-Page ארוכי הטווח של Meta אין תאריך תפוגה, אם כי תנאים מסוימים עלולים לבטל אותם.

איזו קריאה מחזירה את פרטי הגישה של חיבור?

הקריאה GET של המשאב עצמו עם ?credentials=1, מאומתת עם המפתח ec_live_ שלכם כאסימון Bearer. מספר WhatsApp נמצא בנתיב /connections/{id} וחשבון רשת חברתית בנתיב /channels/{id}, ולכל אחד מהם מרחב מזהים משלו: הפניית החיבור מחזירה את connection_id למספר ואת channel_id לחשבון רשת חברתית. הקריאות GET /connections וכן GET /channels מחזירות את הרשימות, והפרמטר ?external_ref= מצמצם כל רשימה ללקוח אחד. בלי ?credentials=1, אותן קריאות מחזירות את החיבור ללא אסימון.

Credentials for a number and for a social account
# A WhatsApp number
curl "https://easycoexistence.com/api/v1/connections/$CONNECTION_ID?credentials=1" \
  -H "Authorization: Bearer $EC_API_KEY"

# A social account
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
  -H "Authorization: Bearer $EC_API_KEY"

מה מחזירה קריאת הפרטים של מספר WhatsApp?

את החיבור עצמו בתוספת אובייקט credentials. את waba_id ואת phone_number_id מזהים את חשבון WhatsApp Business ואת המספר ב-Graph API של Meta. השדה token_ready מציין אם אסימון לקוח שמור במערכת. בתוך credentials, השדה graph_api_base והשדה send_endpoint כבר כוללים את גרסת ה-Graph API, והשדה access_token הוא אסימון העסק ש-Meta הנפיק כשהלקוח התחבר, ומוגבל לאותו לקוח. השרת שלכם קורא אחר כך ישירות ל-Meta כדי לשלוח הודעות, לנהל תבניות, להעלות מדיה ולערוך את פרופיל העסק.

  • status: connected, degraded, disconnected, banned, suspended, removed או unknown
  • quality_rating ואת messaging_tier: הדירוג של Meta, כמו GREEN, ודרגת ההודעות של המספר, כמו TIER_1K
  • webhook_url: כתובת ה-URL שאליה Meta שולח את הודעות המספר, או null
  • disconnected_reason, last_checked_at, last_event_at וגם created_at: סיבת הניתוק שנרשמה אצל Meta, כשיש כזו, וחותמות זמן בפורמט ISO 8601
GET /connections/{id}?credentials=1
{
  "id": "<CONNECTION_ID>",
  "external_ref": "customer_4821",
  "connect_session_id": "cs_…",
  "phone": "+55 11 9…",
  "name": "Clínica Sorriso",
  "waba_id": "<WABA_ID>",
  "phone_number_id": "<PHONE_NUMBER_ID>",
  "status": "connected",
  "quality_rating": "GREEN",
  "messaging_tier": "TIER_1K",
  "platform_type": "…",
  "token_ready": true,
  "webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
  "disconnected_reason": null,
  "last_checked_at": "2026-10-31T09:00:00.000Z",
  "last_event_at": "2026-10-31T08:41:12.000Z",
  "created_at": "2026-10-20T14:03:55.000Z",
  "credentials": {
    "graph_api_base": "https://graph.facebook.com/v25.0",
    "send_endpoint": "https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages",
    "access_token": "EAAG…",
    "note": "The customer's own business token, scoped to their assets. …"
  }
}

מה מחזירה קריאת הפרטים של כל רשת חברתית?

תצוגת הערוץ, זהה ל-GET /channels/{id}, ומכילה את השדות id, channel, external_ref, name, username, external_id, status, token_ready, ובתוספת אובייקט credentials. לכל רשת ב-credentials יש platform, בסיס API, מזהה החשבון ברשת הזו, access_token, token_expires_at, token_note ודוגמאות קריאה. שדה המזהה וכל מה שרשת זקוקה לו שונים מרשת לרשת:

Instagramgraph_api_base https://graph.instagram.com/v25.0 and account_id_on_meta, the Instagram account's ID. A user token, refreshed before its 60 days run out.
Facebookgraph_api_base https://graph.facebook.com/v25.0 and account_id_on_meta, the Page ID. A Page token that does not expire while the Page stays connected.
TikTokapi_base https://business-api.tiktok.com/open_api/v1.3 and business_id. A day-long token, sent in an Access-Token header with business_id on each call.
YouTubeapi_base https://www.googleapis.com/youtube/v3, analytics_api_base for YouTube Analytics v2, and channel_id. An hour-long Google token, sent as a bearer token.
LinkedInapi_base https://api.linkedin.com/rest, author_urn for the Page or profile, and required_headers with LinkedIn-Version and X-Restli-Protocol-Version 2.0.0.

למה לשלוף אסימון של רשת חברתית בכל משימה במקום לשמור אותו?

כי חלק מהאסימונים מתחדשים בתוך יום, ותשובת הקריאה תמיד מחזירה אסימון שתקף באותו רגע. האסימון של Google עבור YouTube חי שעה, ושל TikTok יום, ו-easyCoexistence מחדשת את שניהם לפני שייגמר תוקפם. האסימון של Instagram חי 60 יום ומתחדש הרבה לפני כן, מה שמנפיק אסימון חדש. אסימון של דף Facebook (Page) אינו פג כל עוד הדף מחובר. בקשה אחת בתחילת כל משימה מונעת מהקוד שלכם לפנות לרשת עם אסימון שכבר פג תוקפו.

האם כדאי לשמור את האסימון של מספר WhatsApp?

כן. זהו אסימון העסק שנוצר ב-Embedded Signup של Meta, ש-Meta מגביל ללקוח שהצטרף, והתיעוד מבקש לשמור אותו אצלכם, כי לוח הבקרה אינו מציג אותו. קראו אותו שוב אחרי כל אירוע connection.connected, כי חיבור מחדש עלול להנפיק אסימון חדש. מספר שהושעה או הוסר כבר לא מחזיר את האסימון, ואסימון לקוח ש-Meta מפסיק לקבל, בזמן שהמספר עדיין עונה, מבוטל, והשדה token_ready הופך לערך false.

מה משמעות token_ready ומה משמעות token_missing?

token_ready הוא true כשיש אסימון לקוח שמור והחיבור פעיל. במספר הוא יכול להיות false מיד אחרי החיבור, כי Meta לפעמים מסיים את Embedded Signup בלי להנפיק את אסימון הלקוח. העמוד המתארח מבקש מהלקוח להריץ את התהליך פעם נוספת, ונקודת הקצה לאירועים שלכם מקבלת connection.token_missing. אם הלקוח מדלג על כך, המספר מקבל הודעות, כי המזהים שלו תקפים, אבל אינו יכול לשלוח. סשן חיבור חדש ללקוח הזה מנפיק את האסימון ואינו מחליף אסימון שכבר עובד. לערוצים חברתיים אין token_missing: ההתחברות שלהם מניבה תמיד את אסימון הלקוח עצמו, ולכן token_ready עוקב אחרי status.

מה מוחזר כשלחיבור אין אסימון להחזיר?

תשובה 200 שבה credentials מכיל access_token עם הערך null והערה שמסבירה מה לעשות, ולא שגיאה. זה חל על מספר שבו token_ready הוא false, על מספר שהושעה או הוסר, ועל ערוץ שסטטוסו אינו connected, שבו ההערה מבקשת סשן חיבור חדש. התשובה 404 not_found פירושה שהמזהה אינו בחשבון שלכם, ואילו 502 credentials_unavailable פירושה שלא ניתן היה להשיג אסימון טרי של הרשת החברתית באותו רגע. נסו שוב, ואם זה חוזר, בדקו את הסטטוס של הערוץ.

טעויות נפוצות

  • שמירת אסימון של YouTube או TikTok בקובץ הגדרות. האסימונים פגים תוך שעה ותוך יום, בהתאמה, לכן הפנו קריאה לנקודת הקצה של הפרטים בתחילת כל משימה, והשאירו את החידוש ל-easyCoexistence.
  • שליחה ממספר שבו token_ready הוא false. אין אסימון לקוח לפנות איתו ל-Meta; פתחו סשן חיבור חדש ללקוח הזה, שיפיק אחד.
  • קריאה ל-TikTok עם כותרת Authorization. ה-Business API שלו מקבל את האסימון בכותרת Access-Token, עם business_id של החשבון בכל בקשה.
  • קריאה ל-LinkedIn עם אסימון ה-bearer בלבד. LinkedIn דורש גם את הכותרת LinkedIn-Version וגם את הכותרת X-Restli-Protocol-Version, המפורטות בשדה required_headers, וכתובות ה-URN בנתיבים עוברות קידוד URL.
עושים את זה עם EasyCoexistence

easyCoexistence מחברת את מספרי WhatsApp של הלקוחות שלכם ואת חשבונות Instagram, Facebook, TikTok, YouTube ו-LinkedIn שלהם, וערוצים נוספים, ואז מעבירה לשרת שלכם את הפרטים של כל חיבור לפי דרישה, כשהאסימונים החברתיים מתחדשים וכל חיבור מנוטר 24/7. מ-US$ 9 לחיבור בחודש, שיורד עד ל-US$ 0.75 ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

האם אסימון ה-WhatsApp הוא של הלקוח?

כן. זהו אסימון העסק ש-Meta מנפיק כשהלקוח מתחבר דרך Embedded Signup, ומוגבל לאותו לקוח. אסימון המערכת של easyCoexistence לעולם אינו נחשף, והקריאה מחזירה אסימון רק כאשר הערך של token_ready הוא true.

כמה זמן חיים אסימוני גישה של רשתות חברתיות?

של YouTube חי שעה, של TikTok יום ושל Instagram עד 60 ימים, ואילו אסימון דף Facebook אינו פג. easyCoexistence מחדשת את אלה שמתחדשים, כך שכל קריאת פרטים מחזירה אסימון שעובד עכשיו.

האם אני צריך אפליקציית מפתחים משלי בכל רשת?

לא. הלקוחות מתחברים דרך האפליקציה של easyCoexistence ב-Meta, TikTok, Google ו-LinkedIn, וקריאת הפרטים מעבירה לשרת שלכם את האסימון לקריאה ישירה ל-API של הרשת.

האם עוזר כמו Claude או ChatGPT יכול לקרוא את אותם פרטי הגישה?

כן. כשהוא מחובר לחשבון שלכם דרך שרת MCP, הוא יכול להפעיל את get_api_credentials עבור מספר ואת get_social_credentials עבור חשבון רשת חברתית. הפרטים זהים לאלה ש-Partner API מחזיר.

המשיכו לקרוא

איך מקבלים בוובהוק (Webhook) את הודעות WhatsApp ואת התגובות ברשתות החברתיות של הלקוחות שלכםוובהוק לכל חיבור: הודעות WhatsApp ישירות מ-Meta, מאומתות בסוד בכתובת, ותגובות ו-DM מהרשתות החברתיות חתומות בכותרת X-EC-Signature.איך לדעת מתי חיבור של לקוח ב-WhatsApp או ברשת חברתית מתנתקאירועי connection.* ו-channel.*: ה-payload, סיבות כמו PRIMARY_INACTIVITY, חתימת X-EC-Signature וניסיונות חוזרים במשך כ-33 שעות.איך לבנות מוצר סוכן AI בערוצי ה-WhatsApp, Instagram ו-TikTok של הלקוחותבנו מוצר סוכן AI בערוצי ה-WhatsApp, Instagram, Facebook ו-TikTok של הלקוחות, עם ה-Partner API, המודל שלכם וכללי כל רשת.פרסום ב-Instagram, ב-TikTok וב-Facebook מ-Python דרך ממשק API אחדפרסום פוסטים, קריאת תגובות ומענה להודעות DM ב-Instagram, Facebook, TikTok, YouTube ו-LinkedIn מ-Python, דרך ה-API הרשמי של כל רשת.פרסום ל-Instagram, TikTok ו-Facebook מ-Node.js באמצעות ממשק API אחדפרסום, תזמון ומענה ב-Instagram, Facebook, TikTok, YouTube ו-LinkedIn מ-Node.js וגם TypeScript עם fetch, וכלי MCP לסוכן שלכם.אסימוני גישה ל-Instagram: אסימונים לטווח ארוך, 60 יום ורענוןאיך פועלים אסימוני הגישה של Instagram Login: אסימון של שעה אחרי ההתחברות, אסימון לטווח ארוך בתוקף 60 יום, ורענון כשהוא בן 24 שעות.

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

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

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

נבדק ב-