MasukMulai uji coba gratis
easyCoexistence API resmi

Berikan agen OpenAI Agents SDK alat untuk Instagram, TikTok dan WhatsApp

Agen OpenAI Agents SDK mendapatkan alat untuk Instagram, TikTok, WhatsApp, dan saluran lainnya melalui MCPServerStreamableHttp yang mengarah ke https://easycoexistence.com/api/mcp, dengan OAuthClientProvider dari MCP Python SDK sebagai penangan autentikasinya. Filter alat mempersempit lebih dari 35 alat sesuai tugas, require_approval menahan publikasi sampai seseorang menyetujuinya, dan setiap panggilan mencapai jaringan melalui API resminya.

httpx2.Auth

Yang diterima MCPServerStreamableHttp di params["auth"] dengan MCP Python SDK v2; dengan v1 yang diterima adalah httpx.Auth.

mcp>=1.19.0,<3

Rentang paket mcp yang dibutuhkan Agents SDK, yang mencakup kedua versi utama MCP Python SDK.

interruptions

Daftar panggilan alat yang menunggu persetujuan pada eksekusi yang dijeda, yang disetujui atau ditolak RunState sebelum Runner.run dilanjutkan.

Per request

Seberapa sering alat MCP Responses API harus dikirimi token OAuth-nya di authorization; OpenAI tidak menyimpan nilainya.

40 a minute

Panggilan yang diizinkan TikTok per akun terotorisasi di tiap endpoint Accounts API, termasuk balasan komentar.

Bagaimana agen Agents SDK terhubung ke easyCoexistence?

Lewat MCPServerStreamableHttp, dengan OAuthClientProvider dari MCP Python SDK di params["auth"]. Agents SDK meneruskan penangan itu ke klien HTTP yang dibangunnya, sehingga provider menemukan server otorisasi easyCoexistence, mendaftarkan agen Anda sebagai klien publik, menjalankan satu kali masuk di browser dengan PKCE, dan memperbarui token akses yang berlaku satu jam dengan refresh token. Contoh ini memakai MCP Python SDK v2, di mana penangan harus berupa httpx2.Auth, dan provider memang demikian. Objek penyimpanan menyimpan pendaftaran dan token antar-eksekusi; berkas di bawah menggantikan penyimpanan rahasia. create_static_tool_filter mendaftar alat yang boleh dilihat agen, dan require_approval menyebut alat yang menunggu seseorang.

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

Bagaimana menjaga publikasi tetap di balik persetujuan seseorang?

Dengan require_approval pada server, yang menjeda run sebelum alat bernama dijalankan. Run kemudian kembali dengan interruptions alih-alih jawaban akhir: ubah hasilnya menjadi RunState, setujui atau tolak setiap panggilan yang tertunda, lalu panggil Runner.run lagi dengan agen dan state yang sama. Dengan always_approve dibiarkan False, setiap persetujuan berlaku untuk satu panggilan, sehingga agen tidak dapat memakai ulang persetujuan untuk unggahan kedua. Server tetap terbuka selama jeda karena perulangan berjalan di dalam blok async with-nya. Untuk peninjauan yang memakan waktu berjam-jam, SDK dapat menyimpan state sebagai JSON dan memuatnya kembali nanti dengan 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

Bagaimana komentar TikTok atau DM Instagram memulai run?

Lewat rute HTTPS milik Anda sendiri, karena agen hanya mendengar apa yang diminta dari server MCP. set_social_webhook_destination mengarahkan komentar, mention, dan DM sebuah akun ke rute itu dan mengembalikan kunci rahasia penandatanganan sekali saja; akun TikTok meneruskan komentar. Rute memeriksa X-EC-Signature, yaitu HMAC-SHA256 dari timestamp, titik, lalu body mentah, merespons dalam 8 detik milik easyCoexistence, dan memasukkan event ke antrean. Worker kemudian memanggil Runner.run dengan event sebagai input. Untuk DM, sesi yang dikunci pada akun dan pengirim menjaga percakapan tetap berlanjut; komentar TikTok hanya membutuhkan komentar dan videonya, sehingga dapat berjalan tanpa sesi itu.

Apa yang harus dikatakan instruksi agen tentang tiap jaringan?

Aturan yang diterapkan API tiap jaringan pada akun, ditulis di tempat model membacanya:

  • TikTok: reply_to_comment memposting secara publik dan membutuhkan ID video sebagai post_id; send_social_dm menolak akun TikTok.
  • Volume TikTok: hingga 40 panggilan per menit per akun di endpoint balasan, dan banyak balasan yang hampir sama dalam waktu singkat dapat disembunyikan sebagai spam.
  • DM Instagram: hanya membalas orang yang menulis dalam 24 jam terakhir, dengan teks UTF-8 maksimal 1,000 byte.
  • WhatsApp: send_message dalam 24 jam sejak pesan terakhir pelanggan, dan send_template dengan template yang disetujui di luar itu.
  • Waktu: scheduled_at menerima ISO 8601 dengan zona waktu, 1 menit hingga 90 hari ke depan, dan list_scheduled_posts menampilkan antrean.

Bisakah agen memakai HostedMCPTool, atau berjalan tanpa masuk?

Keduanya bisa, dengan trade-off. HostedMCPTool menyerahkan server ke Responses API, yang alat MCP-nya menerima token akses OAuth di authorization dan memintanya di setiap permintaan, karena OpenAI tidak menyimpannya; token akses easyCoexistence berlaku satu jam, jadi kode Anda memperbaruinya sebelum setiap run. Untuk tugas tanpa orang yang bisa masuk, lewati MCP: alat fungsi yang memanggil Partner API dengan kunci ec_live_ dapat mengantrekan postingan lewat POST /api/v1/channels/:id/posts dan mengambil token TikTok, YouTube, dan LinkedIn terbaru dari GET /api/v1/channels/:id?credentials=1, sementara aturan komentar dan otomatisasi membalas di easyCoexistence tanpa agen yang berjalan.

Kesalahan umum

  • Mempertahankan client_session_timeout_seconds 5 detik untuk publikasi. Publikasi menunggu API jaringan, sehingga panggilan yang lambat bisa habis waktu di agen setelah easyCoexistence sudah meneruskan postingan; beri waktu satu menit, dan periksa list_scheduled_posts sebelum mencoba lagi.
  • Mengirim external_id sebagai account_id. Alat menerima account_id, yaitu ID easyCoexistence untuk akun; external_id adalah ID akun di Instagram, TikTok, atau Facebook.
  • Menyetujui interruptions dalam perulangan tanpa orang di dalamnya. require_approval hanya melindungi publikasi bila seseorang, atau aturan yang Anda percaya, memutuskan setiap panggilan yang tertunda.
  • Memberi agen aktivitas akunnya sendiri. Instagram mengembalikan DM akun sebagai echoes dengan is_echo true dan balasan publiknya sebagai komentar baru; saring keduanya sebelum Runner.run.
Melakukan ini dengan EasyCoexistence

easyCoexistence memberi agen OpenAI Agents SDK Anda jangkauan ke pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn, dan saluran lainnya, masing-masing lewat API resminya: server MCP yang masuk dengan OAuth, event bertanda tangan untuk komentar dan DM, serta Partner API untuk tugas yang berjalan tanpa diawasi, dengan setiap koneksi dipantau 24/7. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah agen memerlukan kunci API dari easyCoexistence?

Tidak untuk MCP. Masuk dengan OAuth memberi agen token miliknya sendiri; kunci ec_live_ dari dasbor hanya untuk kode yang memanggil Partner API, bukan server MCP.

Bisakah agen yang sama membalas pesan WhatsApp?

Bisa, dengan alat nomornya: list_numbers untuk connection_id, send_message dalam 24 jam sejak pesan terakhir pelanggan, dan send_template di luar waktu itu. Panduan OpenAI Agents SDK untuk WhatsApp membahas penerimaan pesannya.

Model apa yang dipakai agen?

Model yang Anda berikan ke Agent. Alat MCP bekerja sama untuk model apa pun yang dijalankan SDK, pemakaian model ditagih oleh penyedianya, dan easyCoexistence menagih per koneksi.

Berapa biaya easyCoexistence untuk agen OpenAI Agents SDK?

US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, sama di tiap jaringan. Server MCP, event yang diteruskan, dan Partner API sudah termasuk, dan 3 hari pertama gratis.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada