كيفية استخدام Hootsuite API؟

خلاصة القول

تُمكن واجهة برمجة تطبيقات Hootsuite (API) المطورين من التكامل مع سير عمل إدارة وسائل التواصل الاجتماعي برمجيًا. تستخدم مصادقة OAuth 2.0، ونقاط نهاية RESTful للملفات الشخصية، والمنشورات، والتحليلات، وإدارة الفريق، مع حدود معدل تتراوح من 50 إلى 200 طلب في الدقيقة حسب الخطة. يغطي هذا الدليل إعداد المصادقة، وجدولة المنشورات، واسترداد التحليلات، وإدارة الفريق، واستراتيجيات التكامل في الإنتاج.

ملاحظة: أوقفت Hootsuite دعم واجهة برمجة تطبيقاتها العامة اعتبارًا من عام 2024. يغطي هذا الدليل الأساليب البديلة بما في ذلك تكاملات شركاء Hootsuite، والخطافات الويب (webhooks)، وواجهات برمجة تطبيقات إدارة وسائل التواصل الاجتماعي التابعة لجهات خارجية والتي توفر وظائف مماثلة.

مقدمة

تدير Hootsuite أكثر من 30 مليون حساب على وسائل التواصل الاجتماعي لأكثر من 200,000 شركة في أكثر من 175 دولة. بالنسبة للمطورين الذين يبنون أدوات لوسائل التواصل الاجتماعي، أو منصات تسويقية، أو لوحات تحكم تحليلية، يعد تكامل واجهة برمجة تطبيقات وسائل التواصل الاجتماعي أمرًا ضروريًا للوصول إلى هذا الجمهور التجاري الضخم.

إليك الواقع: يفقد مديري وسائل التواصل الاجتماعي الذين يديرون أكثر من 20 حسابًا 25-35 ساعة أسبوعيًا في النشر اليدوي، وتتبع التفاعل، وتوليد التقارير. تكامل قوي لواجهة برمجة تطبيقات وسائل التواصل الاجتماعي يقوم بأتمتة توزيع المحتوى، ومراقبة التفاعل، وتحليل المشاعر، وتقديم تقارير الأداء.

button

حالة واجهة برمجة تطبيقات Hootsuite والبدائل

الوضع الحالي لواجهة برمجة التطبيقات

اعتبارًا من عام 2024، أوقفت Hootsuite دعم واجهة برمجة تطبيقاتها العامة. إليك خيارات التكامل:

النهج	الوصف	الأفضل لـ
واجهات برمجة التطبيقات للمنصات الأصلية	التكامل المباشر مع فيسبوك، تويتر، لينكد إن، إلخ.	تحكم كامل، حلول مخصصة
Audiense	استخبارات الجمهور المملوكة لـ Hootsuite	تحليل الجمهور
HeyOrca	واجهة برمجة تطبيقات لجدولة وسائل التواصل الاجتماعي	تقويمات المحتوى
Buffer API	إدارة وسائل التواصل الاجتماعي	الفرق الصغيرة
Sprout Social API	إدارة اجتماعية للمؤسسات	المنظمات الكبيرة
Agorapulse API	نظام إدارة علاقات العملاء لوسائل التواصل الاجتماعي	إدارة المجتمع

النهج الموصى به: واجهات برمجة تطبيقات المنصات الأصلية

بالنسبة لمعظم حالات الاستخدام، يوفر التكامل المباشر مع المنصات الاجتماعية أقصى قدر من المرونة:

المنصة	اسم واجهة برمجة التطبيقات (API)	الميزات الرئيسية
فيسبوك/انستغرام	Graph API	المنشورات، الرؤى، التعليقات
تويتر/إكس	API v2	التغريدات، التحليلات، التدفقات
لينكدإن	Marketing API	المنشورات، صفحات الشركات، الإعلانات
بينتيريست	API v5	المنشورات (Pins)، اللوحات، التحليلات
تيك توك	Display API	مقاطع الفيديو، معلومات المستخدم
يوتيوب	Data API	مقاطع الفيديو، قوائم التشغيل، التحليلات

البدء: مصادقة متعددة المنصات

الخطوة 1: تسجيل تطبيقات المطورين

أنشئ حسابات مطورين لكل منصة:

// تخزين بيانات الاعتماد بأمان
const SOCIAL_CREDENTIALS = {
  facebook: {
    appId: process.env.FB_APP_ID,
    appSecret: process.env.FB_APP_SECRET,
    redirectUri: process.env.FB_REDIRECT_URI
  },
  twitter: {
    apiKey: process.env.TWITTER_API_KEY,
    apiSecret: process.env.TWITTER_API_SECRET,
    redirectUri: process.env.TWITTER_REDIRECT_URI
  },
  linkedin: {
    clientId: process.env.LINKEDIN_CLIENT_ID,
    clientSecret: process.env.LINKEDIN_CLIENT_SECRET,
    redirectUri: process.env.LINKEDIN_REDIRECT_URI
  },
  instagram: {
    appId: process.env.FB_APP_ID, // يستخدم تسجيل الدخول عبر فيسبوك
    appSecret: process.env.FB_APP_SECRET
  }
};

الخطوة 2: تطبيق تدفق OAuth 2.0

معالج OAuth موحد لمنصات متعددة:

const getAuthUrl = (platform, state) => {
  const configs = {
    facebook: {
      url: 'https://www.facebook.com/v18.0/dialog/oauth',
      params: {
        client_id: SOCIAL_CREDENTIALS.facebook.appId,
        redirect_uri: SOCIAL_CREDENTIALS.facebook.redirectUri,
        scope: 'pages_manage_posts,pages_read_engagement,instagram_basic,instagram_content_publish',
        state
      }
    },
    twitter: {
      url: 'https://twitter.com/i/oauth2/authorize',
      params: {
        client_id: SOCIAL_CREDENTIALS.twitter.apiKey,
        redirect_uri: SOCIAL_CREDENTIALS.twitter.redirectUri,
        scope: 'tweet.read tweet.write users.read offline.access',
        state,
        response_type: 'code'
      }
    },
    linkedin: {
      url: 'https://www.linkedin.com/oauth/v2/authorization',
      params: {
        client_id: SOCIAL_CREDENTIALS.linkedin.clientId,
        redirect_uri: SOCIAL_CREDENTIALS.linkedin.redirectUri,
        scope: 'w_member_social r_basicprofile',
        state,
        response_type: 'code'
      }
    }
  };

  const config = configs[platform];
  const params = new URLSearchParams(config.params);
  return `${config.url}?${params.toString()}`;
};

// معالجة رد نداء OAuth
const handleOAuthCallback = async (platform, code) => {
  const tokenEndpoints = {
    facebook: 'https://graph.facebook.com/v18.0/oauth/access_token',
    twitter: 'https://api.twitter.com/2/oauth2/token',
    linkedin: 'https://www.linkedin.com/oauth/v2/accessToken'
  };

  const response = await fetch(tokenEndpoints[platform], {
    method: 'POST',
    headers: {
      'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: new URLSearchParams({
      client_id: SOCIAL_CREDENTIALS[platform].apiKey || SOCIAL_CREDENTIALS[platform].appId || SOCIAL_CREDENTIALS[platform].clientId,
      client_secret: SOCIAL_CREDENTIALS[platform].appSecret || SOCIAL_CREDENTIALS[platform].apiSecret,
      redirect_uri: SOCIAL_CREDENTIALS[platform].redirectUri,
      code,
      grant_type: 'authorization_code'
    })
  });

  return response.json();
};

الخطوة 3: تخزين الرموز المميزة (Tokens) بأمان

// مخطط قاعدة البيانات لرموز الوسائط الاجتماعية
const SocialToken = {
  userId: 'user_123',
  platform: 'facebook',
  accessToken: 'encrypted_token_here',
  refreshToken: 'encrypted_refresh_token',
  tokenExpiry: Date.now() + 5183999, // 60 يومًا
  scopes: ['pages_manage_posts', 'pages_read_engagement'],
  pageId: 'page_456', // لفيسبوك/انستغرام
  pageName: 'صفحة عملي'
};

جدولة ونشر المنشورات

إنشاء منشور متعدد المنصات

النشر على منصات متعددة في وقت واحد:

const createSocialPost = async (postData) => {
  const results = {};

  // منشور صفحة فيسبوك
  if (postData.platforms.includes('facebook')) {
    results.facebook = await postToFacebook({
      pageId: postData.facebookPageId,
      message: postData.message,
      link: postData.link,
      photo: postData.photo
    });
  }

  // منشور تويتر
  if (postData.platforms.includes('twitter')) {
    results.twitter = await postToTwitter({
      text: postData.message,
      media: postData.photo
    });
  }

  // منشور لينكد إن
  if (postData.platforms.includes('linkedin')) {
    results.linkedin = await postToLinkedIn({
      authorUrn: postData.linkedinAuthorUrn,
      text: postData.message,
      contentUrl: postData.link
    });
  }

  // منشور انستغرام
  if (postData.platforms.includes('instagram')) {
    results.instagram = await postToInstagram({
      igAccountId: postData.igAccountId,
      imageUrl: postData.photo,
      caption: postData.message
    });
  }

  return results;
};

// النشر على فيسبوك
const postToFacebook = async (postData) => {
  const token = await getFacebookPageToken(postData.pageId);

  const params = new URLSearchParams({
    message: postData.message,
    access_token: token
  });

  if (postData.link) {
    params.append('link', postData.link);
  }

  if (postData.photo) {
    params.append('photo', postData.photo);
  }

  const response = await fetch(
    `https://graph.facebook.com/v18.0/${postData.pageId}/feed?${params.toString()}`,
    { method: 'POST' }
  );

  return response.json();
};

// النشر على تويتر
const postToTwitter = async (postData) => {
  const token = await getTwitterToken();

  let mediaIds = [];
  if (postData.media) {
    // تحميل الوسائط أولاً
    const mediaUpload = await uploadTwitterMedia(postData.media, token);
    mediaIds = [mediaUpload.media_id_string];
  }

  const response = await fetch('https://api.twitter.com/2/tweets', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      text: postData.text,
      media: mediaIds.length > 0 ? { media_ids: mediaIds } : undefined
    })
  });

  return response.json();
};

// النشر على لينكد إن
const postToLinkedIn = async (postData) => {
  const token = await getLinkedInToken();

  const post = {
    author: postData.authorUrn,
    lifecycleState: 'PUBLISHED',
    specificContent: {
      'com.linkedin.ugc.ShareContent': {
        shareCommentary: {
          text: postData.text
        },
        shareMediaCategory: postData.contentUrl ? 'ARTICLE' : 'NONE',
        media: postData.contentUrl ? [{
          status: 'READY',
          media: postData.contentUrn,
          description: { text: postData.text }
        }] : []
      }
    },
    visibility: {
      'com.linkedin.ugc.MemberNetworkVisibility': 'PUBLIC'
    }
  };

  const response = await fetch('https://api.linkedin.com/v2/ugcPosts', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json',
      'X-Restli-Protocol-Version': '2.0.0'
    },
    body: JSON.stringify(post)
  });

  return response.json();
};

// النشر على انستغرام
const postToInstagram = async (postData) => {
  const token = await getInstagramToken();

  // الخطوة 1: إنشاء حاوية وسائط
  const containerResponse = await fetch(
    `https://graph.facebook.com/v18.0/${postData.igAccountId}/media`,
    {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${token}` },
      body: JSON.stringify({
        image_url: postData.imageUrl,
        caption: postData.caption
      })
    }
  );

  const container = await containerResponse.json();

  // الخطوة 2: النشر
  const publishResponse = await fetch(
    `https://graph.facebook.com/v18.0/${postData.igAccountId}/media_publish`,
    {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${token}` },
      body: JSON.stringify({ creation_id: container.id })
    }
  );

  return publishResponse.json();
};

جدولة المنشورات

تطبيق جدولة المنشورات:

const schedulePost = async (postData, scheduledTime) => {
  // تخزين في قاعدة البيانات للتنفيذ لاحقًا
  const scheduledPost = await db.scheduledPosts.create({
    message: postData.message,
    platforms: postData.platforms,
    scheduledTime: scheduledTime,
    status: 'pending',
    media: postData.media,
    link: postData.link
  });

  // إعداد قائمة انتظار المهام
  await jobQueue.add('publish-social-post', {
    postId: scheduledPost.id
  }, {
    delay: scheduledTime - Date.now()
  });

  return scheduledPost;
};

// معالج المهام
jobQueue.process('publish-social-post', async (job) => {
  const post = await db.scheduledPosts.findById(job.data.postId);

  try {
    const result = await createSocialPost(post);

    await db.scheduledPosts.update(post.id, {
      status: 'published',
      publishedAt: new Date(),
      results: result
    });

    return result;
  } catch (error) {
    await db.scheduledPosts.update(post.id, {
      status: 'failed',
      error: error.message
    });

    throw error;
  }
});

التحليلات والتقارير

جلب تحليلات متعددة المنصات

تجميع المقاييس من جميع المنصات:

const getSocialAnalytics = async (accountId, dateRange) => {
  const analytics = {
    facebook: await getFacebookAnalytics(accountId.facebook, dateRange),
    twitter: await getTwitterAnalytics(accountId.twitter, dateRange),
    linkedin: await getLinkedInAnalytics(accountId.linkedin, dateRange),
    instagram: await getInstagramAnalytics(accountId.instagram, dateRange)
  };

  // تجميع المقاييس
  const totals = {
    impressions: sum(analytics, 'impressions'),
    engagement: sum(analytics, 'engagement'),
    clicks: sum(analytics, 'clicks'),
    shares: sum(analytics, 'shares'),
    comments: sum(analytics, 'comments'),
    newFollowers: sum(analytics, 'newFollowers')
  };

  return { analytics, totals };
};

// رؤى فيسبوك
const getFacebookAnalytics = async (pageId, dateRange) => {
  const token = await getFacebookPageToken(pageId);

  const metrics = [
    'page_impressions_unique',
    'page_engaged_users',
    'page_post_engagements',
    'page_clicks',
    'page_fan_adds'
  ];

  const params = new URLSearchParams({
    metric: metrics.join(','),
    since: dateRange.from,
    until: dateRange.until,
    access_token: token
  });

  const response = await fetch(
    `https://graph.facebook.com/v18.0/${pageId}/insights?${params.toString()}`
  );

  return response.json();
};

// تحليلات تويتر
const getTwitterAnalytics = async (userId, dateRange) => {
  const token = await getTwitterToken();

  const response = await fetch(
    `https://api.twitter.com/2/users/${userId}/metrics/private`,
    {
      headers: { 'Authorization': `Bearer ${token}` }
    }
  );

  return response.json();
};

// تحليلات لينكد إن
const getLinkedInAnalytics = async (organizationId, dateRange) => {
  const token = await getLinkedInToken();

  const response = await fetch(
    `https://api.linkedin.com/v2/organizationalEntityFollowerStatistics?q=organizationalEntity&organizationalEntity=${organizationId}`,
    {
      headers: { 'Authorization': `Bearer ${token}` }
    }
  );

  return response.json();
};

// رؤى انستغرام
const getInstagramAnalytics = async (igAccountId, dateRange) => {
  const token = await getInstagramToken();

  const metrics = [
    'impressions',
    'reach',
    'engagement',
    'profile_views',
    'follower_count'
  ];

  const params = new URLSearchParams({
    metric: metrics.join(','),
    period: 'day',
    since: dateRange.from,
    until: dateRange.until
  });

  const response = await fetch(
    `https://graph.facebook.com/v18.0/${igAccountId}/insights?${params.toString()}`,
    {
      headers: { 'Authorization': `Bearer ${token}` }
    }
  );

  return response.json();
};

function sum(analytics, metric) {
  return Object.values(analytics).reduce((total, platform) => {
    return total + (platform.data?.[metric] || 0);
  }, 0);
}

إدارة الفريق

التحكم في الوصول المستند إلى الأدوار

const TEAM_ROLES = {
  ADMIN: 'admin',
  MANAGER: 'manager',
  CONTRIBUTOR: 'contributor',
  VIEWER: 'viewer'
};

const ROLE_PERMISSIONS = {
  [TEAM_ROLES.ADMIN]: ['create', 'read', 'update', 'delete', 'manage_team', 'billing'],
  [TEAM_ROLES.MANAGER]: ['create', 'read', 'update', 'approve_posts'],
  [TEAM_ROLES.CONTRIBUTOR]: ['create', 'read'],
  [TEAM_ROLES.VIEWER]: ['read']
};

const checkPermission = (userRole, requiredPermission) => {
  const permissions = ROLE_PERMISSIONS[userRole] || [];
  return permissions.includes(requiredPermission);
};

تحديد المعدل

حدود المعدل للمنصات

المنصة	الحد الأقصى	النافذة الزمنية
فيسبوك جراف	200 مكالمة	في الساعة لكل مستخدم
تويتر API v2	300 تغريدة	لكل 15 دقيقة
لينكدإن	100-500 مكالمة	في اليوم
انستغرام	200 مكالمة	في الساعة

تطبيق معالجة حدود المعدل

class SocialMediaRateLimiter {
  constructor() {
    this.limits = {
      facebook: { limit: 200, window: 3600000 },
      twitter: { limit: 300, window: 900000 },
      linkedin: { limit: 500, window: 86400000 },
      instagram: { limit: 200, window: 3600000 }
    };
    this.counters = {};
  }

  async request(platform, endpoint, options) {
    await this.waitForCapacity(platform);

    const response = await fetch(endpoint, options);
    this.incrementCounter(platform);

    return response;
  }

  async waitForCapacity(platform) {
    const limit = this.limits[platform];
    const counter = this.counters[platform] || { count: 0, resetTime: Date.now() };

    if (Date.now() > counter.resetTime + limit.window) {
      counter.count = 0;
      counter.resetTime = Date.now();
    }

    if (counter.count >= limit.limit) {
      const waitTime = counter.resetTime + limit.window - Date.now();
      await new Promise(resolve => setTimeout(resolve, waitTime));
    }

    this.counters[platform] = counter;
  }

  incrementCounter(platform) {
    if (!this.counters[platform]) {
      this.counters[platform] = { count: 0, resetTime: Date.now() };
    }
    this.counters[platform].count++;
  }
}

قائمة التحقق من النشر للإنتاج

قبل الإطلاق الفعلي:

[ ] تطبيق OAuth 2.0 لجميع المنصات
[ ] تخزين الرموز المميزة (tokens) بأمان مع التشفير
[ ] إعداد تحديث تلقائي للرموز المميزة
[ ] تطبيق تحديد المعدل لكل منصة
[ ] إضافة معالجة شاملة للأخطاء
[ ] إعداد تسجيل جميع استدعاءات واجهة برمجة التطبيقات (API calls)
[ ] إنشاء سير عمل للموافقة على المنشورات
[ ] تطبيق الإشراف على المحتوى
[ ] إعداد تجميع التحليلات
[ ] إنشاء آليات نشر احتياطية

حالات الاستخدام في العالم الحقيقي

لوحة تحكم لوسائل التواصل الاجتماعي

وكالة تسويق تبني لوحة تحكم موحدة:

التحدي: إدارة أكثر من 50 حساب عميل عبر منصات متعددة
الحل: لوحة تحكم مركزية مع إمكانية النشر متعدد المنصات
النتيجة: توفير 60% من الوقت، وحضور متسق للعلامة التجارية

توزيع المحتوى الآلي

ناشر يقوم بأتمتة مشاركة المقالات:

التحدي: المشاركة اليدوية للمحتوى الجديد
الحل: النشر التلقائي للمقالات الجديدة على جميع المنصات
النتيجة: توزيع فوري، زيادة حركة المرور الاجتماعية 3 أضعاف

الخاتمة

بينما تم إيقاف واجهة برمجة تطبيقات Hootsuite العامة، توفر واجهات برمجة تطبيقات المنصات الأصلية قدرات شاملة لإدارة وسائل التواصل الاجتماعي. النقاط الرئيسية:

تطبيق OAuth 2.0 لكل منصة على حدة
تختلف حدود المعدل بشكل كبير حسب المنصة
يتطلب النشر الموحد تطبيقات خاصة بالمنصة
يوفر تجميع التحليلات رؤى متعددة المنصات
Apidog يبسط اختبار API والتعاون بين الفرق

button

قسم الأسئلة الشائعة

هل ما زالت Hootsuite تمتلك واجهة برمجة تطبيقات (API)؟

أوقفت Hootsuite دعم واجهة برمجة تطبيقاتها العامة في عام 2024. استخدم واجهات برمجة تطبيقات المنصات الأصلية أو منصات الإدارة البديلة مثل Buffer، Sprout Social، أو Agorapulse.

كيف يمكنني النشر على عدة منصات في وقت واحد؟

طبق OAuth لكل منصة وأنشئ دالة نشر موحدة تستدعي واجهة برمجة تطبيقات كل منصة بشكل متوازٍ.

ما هي حدود المعدل لواجهات برمجة تطبيقات وسائل التواصل الاجتماعي؟

تختلف الحدود: فيسبوك (200/ساعة)، تويتر (300/15 دقيقة)، لينكدإن (100-500/يوم)، انستغرام (200/ساعة).

كيف أقوم بجدولة المنشورات؟

قم بتخزين المنشورات في قاعدة بيانات مع تحديد "scheduled_time" (وقت مجدول)، ثم استخدم قائمة انتظار المهام (مثل Bull، Agenda) للنشر في الوقت المجدول.

هل يمكنني الحصول على تحليلات من جميع المنصات؟

نعم، توفر كل منصة واجهات برمجة تطبيقات للتحليلات. قم بتجميع البيانات لتقارير متعددة المنصات.