Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Dajte agentu OpenAI Agents SDK alate za Instagram, TikTok i WhatsApp

Agent OpenAI Agents SDK-a dobiva Instagram, TikTok, WhatsApp i druge kanale kao alate putem MCPServerStreamableHttp usmjerenog na https://easycoexistence.com/api/mcp, uz MCP Python SDK-ov OAuthClientProvider kao rukovatelja autentifikacijom. Filtar alata sužava više od 35+ alata na potrebni posao, require_approval zadržava objave dok ih osoba ne odobri, a svaki poziv do mreže stiže preko službenog API-ja te mreže.

httpx2.Auth

Što MCPServerStreamableHttp prima u params["auth"] uz MCP Python SDK v2; uz v1 prima httpx.Auth.

mcp>=1.19.0,<3

Raspon verzije paketa mcp o kojem ovisi Agents SDK, koji obuhvaća obje glavne verzije MCP Python SDK-a.

interruptions

Gdje pauzirano izvođenje navodi pozive alata koji čekaju odobrenje, a RunState ih odobrava ili odbija prije nego Runner.run nastavi.

Per request

Koliko se često OAuth token mora slati u authorization polju MCP alata Responses API-ja; OpenAI tu vrijednost ne pohranjuje.

40 a minute

Koliko poziva TikTok dopušta po ovlaštenom računu na svakom Accounts API endpointu, uključujući odgovore na komentare.

Kako se agent Agents SDK-a povezuje s easyCoexistence?

Putem MCPServerStreamableHttp, uz MCP Python SDK-ov OAuthClientProvider u params["auth"]. Agents SDK proslijeđuje taj rukovatelj HTTP klijentu koji sam izgradi, pa provider otkriva autorizacijski poslužitelj sustava easyCoexistence, registrira vašeg agenta kao javnog klijenta, jednom provodi prijavu u pregledniku s PKCE-om i osvježava pristupne tokene koji vrijede sat vremena pomoću refresh tokena. Primjer koristi MCP Python SDK v2, gdje rukovatelj mora biti httpx2.Auth, što provider i jest. Objekt za pohranu čuva registraciju i tokene između izvođenja; datoteka u nastavku zamjenjuje tajnu pohranu. create_static_tool_filter navodi alate koje agent smije vidjeti, a require_approval imenuje one koji čekaju osobu.

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}},
    )

Kako objave držite iza odobrenja osobe?

Pomoću require_approval na poslužitelju, koji zaustavlja izvođenje prije nego se imenovani alat izvrši. Izvođenje se tada vraća s interruptions umjesto konačnog odgovora: pretvorite rezultat u RunState, odobrite ili odbijte svaki čekajući poziv i ponovno pozovite Runner.run s istim agentom i tim stanjem. Uz always_approve na False, svako „da“ pokriva jedan poziv, pa agent ne može ponovno upotrijebiti odobrenje za drugu objavu. Poslužitelj ostaje otvoren tijekom pauze jer petlja radi unutar njegova async with bloka. Za pregled koji traje satima SDK može spremiti stanje kao JSON i kasnije ga učitati pomoću 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

Kako komentar na TikToku ili DM na Instagramu pokreće izvođenje?

Preko vaše vlastite HTTPS rute, jer agent čuje samo ono što zatraži od MCP poslužitelja. set_social_webhook_destination usmjerava komentare, spominjanja i DM-ove računa na rutu i jednom vraća tajni ključ za potpisivanje; računi na TikToku prosljeđuju komentare. Ruta provjerava X-EC-Signature, HMAC-SHA256 od vremenske oznake, točke i sirovog tijela, odgovara unutar 8 sekundi koliko dopušta easyCoexistence i stavlja događaj u red. Radnik zatim poziva Runner.run s događajem kao ulazom. Za DM-ove sesija vezana uz račun i pošiljatelja održava razgovor; komentar na TikToku treba samo komentar i njegov video, pa može raditi i bez videa.

Što agentove upute trebaju reći o svakoj mreži?

Pravila koja API svake mreže primjenjuje na račun, zapisana tamo gdje ih model čita:

  • TikTok: reply_to_comment objavljuje javno i traži ID videa kao post_id; send_social_dm odbija TikTok račune.
  • Obujam na TikToku: do 40 poziva u minuti po računu na endpointu za odgovore, a mnogo gotovo identičnih odgovora u kratkom vremenu može biti sakriveno kao neželjena pošta.
  • Instagram DM-ovi: odgovara se samo osobama koje su pisale u posljednja 24 sata, u najviše 1.000 bajtova UTF-8 teksta.
  • WhatsApp: send_message unutar 24 sata od posljednje poruke kupca, inače send_template s odobrenim predloškom.
  • Vrijeme: scheduled_at prihvaća ISO 8601 s vremenskom zonom, od 1 minute do 90 dana unaprijed, a list_scheduled_posts prikazuje red čekanja.

Može li agent koristiti HostedMCPTool ili raditi bez prijave?

Oboje, uz kompromise. HostedMCPTool predaje poslužitelj Responses API-ju, čiji MCP alat uzima OAuth pristupni token u authorization i traži ga u svakom zahtjevu, jer OpenAI ga ne pohranjuje; pristupni token sustava easyCoexistence vrijedi sat vremena, pa ga vaš kod osvježava prije svakog izvođenja. Za posao bez nikoga tko bi se prijavio preskočite MCP: alati tipa function koji pozivaju Partner API s ključem ec_live_ mogu stavljati objave u red putem POST /api/v1/channels/:id/posts i dohvaćati svježe tokene za TikTok, YouTube i LinkedIn putem GET /api/v1/channels/:id?credentials=1, dok pravila za komentare i automatizacije odgovaraju u sustavu easyCoexistence bez pokrenutog agenta.

Uobičajene pogreške

  • Zadržavanje 5-sekundnog client_session_timeout_seconds za objave. Objava čeka API mreže, pa spor poziv može isteći u agentu nakon što je easyCoexistence već proslijedio objavu; dajte minutu i provjerite list_scheduled_posts prije ponovnog pokušaja.
  • Slanje external_id kao account_id. Alati uzimaju account_id, ID računa u sustavu easyCoexistence; external_id je vlastiti ID računa na Instagramu, TikToku ili Facebooku.
  • Odobravanje prekida u petlji bez osobe. require_approval štiti objave samo kada osoba ili pravilo kojem vjerujete odlučuje o svakom čekajućem pozivu.
  • Hranjenje agenta vlastitom aktivnošću računa. Instagram vraća DM-ove računa kao odjeke s is_echo true, a njegove javne odgovore kao nove komentare; filtrirajte oba prije Runner.run.
Radite ovo uz EasyCoexistence

easyCoexistence daje vašim agentima OpenAI Agents SDK-a doseg do kupaca na WhatsAppu, Instagramu, Facebooku, TikToku, YouTubeu, LinkedInu i drugim kanalima, svaki putem službenog API-ja: MCP poslužitelj koji se prijavljuje OAuth-om, potpisani događaji za komentare i DM-ove te Partner API za poslove koji rade bez stalnog nadzora, uz praćenje svake veze 24/7. Od US$ 9 do US$ 0,75 po vezi mjesečno, cijena pada kako dodajete veze, uz besplatno probno razdoblje od 3 dana.

Često postavljana pitanja

Treba li agentu API ključ easyCoexistence?

Za MCP ne. OAuth prijava izdaje agentu vlastite tokene; ključ ec_live_ iz nadzorne ploče namijenjen je samo kodu koji poziva Partner API umjesto MCP poslužitelja.

Može li isti agent odgovarati na WhatsApp poruke?

Može, uz alate za broj: list_numbers za connection_id, send_message unutar 24 sata od posljednje poruke kupca i send_template izvan tog razdoblja. Vodič OpenAI Agents SDK za WhatsApp pokriva primanje poruka.

Koji model agent koristi?

Onaj koji dodijelite Agentu. MCP alati rade jednako uz bilo koji model koji SDK pokreće, njegovu potrošnju naplaćuje pružatelj modela, a easyCoexistence naplaćuje po vezi.

Koliko košta easyCoexistence za agenta OpenAI Agents SDK-a?

Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad kako dodajete veze, jednako na svakoj mreži. MCP poslužitelj, prosljeđeni događaji i Partner API dolaze uz to, a prva 3 dana su besplatna.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na