لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

OpenAI Agents SDK کے ایجنٹ کو Instagram، TikTok اور WhatsApp کے ٹولز دیں

OpenAI Agents SDK کا ایجنٹ MCPServerStreamableHttp کے ذریعے https://easycoexistence.com/api/mcp سے جڑ کر Instagram، TikTok، WhatsApp اور دیگر چینلز کو ٹولز کے طور پر حاصل کرتا ہے، جبکہ اس کا auth ہینڈلر MCP Python SDK کا OAuthClientProvider ہے۔ ٹول فلٹر 35 سے زیادہ ٹولز کو کام کے مطابق محدود کرتا ہے، require_approval پبلشنگ کو کسی شخص کی منظوری تک روکے رکھتا ہے، اور ہر کال اپنے سرکاری API کے ذریعے نیٹ ورک تک پہنچتی ہے۔

httpx2.Auth

MCP Python SDK v2 کے ساتھ MCPServerStreamableHttp params["auth"] میں کیا لیتا ہے؛ v1 کے ساتھ یہ httpx.Auth لیتا ہے۔

mcp>=1.19.0,<3

وہ mcp پیکج رینج جس پر Agents SDK انحصار کرتا ہے، جو MCP Python SDK کے دونوں بڑے ورژنز کا احاطہ کرتی ہے۔

interruptions

وہ جگہ جہاں روکا گیا رن منظوری کے منتظر ٹول کالز کی فہرست دکھاتا ہے، جنہیں RunState منظور یا مسترد کرتا ہے، اس سے پہلے کہ Runner.run دوبارہ شروع ہو۔

Per request

Responses API کے MCP ٹول کو اپنا OAuth ٹوکن authorization میں کتنی بار بھیجنا ضروری ہے؛ OpenAI یہ قدر محفوظ نہیں کرتا۔

40 a minute

TikTok ہر مجاز اکاؤنٹ کے لیے ہر Accounts API اینڈ پوائنٹ پر کتنی کالز کی اجازت دیتا ہے، جن میں کمنٹ کے جوابات بھی شامل ہیں۔

Agents SDK کا ایجنٹ easyCoexistence سے کیسے جڑتا ہے؟

MCPServerStreamableHttp کے ذریعے، جس کے params["auth"] میں MCP Python SDK کا OAuthClientProvider ہوتا ہے۔ Agents SDK یہ ہینڈلر اس HTTP کلائنٹ کو دیتا ہے جو وہ بناتا ہے، چنانچہ provider easyCoexistence کا authorization سرور تلاش کرتا ہے، آپ کے ایجنٹ کو ایک public کلائنٹ کے طور پر رجسٹر کرتا ہے، PKCE کے ساتھ ایک بار براؤزر سائن ان چلاتا ہے، اور ایک گھنٹے والے رسائی ٹوکنز کو refresh ٹوکن سے تازہ کرتا ہے۔ مثال MCP Python SDK v2 استعمال کرتی ہے، جہاں ہینڈلر کو httpx2.Auth ہونا لازمی ہے، اور provider ایسا ہی ہے۔ ایک storage آبجیکٹ رجسٹریشن اور ٹوکنز کو رنز کے درمیان محفوظ رکھتا ہے؛ نیچے کی فائل ایک secret store کی جگہ لیتی ہے۔ 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 DM سے رن کیسے شروع ہوتا ہے؟

آپ کے اپنے HTTPS روٹ کے ذریعے، کیونکہ ایجنٹ صرف وہی سنتا ہے جو وہ MCP سرور سے مانگتا ہے۔ set_social_webhook_destination کسی اکاؤنٹ کے کمنٹس، mentions اور DMs کو اس روٹ پر بھیجتا ہے اور ایک بار signing secret واپس کرتا ہے؛ TikTok اکاؤنٹس کمنٹس فارورڈ کرتے ہیں۔ روٹ X-EC-Signature کی جانچ کرتا ہے، یعنی timestamp، ایک نقطہ اور خام body کا HMAC-SHA256، 8 سیکنڈ کے اندر جواب دیتا ہے، جو easyCoexistence کی حد ہے، اور ایونٹ کو قطار میں ڈال دیتا ہے۔ اس کے بعد ایک worker ایونٹ کو ان پٹ کے طور پر دے کر Runner.run کال کرتا ہے۔ DMs کے لیے، اکاؤنٹ اور بھیجنے والے پر مبنی سیشن گفتگو جاری رکھتا ہے؛ TikTok کمنٹ کو صرف کمنٹ اور اس کی ویڈیو درکار ہوتی ہے، اس لیے وہ اس کے بغیر بھی چل سکتا ہے۔

ایجنٹ کی ہدایات میں ہر نیٹ ورک کے بارے میں کیا لکھا جائے؟

ان اصولوں کو جو ہر نیٹ ورک کا API اکاؤنٹ پر لاگو کرتا ہے، ایسی جگہ لکھیں جہاں ماڈل انہیں پڑھتا ہے:

  • TikTok: reply_to_comment عوامی طور پر پوسٹ کرتا ہے اور ویڈیو کا ID بطور post_id چاہتا ہے؛ send_social_dm TikTok اکاؤنٹس کو مسترد کرتا ہے
  • TikTok حجم: reply اینڈ پوائنٹ پر فی اکاؤنٹ 40 کالز فی منٹ تک، اور کم وقت میں بہت سے ملتے جلتے جوابات کو اسپام کے طور پر چھپایا جا سکتا ہے
  • Instagram DMs: صرف ان لوگوں کو جواب دیں جنہوں نے پچھلے 24 گھنٹوں میں لکھا ہو، اور زیادہ سے زیادہ 1,000 بائٹس UTF-8 متن میں
  • WhatsApp: گاہک کے آخری میسج کے 24 گھنٹوں کے اندر send_message، ورنہ منظور شدہ ٹیمپلیٹ کے ساتھ send_template
  • وقت: scheduled_at ٹائم زون کے ساتھ ISO 8601 فارمیٹ میں، ابھی سے 1 منٹ تا 90 دن آگے تک لیتا ہے، اور list_scheduled_posts قطار دکھاتا ہے

کیا ایجنٹ HostedMCPTool استعمال کر سکتا ہے، یا سائن ان کے بغیر چل سکتا ہے؟

دونوں ممکن ہیں، مگر ہر ایک کی اپنی قیمت ہے۔ HostedMCPTool سرور کو Responses API کے حوالے کرتا ہے، جس کا MCP ٹول authorization میں OAuth رسائی ٹوکن لیتا ہے اور ہر درخواست میں اسے چاہتا ہے، کیونکہ OpenAI اسے محفوظ نہیں کرتا؛ easyCoexistence کا رسائی ٹوکن ایک گھنٹہ چلتا ہے، اس لیے آپ کا کوڈ ہر رن سے پہلے ایک تازہ کرتا ہے۔ ایسے کام کے لیے جس میں سائن ان کرنے والا کوئی نہ ہو، MCP چھوڑ دیں: function ٹولز جو ec_live_ کلید کے ساتھ Partner API کو کال کرتے ہیں، POST /api/v1/channels/:id/posts کے ذریعے پوسٹس قطار میں ڈال سکتے ہیں اور GET /api/v1/channels/:id?credentials=1 سے تازہ TikTok، YouTube اور LinkedIn ٹوکنز لے سکتے ہیں، جبکہ کمنٹ کے قواعد اور آٹومیشنز بغیر کسی ایجنٹ کے چلتے ہوئے easyCoexistence پر جواب دیتے ہیں۔

عام غلطیاں

  • 5 سیکنڈ والا client_session_timeout_seconds پبلشنگ کے لیے رکھنا۔ پبلش کال نیٹ ورک کے API کا انتظار کرتی ہے، اس لیے سست کال ایجنٹ میں ٹائم آؤٹ ہو سکتی ہے جب easyCoexistence پوسٹ آگے بھیج چکا ہو؛ ایک منٹ دیں، اور دوبارہ کوشش سے پہلے list_scheduled_posts چیک کریں
  • external_id کو account_id کے طور پر پاس کرنا۔ ٹولز account_id لیتے ہیں، یعنی easyCoexistence کا اکاؤنٹ ID؛ external_id Instagram، TikTok یا Facebook پر اکاؤنٹ کا اپنا ID ہے
  • کسی انسان کے بغیر لوپ میں ہر interruption کو منظور کرنا۔ require_approval پبلشنگ کی حفاظت صرف تب کرتا ہے جب ہر زیر التوا کال پر کوئی انسان، یا آپ کا قابلِ اعتماد قاعدہ، فیصلہ کرے
  • ایجنٹ کو اکاؤنٹ کی اپنی سرگرمی دینا۔ Instagram DMs کو is_echo true کے ساتھ echoes کے طور پر، اور اکاؤنٹ کے عوامی جوابات کو نئے کمنٹس کے طور پر واپس کرتا ہے؛ Runner.run سے پہلے دونوں کو فلٹر کریں
EasyCoexistence کے ساتھ یہ کام کرنا

easyCoexistence آپ کے OpenAI Agents SDK ایجنٹس کو WhatsApp، Instagram، Facebook، TikTok، YouTube، LinkedIn اور مزید چینلز تک رسائی دیتا ہے، ہر ایک اپنے سرکاری API کے ذریعے: OAuth سے سائن ان کرنے والا MCP سرور، کمنٹس اور DMs کے دستخط شدہ ایونٹس، اور بغیر نگرانی والے کاموں کے لیے Partner API، جس میں ہر کنکشن 24/7 مانیٹر ہوتا ہے۔ فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، کنکشن بڑھنے کے ساتھ کم ہوتی ہوئی، اور پہلے 3 دن مفت۔

اکثر پوچھے جانے والے سوالات

کیا ایجنٹ کو easyCoexistence سے API کلید چاہیے؟

MCP کے لیے نہیں۔ OAuth سائن ان ایجنٹ کو اپنے ٹوکنز جاری کرتا ہے؛ ڈیش بورڈ سے ec_live_ کلید صرف اس کوڈ کے لیے ہے جو MCP سرور کے بجائے Partner API کو کال کرتا ہے۔

کیا وہی ایجنٹ WhatsApp میسجز کا جواب دے سکتا ہے؟

ہاں، نمبر کے ٹولز کے ساتھ: connection_id کے لیے list_numbers، گاہک کے آخری میسج کے 24 گھنٹوں کے اندر send_message، اور اس کے باہر send_template۔ WhatsApp کے لیے OpenAI Agents SDK گائیڈ میسجز وصول کرنے کو کور کرتی ہے۔

ایجنٹ کون سا ماڈل استعمال کرتا ہے؟

وہی جو آپ Agent کو دیں۔ MCP ٹولز SDK کے چلانے والے کسی بھی ماڈل کے ساتھ یکساں کام کرتے ہیں، ماڈل کا استعمال اس کا فراہم کنندہ بل کرتا ہے، اور easyCoexistence فی کنکشن چارج کرتا ہے۔

OpenAI Agents SDK ایجنٹ کے لیے easyCoexistence کی قیمت کتنی ہے؟

فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، کنکشن بڑھنے کے ساتھ کم ہوتی ہوئی، ہر نیٹ ورک پر یکساں۔ MCP سرور، فارورڈ کیے گئے ایونٹس اور Partner API اس میں شامل ہیں، اور پہلے 3 دن مفت ہیں۔

مزید پڑھیں

LangChain ایجنٹ کو Instagram، TikTok اور WhatsApp کے ٹولز دیںLangChain ایجنٹ کو easyCoexistence کے MCP ٹولز OAuth سے دیں: Instagram اور TikTok پر پوسٹ اور شیڈول کریں، کمنٹس کے جواب اور Instagram و WhatsApp کے DM سنبھالیں۔CrewAI کریو کو Instagram، TikTok اور WhatsApp کے ٹولز فراہم کریںCrewAI ایجنٹس MCPServerHTTP اور OAuth بیئر ٹوکن کے ذریعے easyCoexistence کے ٹولز لیتے ہیں تاکہ Instagram، TikTok اور WhatsApp پر پوسٹ اور جواب دے سکیں۔Vercel AI SDK میں سوشل میڈیا ٹولز استعمال کریں: Instagram، TikTok اور مزیدeasyCoexistence کے MCP ٹولز کو createMCPClient اور OAuth سے Vercel AI SDK میں جوڑیں، پھر Instagram اور TikTok پر پوسٹ، شیڈول اور جواب دیں۔n8n میں AI سے TikTok کمنٹس کا جواب دیںایک n8n ورک فلو جو AI سے TikTok کمنٹس کا جواب دیتا ہے: easyCoexistence کے سائن شدہ کمنٹ ایونٹس، چیٹ ماڈل اور TikTok کے API کے ذریعے عوامی جواب۔OpenAI Agents SDK ایجنٹ کو WhatsApp پر چلائیںMeta کی سرکاری Cloud API سے اپنے WhatsApp نمبر پر OpenAI Agents SDK ایجنٹ چلائیں۔ ہر کسٹمر کا الگ سیشن، اور فون بھی چلتا رہے۔AI ایجنٹس کے لیے سوشل میڈیا API: شائع کریں، شیڈول کریں، جواب دیں اور پیمائش کریںAI ایجنٹس کے لیے ایک API اور MCP سرور، جو سوشل نیٹ ورکس پر شائع کرنے، شیڈول کرنے، جواب دینے اور اینالیٹکس پڑھنے دیتا ہے، ہر نیٹ ورک کے سرکاری API سے۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ