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

ממשק API רב-לקוחות לרשתות חברתיות: מפתח אחד, חשבונות רבים של לקוחות

ה-Partner API של easyCoexistence מרובה לקוחות מעצם תכנונו: מפתח ec_live_ אחד בחשבון שלכם מחבר ומנהל מספרי WhatsApp וחשבונות רשתות חברתיות של לקוחות רבים. לכל חיבור נשמר מזהה הלקוח שלכם בשדה external_ref, הוא מחזיק באסימון משלו, מקבל יעד וובהוק (Webhook) משלו ומופיע באירועי סטטוס חתומים, ולכן GET /channels?external_ref= מחזיר את החשבונות של לקוח אחד בלבד.

200 characters

המזהה הארוך ביותר שסשן חיבור מקבל בשדה external_ref: המזהה שלכם ללקוח, שנשמר בחיבור שנוצר.

1 key

מפתחות API שחשבון easyCoexistence מחזיק בכל רגע נתון; מפתחות נפרדים פירושם חשבונות נפרדים וחיובים נפרדים.

50 open

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

5 minutes

הגיל המרבי של חותמת הזמן של אירוע חתום, שאחריו יש לדחות את האירוע, עם השוואת ה-HMAC בזמן קבוע.

איך חשבון אחד משרת לקוחות רבים?

חשבון easyCoexistence שלכם מייצג את המוצר שלכם, וכל לקוח הוא תגית על החיבורים שהוא מביא. לקוחות אינם פותחים חשבון משלהם, אינם רואים את המפתח שלכם, ואתם, ולא החברה, מחייבים אותם:

Your accountOne ec_live_ key, one bill, one status events URL
Your customerYour own id, sent as external_ref
NumberA WhatsApp number at /connections
ChannelA social account at /channels
DestinationA webhook per number or channel

איך מתייגים כל חיבור בלקוח שלכם?

שולחים את external_ref בסשן החיבור. הערך נשמר במספר או בערוץ שהסשן יוצר, מתווסף לכתובת ההפניה ונכלל באירועי הסטטוס שלו. כניסה דרך Facebook או LinkedIn שמביאה כמה עמודים מתייגת כל אחד מהם. כדי לראות את החשבונות של לקוח אחד, מסננים את אחת הרשימות:

One customer's social accounts and numbers
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

איך נשמרים האסימונים של הלקוחות בנפרד?

לכל חיבור יש את האסימון של הלקוח שלו. אסימון של מספר WhatsApp הוא אסימון העסק ש-Meta מנפיקה ב-Embedded Signup, מוגבל לנכסים של אותו לקוח. אסימון של חשבון רשת חברתית הוא האסימון שבעל החשבון העניק. אישורים מגיעים רק דרך המפתח שלכם, מהשרת שלכם, ומזהה שאינו בחשבון שלכם מחזיר 404 not_found. לפני שמושכים אסימון, מאתרים את החיבור של הלקוח שאליו שייכת המשימה, כדי שהעבודה של לקוח אחד לעולם לא תרוץ על החשבון של לקוח אחר.

איך עובדים וובהוקים לפי לקוח?

יעד אחד לכל חשבון, שאתם בוחרים. מחברים את הערוצים לכתובת ה-URL אחת ומנתבים לפי השדה account_id בגוף הבקשה, או נותנים לכל לקוח כתובת משלו. כל ערוץ חותם בסוד משלו שנקבע דרך PUT /channels/{id}/webhook, כך שהשדה account_id אומר לכם באיזה סוד לאמת. הודעות של מספר עוברות מ-Meta אל webhook_url שמוגדר בחשבון ה-WhatsApp Business, ולכן מנתבים אותן לפי השדה phone_number_id, שמזהה את המספר.

איך אירועי סטטוס מציינים לאיזה לקוח הם שייכים?

על ידי כך שהם נושאים את external_ref שלכם. כתובת אחת לאירועים לכל חשבון מקבלת אירועים מסוג connection.* ו-channel.*, וכל אחד מהם כולל בתוכו את תצוגת החיבור או הערוץ, כולל external_ref. post.published ו-post.failed נושאים את הפוסט ואת הערוץ שלו. האירועים חתומים בסוד של החשבון עצמו בכותרת X-EC-Signature, ונשלחים שוב כשנקודת הקצה שלכם נכשלת, ולכן מטפלים בכל מזהה משלוח פעם אחת בלבד.

איך מאשרים הרבה לקוחות במהירות?

עד 50 סשני חיבור פתוחים ו-100 חדשים בשעה לכל חשבון. Meta סופרת כל קליטה ראשונה של WhatsApp מול מכסה ברמת היישום שכל חשבונות easyCoexistence חולקים, והתקרות מונעות מייבוא של פלטפורמה אחת לרוקן אותה. פותחים סשן לכל לקוח רק כשהוא עומד להתחבר, ותקרה מחזירה את השגיאה 429, עם cap_reached או rate_limited, לפי המקרה.

מה קורה אם חשבון של לקוח כבר מחובר במקום אחר?

ההתחברות נדחית. חשבון רשת חברתית מתחבר דרך חשבון easyCoexistence אחד בכל רגע, ולכן אם שירות אחר שמשתמש ב-easyCoexistence מחזיק בו, השדה last_error בסשן מציין זאת, והלקוח מסיר אותו שם או נכנס בחשבון אחר. בתוך החשבון שלכם לקוח יכול לחבר כמה חשבונות שצריך, וכולם מתויגים באותו ערך external_ref, שהוא מזהה הלקוח שלכם.

איך מוציאים לקוח אחד מהמערכת?

מפרטים את החיבורים והערוצים שלו לפי external_ref ומוחקים כל אחד מהם באמצעות DELETE. הסרת מספר מבטלת את הגישה של easyCoexistence ב-Meta ומפסיקה את הניטור; הסרת ערוץ מבטלת את הגישה ברשת ומבטלת את הפוסטים שעדיין ממתינים בתור. החיוב על כל אחד מהם נעצר בסוף המחזור, והחיבורים האחרים של הלקוח, כמו של לקוחות אחרים, אינם נפגעים.

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

  • שימוש בדוא״ל כערך של external_ref. דוא״לים משתנים, והערך נשמר בכל חיבור, לכן השתמשו במזהה היציב ממסד הנתונים שלכם.
  • אימות אירועים שמועברים הלאה עם הסוד של לקוח אחר. חפשו את הסוד לפי account_id בגוף הבקשה, כי כל ערוץ חותם בסוד משלו.
  • שליחת קישורי חיבור לכל בסיס הלקוחות בבת אחת. יכולים להיות פתוחים רק 50 סשנים לחשבון, לכן הזמינו לקוחות בגלים.
  • מחיקת לקוח רק במסד הנתונים שלכם. החיבורים שלו נשארים בחשבון שלכם ובחיוב שלכם עד שכל אחד מהם יוסר דרך ה-API, בקריאה נפרדת לכל חיבור.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

האם אני צריך חשבון easyCoexistence נפרד לכל לקוח?

לא. חשבון אחד והמפתח שלו יכולים להחזיק את החיבורים של לקוחות רבים, שמובחנים לפי external_ref. חשבונות נפרדים נדרשים רק כשרוצים חיובים נפרדים.

האם הלקוחות שלי יכולים לראות את החשבונות של לקוחות אחרים?

לא דרך easyCoexistence. הם לעולם לא מחזיקים במפתח שלכם, ופותחים רק את קישורי החיבור שלהם. מה שכל לקוח רואה בתוך המוצר שלכם נקבע בקוד שלכם.

האם אפשר לתת לכל לקוח כתובת וובהוק שונה?

כן. לכל מספר ולכל ערוץ יש יעד משלו: אפשר כתובת ייעודית לכל לקוח, או כתובת משותפת אחת שמנותבת לפי השדה account_id, והכול תלוי בכם.

איך מחויב חשבון מרובה לקוחות?

לפי חיבור, על כל הלקוחות יחד: מ-US$ 9 ועד US$ 0.75 לחיבור בחודש, לפי המדרגה של הספירה הכוללת שלכם, עם 3 הימים הראשונים בחינם.

המשיכו לקרוא

ממשק API לרשתות חברתיות תחת המותג שלכם: פרסום, תגובות והודעות ב-SaaS שלכםהוסיפו פרסום, תשובות לתגובות והודעות פרטיות ל-SaaS שלכם: מה הלקוחות רואים, איפה השם easyCoexistence עדיין מופיע והקריאות שמאחוריו.איך לאפשר ללקוחות לחבר Instagram לאפליקציה שלכםקישור מאוחסן לחשבונות Instagram של הלקוחות: קריאת הסשן, אסימון הגישה שמקבלים, ואיך האפליקציה מפרסמת ומשיבה לתגובות ולהודעות.איך מוסיפים WhatsApp ל-SaaS עם Embedded Signup ו-Coexistenceהוסיפו WhatsApp ל-SaaS: חברו מספרים של לקוחות עם Embedded Signup ו-Coexistence, קבלו הודעות, השיבו בחלון של 24 שעות ושלחו תבניות.אימות Partner API: מפתחות Bearer מסוג ec_live_, החלפה ושגיאות 401איך בקשות ה-Partner API מאומתות: מפתח ec_live_ אחד לחשבון, שנוצר בלוח הבקרה או באמצעות create_api_key, מוצג פעם אחת ומוחלף מיד, וה-401.איך לדעת מתי חיבור של לקוח ב-WhatsApp או ברשת חברתית מתנתקאירועי connection.* ו-channel.*: ה-payload, סיבות כמו PRIMARY_INACTIVITY, חתימת X-EC-Signature וניסיונות חוזרים במשך כ-33 שעות.איך לאפשר למשתמשים שלכם לחבר חשבונות WhatsApp, Instagram ו-TikTok לאפליקציה שלכםקישורי חיבור מאורחים למספרי WhatsApp ולחשבונות חברתיים של המשתמשים: בקשת סשן, הפניה ופרמטרים, סטטוס, תוקף וניסיונות חוזרים.

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

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

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

נבדק ב-