लॉग इनमोफत ट्रायल सुरू करा
easyCoexistence अधिकृत एपीआय

OpenAI Agents SDK एजंटला Instagram, TikTok आणि WhatsApp टूल्स द्या

OpenAI Agents SDK एजंटला Instagram, TikTok, WhatsApp आणि इतर चॅनेल टूल्स म्हणून मिळतात, MCPServerStreamableHttp द्वारे https://easycoexistence.com/api/mcp या पत्त्याकडे निर्देशित करून, आणि प्रमाणीकरण हँडलर म्हणून 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

Agents SDK ज्या mcp पॅकेजच्या श्रेणीवर अवलंबून आहे, ती MCP Python SDK च्या दोन्ही मुख्य आवृत्त्या समाविष्ट करते.

interruptions

थांबलेला रन कोणते टूल कॉल मंजुरीची वाट पाहत आहेत ते दाखवतो; Runner.run पुन्हा सुरू होण्यापूर्वी RunState त्यांना मंजूर किंवा नाकारते.

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 क्लायंटला देतो, त्यामुळे प्रोव्हायडर easyCoexistence चा प्राधिकरण सर्व्हर शोधतो, तुमच्या एजंटची पब्लिक क्लायंट म्हणून नोंदणी करतो, PKCE सह एकदाच ब्राउझरमधून साइन-इन चालवतो आणि एक तासाचे ॲक्सेस टोकन रिफ्रेश टोकनने रिफ्रेश करतो. उदाहरण MCP Python SDK v2 वापरते, जिथे हँडलर 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 द्वारे, जे नामांकित टूल चालण्यापूर्वी रन थांबवते. त्यानंतर निकाल अंतिम उत्तराऐवजी व्यत्यय घेऊन परत येतो: निकाल 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 एका खात्याच्या कमेंट, मेन्शन आणि DM ला राऊटकडे निर्देशित करतो आणि साइनिंग सीक्रेट एकदाच परत देतो; TikTok खाती कमेंट पुढे पाठवतात. राऊट X-EC-Signature तपासतो, म्हणजे टाइमस्टॅम्प, एक ठिपका आणि कच्च्या बॉडीचा HMAC-SHA256; easyCoexistence च्या 8 सेकंदांच्या आत प्रतिसाद देतो आणि इव्हेंट रांगेत ठेवतो. त्यानंतर वर्कर इव्हेंट इनपुट म्हणून देऊन Runner.run कॉल करतो. DM साठी खाते आणि पाठवणाऱ्याच्या आधारे ठरवलेले सेशन संभाषण पुढे चालू ठेवते; TikTok कमेंटला फक्त कमेंट आणि त्याचा व्हिडिओ लागतो, त्यामुळे ती त्याशिवायही चालू शकते.

एजंटच्या सूचनांमध्ये प्रत्येक नेटवर्कबद्दल काय असावे?

प्रत्येक नेटवर्कचे API खात्यावर लागू करणारे नियम, मॉडेल वाचते तिथे लिहिलेले:

  • TikTok: reply_to_comment सार्वजनिकरित्या पोस्ट करतो आणि व्हिडिओचा ID post_id म्हणून लागतो; send_social_dm TikTok खात्यांना नकार देतो.
  • TikTok मर्यादा: प्रत्येक खात्यावर reply एंडपॉइंटवर प्रति मिनिट 40 कॉलपर्यंत, आणि कमी वेळात जवळजवळ सारखी अनेक उत्तरे स्पॅम म्हणून लपवली जाऊ शकतात.
  • Instagram DM: फक्त गेल्या 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 वगळा: ec_live_ की असलेली फंक्शन टूल्स 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 आहे.
  • लूपमध्ये कोणी माणूस नसताना व्यत्यय आपोआप मंजूर करणे. require_approval प्रकाशनाचे संरक्षण तेव्हाच करतो जेव्हा प्रत्येक प्रलंबित कॉलवर एखादी व्यक्ती, किंवा तुम्ही विश्वास ठेवलेला नियम, निर्णय घेतो.
  • एजंटला खात्याची स्वतःची क्रिया देणे. Instagram खात्याचे DM is_echo true सह इको म्हणून आणि सार्वजनिक उत्तरे नवीन कमेंट म्हणून परत देते; Runner.run पूर्वी दोन्ही गाळा.
EasyCoexistence सोबत हे करताना

easyCoexistence तुमच्या OpenAI Agents SDK एजंटना WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn आणि इतर चॅनेलवर ग्राहकांपर्यंत पोहोच देते, प्रत्येक नेटवर्क त्याच्या अधिकृत API द्वारे: OAuth ने साइन इन करणारा MCP सर्व्हर, कमेंट आणि DM साठी सही केलेले इव्हेंट, आणि विनापर्यवेक्षण चालणाऱ्या कामांसाठी 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, आणि 24 तासांनंतर send_template. मेसेज मिळवण्याची माहिती OpenAI Agents SDK च्या WhatsApp मार्गदर्शकात आहे.

एजंट कोणते मॉडेल वापरतो?

तुम्ही Agent ला दिलेले. MCP टूल्स SDK कोणते मॉडेल चालवतो त्यावर अवलंबून राहत नाहीत, मॉडेलचा वापर त्याच्या प्रदात्याकडून बिल होतो, आणि easyCoexistence कनेक्शननुसार शुल्क आकारते.

OpenAI Agents SDK एजंटसाठी easyCoexistence चा खर्च किती?

प्रति कनेक्शन प्रति महिना US$ 9 ते US$ 0.75, कनेक्शन वाढवत गेल्यास कमी होत जाणारी, प्रत्येक नेटवर्कवर एकसारखी. MCP सर्व्हर, पुढे पाठवलेले इव्हेंट आणि Partner API यात समाविष्ट आहेत, आणि पहिले 3 दिवस मोफत आहेत.

पुढे वाचा

LangChain एजंटला Instagram, TikTok आणि WhatsApp साठी टूल्स द्याLangChain एजंटला OAuth ने easyCoexistence चे MCP टूल्स द्या: Instagram व TikTok वर पोस्ट व शेड्यूल करा, कमेंट आणि Instagram व WhatsApp वरील DM ना उत्तर द्या.CrewAI क्रूला Instagram, TikTok आणि WhatsApp टूल्स द्याCrewAI एजंट MCPServerHTTP आणि OAuth टोकनद्वारे easyCoexistence चे MCP टूल्स वापरतात आणि Instagram, TikTok व WhatsApp वर पोस्ट करून उत्तर देतात.Vercel AI SDK मध्ये सोशल मीडिया टूल्स वापरा: Instagram, TikTok आणि इतरeasyCoexistence चे MCP टूल्स Vercel AI SDK मध्ये createMCPClient आणि OAuth ने जोडा, मग 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 दिवस मोफत
  • कधीही रद्द करा
  • फक्त अधिकृत एपीआय
  • 24/7 देखरेख

पडताळले: