تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

امنح وكيل OpenAI Agents SDK أدوات Instagram وTikTok وWhatsApp

يحصل وكيل OpenAI Agents SDK على قنوات Instagram وTikTok وWhatsApp وغيرها كأدوات عبر MCPServerStreamableHttp الموجّه إلى https://easycoexistence.com/api/mcp، ومعالج المصادقة فيه هو OAuthClientProvider من MCP Python SDK. يضيّق مرشّح الأدوات الأكثر من 35 أداة إلى ما تحتاجه المهمة، ويحجز require_approval النشر حتى يوافق عليه شخص، ويصل كل استدعاء إلى الشبكة عبر واجهة برمجة التطبيقات (API) الرسمية الخاصة بها.

httpx2.Auth

ما يقبله MCPServerStreamableHttp في params["auth"] مع MCP Python SDK الإصدار 2؛ وفي الإصدار 1 يقبل httpx.Auth.

mcp>=1.19.0,<3

نطاق حزمة mcp الذي تعتمد عليه Agents SDK، ويشمل الإصدارين الرئيسيين لـ MCP Python SDK.

interruptions

المكان الذي يسرد فيه التشغيل المتوقف استدعاءات الأدوات المنتظرة للموافقة، والتي يوافق عليها RunState أو يرفضها قبل أن يستأنف Runner.run.

Per request

كم مرة يجب إرسال رمز OAuth في authorization إلى أداة MCP في Responses API، ولا تخزّن OpenAI هذه القيمة.

40 a minute

عدد الطلبات التي يسمح بها TikTok لكل حساب مفوّض في كل نقطة نهاية (endpoint) من Accounts API، بما فيها الردود على التعليقات.

كيف يتصل وكيل Agents SDK بـ easyCoexistence؟

عبر MCPServerStreamableHttp، مع OAuthClientProvider من MCP Python SDK في params["auth"]. يمرّر Agents SDK هذا المعالج إلى عميل HTTP الذي ينشئه، فيكتشف المزوّد خادم التفويض الخاص بـ easyCoexistence، ويسجّل وكيلك كعميل عام، ويجري تسجيل دخول واحدًا عبر المتصفح باستخدام PKCE، ويجدّد رموز الوصول التي تدوم ساعة برمز التحديث. يستخدم المثال الإصدار 2 من MCP Python SDK، حيث يجب أن يكون المعالج من نوع httpx2.Auth، وهذا ما عليه المزوّد. يحتفظ كائن التخزين بالتسجيل والرموز بين التشغيلات، والملف أدناه يحلّ محل مخزن الأسرار. تسرد create_static_tool_filter الأدوات التي قد يراها الوكيل، ويسمّي require_approval الأدوات التي تنتظر شخصًا.

The MCP server, signed in over OAuth, with a filter and approvals
import json, webbrowser
from pathlib import Path
from urllib.parse import parse_qs, urlparse

from pydantic import AnyUrl
from mcp.client.auth import AuthorizationCodeResult, OAuthClientProvider
from mcp.shared.auth import OAuthClientInformationFull, OAuthClientMetadata, OAuthToken
from agents.mcp import MCPServerStreamableHttp, create_static_tool_filter

URL = "https://easycoexistence.com/api/mcp"
SAVED = Path("easycoexistence-oauth.json")  # a secret store in production

class SavedSignIn:  # the MCP SDK's TokenStorage: registration and tokens survive restarts
    def _read(self) -> dict:
        return json.loads(SAVED.read_text()) if SAVED.exists() else {}
    def _write(self, key: str, model) -> None:
        data = self._read()
        data[key] = model.model_dump(mode="json")
        SAVED.write_text(json.dumps(data))
    async def get_tokens(self):
        t = self._read().get("tokens")
        return OAuthToken(**t) if t else None
    async def set_tokens(self, tokens): self._write("tokens", tokens)
    async def get_client_info(self):
        c = self._read().get("client")
        return OAuthClientInformationFull(**c) if c else None
    async def set_client_info(self, info): self._write("client", info)

async def open_sign_in(url: str) -> None:
    webbrowser.open(url)

async def code_from_redirect() -> AuthorizationCodeResult:
    q = parse_qs(urlparse(input("Address after sign-in: ")).query)
    return AuthorizationCodeResult(code=q["code"][0], state=q["state"][0])

oauth = OAuthClientProvider(
    server_url=URL,
    client_metadata=OAuthClientMetadata(
        client_name="Social desk agent",  # shown on easyCoexistence's consent screen
        redirect_uris=[AnyUrl("http://localhost:3030/callback")],
        scope="mcp",
    ),
    storage=SavedSignIn(),
    redirect_handler=open_sign_in,
    callback_handler=code_from_redirect,
)

PUBLISH = ["publish_instagram_post", "publish_tiktok_post", "publish_facebook_post"]

def easycoexistence() -> MCPServerStreamableHttp:
    return MCPServerStreamableHttp(
        name="easyCoexistence",
        params={"url": URL, "auth": oauth, "timeout": 60},
        client_session_timeout_seconds=60,  # publishing waits on the network's API
        cache_tools_list=True,
        tool_filter=create_static_tool_filter(allowed_tool_names=[
            "list_social_accounts", "list_social_posts", "list_social_comments",
            "reply_to_comment", "list_scheduled_posts", *PUBLISH,
        ]),
        require_approval={"always": {"tool_names": PUBLISH}},
    )

كيف تبقي النشر خلف موافقة شخص؟

عبر require_approval على الخادم، الذي يوقف التشغيل قبل تنفيذ أداة مسماة. يعود التشغيل بعد ذلك بـ interruptions بدلًا من إجابة نهائية: حوّل النتيجة إلى RunState، ووافق على كل استدعاء معلّق أو ارفضه، ثم استدعِ Runner.run من جديد مع الوكيل نفسه والحالة. مع ترك always_approve على False، تغطي كل موافقة استدعاءً واحدًا فقط، فلا يستطيع الوكيل إعادة استخدام موافقة لمنشور ثانٍ. يبقى الخادم مفتوحًا أثناء التوقف لأن الحلقة تعمل داخل كتلة async with الخاصة به. لمراجعة تستغرق ساعات، يمكن للـ SDK تخزين الحالة كـ JSON وتحميلها لاحقًا بـ RunState.from_json.

Run the agent and resume it after each decision
from agents import Agent, Runner

RULES = "You run Acme's social accounts. Schedule posts with scheduled_at; TikTok replies are public."

async def run(task: str) -> str:
    async with easycoexistence() as server:
        agent = Agent(name="Social desk", instructions=RULES, mcp_servers=[server])
        result = await Runner.run(agent, task)
        while result.interruptions:  # a publish tool is waiting for a decision
            state = result.to_state()
            for item in result.interruptions:
                if await ask_a_person(item):  # your review screen, chat message or queue
                    state.approve(item, always_approve=False)
                else:
                    state.reject(item)
            result = await Runner.run(agent, state)
        return result.final_output

كيف يبدأ تعليق على TikTok أو رسالة مباشرة على Instagram تشغيلًا؟

عبر مسار HTTPS خاص بك، إذ لا يسمع الوكيل إلا ما يطلبه من خادم MCP. تُوجّه set_social_webhook_destination تعليقات الحساب وإشاراته ورسائله المباشرة إلى المسار، وتعيد مفتاح التوقيع مرة واحدة فقط، وحسابات TikTok تمرّر التعليقات. يتحقق المسار من X-EC-Signature، وهو HMAC-SHA256 يُحسب على الطابع الزمني، ثم نقطة، ثم الجسم الخام، ويستجيب خلال 8 ثوانٍ وهي المهلة في easyCoexistence، ثم يضع الحدث في الطابور. يستدعي عامل بعد ذلك Runner.run مع الحدث كمدخل. أما الرسائل المباشرة فتحافظ عليها جلسة مفتاحها الحساب والمرسل، أما تعليق TikTok فيحتاج التعليق وفيديوه فقط، لذا يمكن تشغيله دون جلسة.

ما القواعد التي ينبغي أن تذكرها تعليمات الوكيل لكل شبكة؟

القواعد التي تطبّقها واجهة كل شبكة على الحساب، مكتوبة حيث يقرؤها النموذج:

  • TikTok: يحتاج reply_to_comment إلى معرّف الفيديو post_id وينشر علنًا، أما send_social_dm فيرفض حسابات TikTok مطلقًا.
  • حجم TikTok: حتى 40 طلبًا في الدقيقة لكل حساب على endpoint الرد، وقد تُخفى الردود المتشابهة الكثيرة في وقت قصير بوصفها رسائل مزعجة.
  • رسائل Instagram المباشرة: ترد فقط على من راسل خلال آخر 24 ساعة، بنص UTF-8 لا يتجاوز 1,000 بايت.
  • WhatsApp: send_message خلال 24 ساعة من آخر رسالة للعميل، و send_template بقالب معتمد عند تجاوز ذلك.
  • التوقيت: يقبل scheduled_at صيغة ISO 8601 مع منطقة زمنية، ويكون بين دقيقة واحدة و90 يومًا مقدمًا، ويعرض list_scheduled_posts الطابور.

هل يمكن للوكيل استخدام HostedMCPTool، أو العمل دون تسجيل دخول؟

كلاهما ممكن، مع مفاضلات. يسلّم HostedMCPTool الخادم إلى Responses API، التي تأخذ رمز الوصول من OAuth في authorization وتحتاجه في كل طلب، لأن OpenAI لا تخزّنه؛ ورمز وصول easyCoexistence يدوم ساعة، لذا يجدّد كودك رمزًا قبل كل تشغيل. أما المهمة التي لا يوجد فيها شخص يسجّل الدخول، فتجاوز MCP: أدوات الدوال التي تستدعي Partner API بمفتاح ec_live_ يمكنها وضع المنشورات في الطابور عبر POST /api/v1/channels/:id/posts، وجلب رموز جديدة لـ TikTok وYouTube وLinkedIn عبر GET /api/v1/channels/:id?credentials=1، بينما تردّ قواعد التعليقات والأتمتة على easyCoexistence دون تشغيل أي وكيل.

الأخطاء الشائعة

  • إبقاء client_session_timeout_seconds على 5 ثوانٍ عند النشر. ينتظر النشر واجهة الشبكة، فقد يتوقف الاستدعاء البطيء في الوكيل بعد أن يكون easyCoexistence قد مرّر المنشور؛ امنح دقيقة واحدة، وراجع list_scheduled_posts قبل المحاولة من جديد.
  • تمرير external_id بدلًا من account_id. تأخذ الأدوات account_id، وهو معرّف الحساب في easyCoexistence، أما external_id فهو معرّف الحساب لدى الشبكة الأصلية.
  • الموافقة على الانقطاعات في حلقة دون شخص فيها. لا يحمي require_approval النشر إلا حين يقرّر إنسان، أو قاعدة تثق بها، في كل استدعاء معلّق.
  • تغذية الوكيل بنشاط الحساب نفسه. يُرجع Instagram رسائل الحساب المباشرة بوصفها ردودًا صدى مع is_echo بقيمة true، وردوده العلنية بوصفها تعليقات جديدة. قبل Runner.run، صفِّ الاثنين.
إنجاز ذلك باستخدام EasyCoexistence

يمنح easyCoexistence وكلاء OpenAI Agents SDK وصولًا إلى العملاء عبر WhatsApp وInstagram وFacebook وTikTok وYouTube وLinkedIn وقنوات أخرى، وتصل كل منها عبر API الرسمية الخاصة بها: خادم MCP يسجّل الدخول عبر OAuth، وأحداث موقّعة للتعليقات والرسائل المباشرة، وPartner API للمهام التي تعمل دون إشراف، مع مراقبة كل اتصال على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، تنخفض كلما أضفت اتصالات، وتشمل فترة تجريبية مجانية مدتها 3 أيام.

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

هل يحتاج الوكيل إلى مفتاح API من easyCoexistence؟

ليس في حالة MCP. يمنح تسجيل الدخول عبر OAuth الوكيل رموزه الخاصة، أما مفتاح ec_live_ من لوحة التحكم فيخص الكود الذي يستدعي Partner API فقط.

هل يستطيع الوكيل نفسه الرد على رسائل WhatsApp؟

نعم، بأدوات الرقم: list_numbers لجلب connection_id، وsend_message خلال 24 ساعة من آخر رسالة للعميل، وsend_template خارج تلك المدة. يشرح دليل OpenAI Agents SDK الخاص بـ WhatsApp كيفية استقبال الرسائل.

أي نموذج يستخدمه الوكيل؟

النموذج الذي تحدده للـ Agent. تعمل أدوات MCP بالطريقة نفسها مهما كان النموذج الذي يشغّله SDK، وتتولى الجهة المزوّدة للنموذج فوترة استخدامه، أما easyCoexistence فتحسب لكل اتصال.

كم تكلّف easyCoexistence وكيل OpenAI Agents SDK؟

من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، تنخفض كلما أضفت اتصالات، وبالسعر نفسه على كل شبكة. يشمل ذلك خادم MCP والأحداث الموقّعة وPartner API، وتتضمن فترة تجريبية مجانية مدتها 3 أيام.

تابع القراءة

أدوات Instagram وTikTok وWhatsApp لوكيل LangChainامنح وكيل LangChain أدوات MCP من easyCoexistence عبر OAuth للنشر والجدولة على Instagram وTikTok، والرد على تعليقاتهما، والإجابة عن الرسائل في Instagram وWhatsApp.امنح طاقم CrewAI أدوات Instagram وTikTok وWhatsAppيحصل وكلاء CrewAI على أدوات easyCoexistence عبر MCPServerHTTP ورمز وصول OAuth لنشر المنشورات والرد على المحادثات في Instagram وTikTok وWhatsApp.استخدام أدوات وسائل التواصل الاجتماعي في Vercel AI SDK: Instagram وTikTok وغيرهماأضف أدوات MCP من easyCoexistence إلى Vercel AI SDK عبر createMCPClient وOAuth، ثم انشر وجدول وردّ على Instagram وTikTok وغيرهما.الرد على تعليقات TikTok بالذكاء الاصطناعي في n8nسير عمل في n8n يرد على تعليقات TikTok بالذكاء الاصطناعي: أحداث موقّعة من easyCoexistence، ونموذج دردشة، وردّ علني عبر واجهة TikTok.تشغيل وكيل OpenAI Agents SDK على WhatsAppتشغيل وكيل OpenAI Agents SDK على رقم WhatsApp عبر Cloud API الرسمي من Meta، بجلسة لكل عميل مع بقاء الهاتف قيد الاستخدام.واجهة برمجة التطبيقات (API) للشبكات الاجتماعية لوكلاء الذكاء الاصطناعي: النشر والجدولة والرد والقياسواجهة API وخادم MCP لوكلاء الذكاء الاصطناعي للنشر والجدولة والرد وقراءة التحليلات على الشبكات الاجتماعية، عبر واجهة كل شبكة الرسمية.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في