లాగిన్ చేయండిఉచిత ట్రయల్ ప్రారంభించండి
easyCoexistence అధికారిక APIలు

OpenAI Agents SDK ఏజెంట్‌కు Instagram, TikTok మరియు WhatsApp టూల్స్ ఇవ్వండి

OpenAI Agents SDK ఏజెంట్‌కు Instagram, TikTok, WhatsApp మరియు ఇతర ఛానెళ్లు టూల్స్‌గా అందుతాయి; ఇవి https://easycoexistence.com/api/mcp కు సూచించిన MCPServerStreamableHttp ద్వారా చేరుతాయి, ప్రమాణీకరణ హ్యాండ్లర్‌గా 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

పాజ్ అయిన రన్ ఆమోదం కోసం వేచి ఉన్న టూల్ కాల్స్‌ను ఎక్కడ చూపుతుందో, వాటిని RunState ఆమోదించవచ్చు లేదా తిరస్కరించవచ్చు, తర్వాత Runner.run తిరిగి కొనసాగుతుంది.

Per request

Responses API యొక్క MCP టూల్‌కు OAuth టోకెన్‌ను authorization లో ఎంత తరచుగా పంపాలి; OpenAI ఆ విలువను నిల్వ చేయదు.

40 a minute

ప్రతి అధికారం పొందిన ఖాతాకు Accounts API ఎండ్‌పాయింట్‌పై TikTok అనుమతించే కాల్స్, కామెంట్ రిప్లైలతో సహా.

OpenAI 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 తో, ఇది పేరు పెట్టిన టూల్ అమలయ్యే ముందు రన్‌ను ఆపుతుంది. అప్పుడు రన్ తుది సమాధానం బదులు అంతరాయాలు (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 ఒక ఖాతా యొక్క కామెంట్‌లు, మెన్షన్‌లు మరియు DMలను ఆ రూట్‌కు సూచిస్తుంది మరియు సైనింగ్ సీక్రెట్‌ను ఒకసారి తిరిగి ఇస్తుంది; TikTok ఖాతాలు కామెంట్‌లను ఫార్వార్డ్ చేస్తాయి. రూట్ X-EC-Signature ను తనిఖీ చేస్తుంది, ఇది టైమ్‌స్టాంప్, చుక్క, మరియు రా బాడీ యొక్క HMAC-SHA256; easyCoexistence యొక్క 8 సెకన్ల లోపే స్పందించి ఈవెంట్‌ను క్యూలో ఉంచుతుంది. తర్వాత ఒక వర్కర్ ఈవెంట్‌ను ఇన్‌పుట్‌గా ఇచ్చి Runner.run ను కాల్ చేస్తాడు. DMల కోసం, ఖాతా మరియు పంపినవారిపై కీ చేసిన సెషన్ సంభాషణను కొనసాగిస్తుంది; TikTok కామెంట్‌కు కామెంట్ మరియు దాని వీడియో మాత్రమే అవసరం, కాబట్టి దానికి సెషన్ అవసరం లేకుండానే నడవగలదు.

ప్రతి నెట్‌వర్క్ గురించి ఏజెంట్ సూచనలు ఏమి చెప్పాలి?

ప్రతి నెట్‌వర్క్ API ఖాతాకు వర్తింపజేసే నియమాలు, మోడల్ చదివే చోట రాయబడ్డాయి:

  • TikTok: reply_to_comment పబ్లిక్‌గా పోస్ట్ చేస్తుంది, దానికి post_id గా వీడియో ID అవసరం; send_social_dm TikTok ఖాతాలను తిరస్కరిస్తుంది.
  • TikTok వాల్యూమ్: రిప్లై ఎండ్‌పాయింట్‌పై ప్రతి ఖాతాకు నిమిషానికి 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_ కీతో 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.
  • మానవ ప్రమేయం లేకుండా లూప్‌లో అంతరాయాలను ఆమోదించడం. 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 మరియు దాని వెలుపల 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 టూల్స్ ఇవ్వండిOAuth ద్వారా LangChain ఏజెంట్‌కు easyCoexistence MCP టూల్స్ ఇవ్వండి: Instagram, TikTok లో పోస్ట్, షెడ్యూల్, కామెంట్ రిప్లై, Instagram, WhatsApp DMలకు సమాధానం.CrewAI క్రూకు Instagram, TikTok, WhatsApp టూల్స్ ఇవ్వండిCrewAI ఏజెంట్లు MCPServerHTTP ద్వారా easyCoexistence MCP టూల్స్ పొందుతారు; OAuth బేరర్ టోకెన్‌తో Instagram, TikTok మరియు WhatsApp లో పోస్ట్ చేసి ప్రతిస్పందించవచ్చు.Vercel AI SDK లో సోషల్ మీడియా టూల్స్: Instagram, TikTok మరియు మరిన్నిcreateMCPClient, OAuth తో Vercel AI SDK లో easyCoexistence MCP టూల్స్ వాడి 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 పర్యవేక్షణ

ధృవీకరించిన తేదీ