ממשק API לרשתות חברתיות תחת המותג שלכם: פרסום, תגובות והודעות ב-SaaS שלכם
ה-Partner API של easyCoexistence מאפשר ל-SaaS להוסיף פרסום, תשובות לתגובות והודעות פרטיות למוצר שלו, עם השם שלו בדף החיבור. הלקוחות מתחברים בדף החיבור המאוחסן שמציג את השם שלכם, השרת שלכם מפרסם דרך POST /channels/{id}/posts, והתגובות וההודעות הפרטיות מגיעות לוובהוק (Webhook) שלכם, כך שהמוצר יכול להשיב דרך ה-API של כל רשת. שם easyCoexistence מופיע במסכי ההתחברות של הרשתות ובכיתוב אחד בדף.
אורך השם המרבי שהשדה partner_name יכול להציג בדף החיבור המאוחסן; שם החשבון שלכם מוצג כברירת מחדל.
עד כמה רחוק קדימה POST /channels/{id}/posts יכול לתזמן פרסום, כשהשדה publish_at חייב להיות לפחות דקה אחת מעכשיו.
חלון ההודעות הסטנדרטי של Instagram אחרי הודעה של אדם, לרוב לפעולות המשתמש; האדם חייב לכתוב ראשון.
כמה זמן אחרי תגובה חשבון Instagram יכול לשלוח לאדם שכתב אותה את התשובה הפרטית היחידה שלו.
מה מוצר SaaS יכול להציג תחת המותג שלו?
כל מה שהלקוחות שלכם משתמשים בו מדי יום. עורך הפרסומים, תיבת ההודעות וההתראות שלכם הם מסכים משלכם, שנבנו על המפתח ec_live_ שלכם ועל פרטי הגישה לרשתות שהוא מביא, והלקוחות שלכם אינם יוצרים חשבון easyCoexistence. כל חלק ממופה לקריאה אחת של ה-Partner API:
מה הלקוח רואה, ואיפה מופיע easyCoexistence?
דף החיבור המאוחסן נושא את השם שלכם ואינו מציג לוגו של easyCoexistence. ארבעה דברים עדיין מזכירים את easyCoexistence, כי רשת תמיד מציגה את האפליקציה שמבקשת גישה, ולקוח לא צריך להיתקל בשם הזה בלי הסבר:
- החלון הקופץ Embedded Signup של Meta עבור מספר WhatsApp, שמציג את האפליקציה המבקשת ואי אפשר לשנות את שמה.
- מסך ההסכמה של Instagram, Facebook, TikTok, YouTube או LinkedIn מציג את easyCoexistence, שהיא האפליקציה המבקשת גישה.
- כיתוב אחד בדף המאוחסן, שמסביר את השם הזה לפני שהרשת מציגה אותו.
- כתובת הדף המאוחסן: הדומיין הוא easycoexistence.com, ולכן השם מופיע גם בה.
איך פרסום עובד מתוך העורך שלכם?
העורך שלכם שולח בקשה אחת לכל ערוץ אל POST /channels/{id}/posts, עם הטקסט, המדיה כקישורי HTTPS או כערכי media_id שנוצרו בקריאה POST /media, ו-publish_at לשעה מאוחרת יותר. הכללים של כל רשת נבדקים לפני שהפרסום נכנס לתור, כך שפרסום שאינו מתקבל ב-Instagram או ב-TikTok חוזר מיד עם הסיבה. שלחו כותרת Idempotency-Key, ובקשה שנשלחת שוב תחזיר את אותו פרסום במקום לפרסם פעמיים. פרסומים ב-LinkedIn יוצאים רק כשאדם במוצר שלכם מאשר כל אחד מהם.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: post_8812" \
-d '{
"text": "Our autumn menu starts Friday.",
"media": [{ "url": "https://cdn.example.com/menu.jpg", "type": "image" }],
"publish_at": "2026-11-07T09:00:00-03:00"
}'איך תגובות והודעות פרטיות מגיעות למוצר שלכם?
דרך וובהוק (Webhook), אחד ליעד לכל חשבון. PUT /channels/{id}/webhook מצביע חשבון חברתי על נקודת הקצה שלכם ומחזיר סוד חתימה עבורו, ו-easyCoexistence מעביר כל אירוע כשהוא מגיע, וחותם בכותרת X-EC-Signature ואינו שומר עותק. Instagram שולח תגובות, אזכורים והודעות פרטיות, דפי Facebook שולחים אירועי פיד, Messenger ואזכורים, ו-TikTok שולח את comment.update כאירוע. הודעות של מספר WhatsApp עוברות מ-Meta ישירות אל השדה webhook_url של המספר.
איך המוצר שלכם משיב?
דרך ה-API של כל רשת, עם האסימון שמוחזר בקריאה GET /channels/{id}?credentials=1, כך שהתשובה מופיעה בשם חשבון הלקוח. הקריאות שלחיצה על כפתור ההשבה שלכם מבצעת:
- תגובה ב-Instagram: POST /<
IG_COMMENT_ID>/replies עם שדה message שמכיל את הטקסט. - הודעה פרטית ב-Instagram: POST /<
IG_ID>/messages עם מזהה האדם והטקסט, בתוך 24 שעות מההודעה האחרונה שלו. - תשובה פרטית לתגובה ב-Instagram: אותו edge עם recipient
comment_id, פעם אחת לכל תגובה, בתוך 7 ימים ממנה. - תגובה ב-TikTok: business/comment/reply/create/, קריאה שמפרסמת תשובה ציבורית.
- WhatsApp:
send_endpointשל המספר, עם אסימון העסק של הלקוח עצמו.
טעויות נפוצות
- הבטחה ללקוחות שיראו את השם שלכם בחלון הקופץ של Meta. החלון מציג את האפליקציה המבקשת גישה, שהיא של easyCoexistence, ולכן ספרו ללקוחות מה יראו לפני החיבור.
- הצעת כפתור השבה להודעות פרטיות ב-Instagram שעברו עליהן 24 שעות. חלון הזמן נסגר, ולכן בדקו את זמן ההודעה האחרונה של האדם לפני שהמוצר שלכם מאפשר לכל אחד להשיב.
- פרסום ב-LinkedIn מתוזמן שאף אחד לא בודק. תנאי ה-API של LinkedIn מגבילים פרסום אוטומטי, ולכן אדם צריך לאשר כל פרסום ב-LinkedIn לפני שהמוצר שולח אותו.
- אימות אירועים של כל הערוצים עם סוד אחד. לכל חשבון חברתי יש סוד חתימה משלו, שחוזר פעם אחת בתשובה לקריאה PUT /channels/{id}/webhook, ולכן שמרו אותו מיד.
easyCoexistence מכניס פרסום ותשובות לתגובות ולהודעות פרטיות לתוך המוצר שלכם, על מספרי WhatsApp של הלקוחות שלכם ועל חשבונות Instagram, Facebook, TikTok, YouTube ו-LinkedIn שלהם, ועוד ערוצים, דרך ה-API הרשמי של כל רשת, עם השם שלכם בדף החיבור וכל חיבור מנוטר 24/7. US$ 9 עד US$ 0.75 לחיבור בחודש, וירידה ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
אפשר להריץ את דף החיבור המאוחסן על הדומיין שלי?
לא. הוא פועל בכתובת easycoexistence.com ומציג את השם שלכם מתוך השדה partner_name. הלקוחות מגיעים אליו דרך הפניה או לשונית חדשה מהאפליקציה שלכם, וחוזרים לכתובת redirect_url שלכם כשמסיימים.
האם הלקוחות שלכם צריכים חשבון easyCoexistence?
לא. הם פותחים את הקישור שהמוצר שלכם נותן להם, נכנסים עם הרשת וחוזרים לאפליקציה שלכם. כל חיבור שייך לחשבון שלכם וחויב אליו.
האם הלקוחות יכולים להמשיך להשתמש באפליקציות של הרשתות?
כן. החיבור מוסיף גישת API למוצר שלכם; החשבון ממשיך לעבוד ב-Instagram, ב-TikTok וביתר האפליקציות, ומספר WhatsApp נשאר באפליקציית WhatsApp Business דרך Coexistence, שמאפשר זאת.
כמה עולה easyCoexistence בתוך המוצר שלכם?
כל חשבון מחובר עולה US$ 9 עד US$ 0.75 בחודש, לפי המדרגה שבה נמצא סך החשבונות שלכם, עם 3 הימים הראשונים בחינם. אתם קובעים את המחיר שלכם ללקוחות.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-