API לסוכנויות: ניהול חשבונות הלקוחות שלכם מהתוכנה שלכם
API לסוכנויות מאפשר לתוכנה של הסוכנות לחבר, לפרסם, להשיב ולדווח על חשבונות של כל לקוח. עם Partner API של easyCoexistence, מספר ה-WhatsApp של לקוח וחשבונות Instagram, Facebook, TikTok, YouTube ו-LinkedIn שלו מצטרפים לחשבון הסוכנות באמצעות קישורים מתארחים המתויגים במזהה הלקוח, ומפתח API אחד מתזמן, מנתב ומנטר את כולם.
האורך המרבי של external_ref שסשן חיבור מקבל, מזהה הסוכנות ללקוח, הנשמר בכל חיבור.
כמה זמן פועל קישור חיבור מתארח עבור הלקוח שפותח אותו.
מה נדרש מאפליקציית Meta כדי לשרת חשבונות Instagram מקצועיים שהיא אינה בבעלותה או מנהלת, לאחר App Review ו-Business Verification.
תפקיד Page ב-LinkedIn שחבר נדרש לו להרשאה rw_organization_admin, שמנהלת עמודים וקוראת את הדוחות שלהם.
מתי החיוב מפסיק עבור חיבור לקוח שהסוכנות מסירה דרך ה-API.
איך ה-API מארגן את הלקוחות של הסוכנות?
לפי מזהה הלקוח שלכם. שלחו אותו כ-external_ref בכל סשן חיבור, והוא נשאר על כל מספר וחשבון שהסשן יוצר וחוזר בכל אירוע סטטוס. GET /channels?external_ref=client_118 מציג את חשבונות הרשתות החברתיות של אותו לקוח, עם &channel=instagram לצמצום לרשת אחת. לצד זה, GET /connections?external_ref=client_118 מציג את מספרי ה-WhatsApp שלו. כל הלקוחות יושבים על החשבון האחד של הסוכנות, תחת מפתח ec_live_ אחד, וזה מה שמכניס את כל הספירה למדרגת מחיר אחת.
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"איך לקוח מעביר גישה?
דרך קישור שהסוכנות שולחת. POST /connect-sessions עם הרשת כ-channel, ה-external_ref של הלקוח ושם הסוכנות כ-partner_name מחזיר url. הלקוח פותח אותו, נכנס דרך מסך ההסכמה של הרשת עצמה, או מפעיל את החלון הקופץ של Meta וסורק קוד QR עבור מספר WhatsApp, וחוזר אל ה-redirect_url של הסוכנות. כניסה דרך Facebook או LinkedIn עשויה להביא כמה עמודים בבת אחת, וכל אחד מהם הופך לחיבור משלו, לכן בדקו את הרשימה מול הבריף של הלקוח.
איך הסוכנות מפרסמת עבור לקוחות?
מתוך תהליך האישור שלה. תוכנת הסוכנות שומרת טיוטות עד שהלקוח מאשר, ואז שולחת כל פוסט מאושר אל POST /channels/:id/posts עם publish_at שלו, עד 90 ימים קדימה. GET /channels/:id/posts מציג את לוח הפרסומים של חשבון אחד, GET /posts עם מסנן סטטוס מראה מה ממתין בין כל הלקוחות, ואירועים post.published ו-post.failed מספרים לאחראי החשבון מה קרה. פוסטים ב-LinkedIn עוברים תמיד באישור של אדם, ושלב האישור של הסוכנות כבר מספק זאת.
איך הסוכנות משיבה לתגובות ולהודעות ישירות (DM) עבור לקוחות?
מתיבה אחת שמנתבת לפי חשבון. PUT /channels/:id/webhook קובע יעד לכל חשבון Instagram, לכל עמוד Facebook ולכל חשבון TikTok, וכל תגובה, אזכור או הודעה ישירה שמועברים כוללים את account_id, שממופה ללקוח. הודעות של מספר WhatsApp מגיעות מ-Meta אל ה-webhook_url שנקבע לו. תשובות יוצאות דרך ה-API של כל רשת, עם פרטי הגישה מ-GET /channels/:id?credentials=1, וצוות הסוכנות יכול גם לעבוד על כל הלקוחות ב-Claude או ב-ChatGPT דרך מחבר MCP באותו חשבון.
איך הסוכנות בונה דוחות ללקוחות?
מהאנליטיקה של כל רשת, בקריאה באמצעות פרטי הגישה של חשבון הלקוח. תובנות של Instagram ו-Facebook מגיעות מ-Graph API של Meta, של TikTok מ-API for Business שלה, של YouTube מ-YouTube Analytics, שהבסיס שלו כלול בפרטי הגישה, ושל LinkedIn מנקודות הקצה לסטטיסטיקה שלה. משימת הדוחות של הסוכנות שולפת פרטי גישה טריים לכל חשבון בתחילת כל הרצה, מושכת את הנתונים של התקופה ומאחסנת אותם תחת ה-external_ref של הלקוח.
איך הסוכנות יודעת שחשבון לקוח זקוק לטיפול?
מאירועי סטטוס חתומים. channel.disconnected ו-connection.disconnected נושאים את ה-external_ref של הלקוח, כך שתוכנת הסוכנות יכולה להתריע לאחראי החשבון של אותו לקוח ולשלוח ללקוח קישור חיבור חדש. כל חיבור נמצא במעקב 24/7, ובעל הסוכנות מקבל גם מייל כשחיבור מתנתק. לקוח שמבטל גישה בהגדרות של הרשת מופיע באותו אופן.
מה קורה ב-API כשלקוח עוזב?
משימת ההסרה של הסוכנות מפרטת את חיבורי הלקוח לפי external_ref ושולחת DELETE /channels/:id ו-DELETE /connections/:id על כל אחד מהם. החיוב עליהם נעצר בסוף המחזור, פוסטים מתוזמנים בערוץ שהוסר מבוטלים, ואסימון של חשבון רשת חברתית שהוסר נמחק. מספר WhatsApp נשאר ב-Cloud API עד שהלקוח מנתק אותו באפליקציית WhatsApp Business.
טעויות נפוצות
- הכנסת פוסטים של לקוחות לתור לפני שהלקוח מאשר. פוסט בתור מתפרסם בזמנו בלי בדיקה נוספת, לכן החזיקו טיוטות בשלב האישור שלכם ושלחו אותן רק אחרי אישור.
- שמירת מפתח Partner API בקוד הקדמי של פורטל לקוח. המפתח מגיע לכל הפרטים של כל הלקוחות בחשבון, לכן שמרו אותו על השרת של הסוכנות.
- המתנה לאירועי תגובות מערוץ YouTube של לקוח או מעמוד LinkedIn. easyCoexistence אינו מקבל מאף אחד מהם, לכן משימת הדוחות או תיבת הנכנסות קוראות אותם דרך ה-API של כל רשת.
easyCoexistence נותן לתוכנה של הסוכנות API אחד לגישה למספרי WhatsApp של הלקוחות ולחשבונות Instagram, Facebook, TikTok, YouTube ו-LinkedIn שלהם, ועוד ערוצים נוספים מצטרפים: קישורי חיבור מתארחים המתויגים לכל לקוח, תור פרסום, העברת תגובות והודעות ישירות, פרטי גישה טריים לדוחות ומעקב 24/7 אחר כל חיבור. US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.
שאלות נפוצות
האם ללקוחות נדרש חשבון easyCoexistence משלהם?
לא. הלקוח פותח את קישור החיבור המתארח ונכנס, והחיבור מצטרף לחשבון הסוכנות, שבו הוא מחויב ומנוטר.
האם הסוכנות יכולה לשמור לקוחות על מפתחות API נפרדים?
לחשבון אחד יש מפתח אחד. מפתחות נפרדים פירושם חשבונות easyCoexistence נפרדים, שכל אחד מהם מחויב ממדרגת המחיר הראשונה, ולכן רוב הסוכנויות מפרידות בין הלקוחות לפי external_ref.
האם הלקוח רואה את שם הסוכנות בזמן החיבור?
כן. דף הקישור המתארח מציג את השם שנשלח כ-partner_name. מסך ההסכמה של הרשת עצמה מציין את easyCoexistence כאפליקציה שמבקשת גישה.
כמה עולה easyCoexistence לסוכנות?
US$ 9 עד US$ 0.75 לחיבור לקוח בחודש, שיורד ככל שהסוכנות מוסיפה לקוחות, זהה בכל רשת, עם תקופת ניסיון של 3 ימים.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-