IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Ipe wakala wa LangChain zana za Instagram, TikTok na WhatsApp

Wakala wa LangChain hupata Instagram, TikTok, WhatsApp na chaneli nyingine kama zana kutoka seva ya MCP ya easyCoexistence kwenye https://easycoexistence.com/api/mcp, zikipakiwa na MCPAdapter, mteja wa MCP wa LangChain, huku FastMCP ikiendesha kuingia kwa OAuth. create_agent kisha inaweza kuchapisha na kuratibu machapisho, kujibu maoni na DM, na kusoma takwimu kupitia API rasmi ya kila mtandao, huku matukio yaliyosainiwa yakileta maoni na ujumbe mpya kwenye njia yako.

Beta

Jina la LangChain kwa nafasi yake ya majina langchain.mcp, inayohitaji langchain[mcp] 1.4.0 au mpya zaidi, na inajumuisha FastMCP.

In memory

Mahali ambapo FastMCP huhifadhi token za OAuth isipokuwa token_storage itaje backend, kwa hiyo kuanzisha upya kunamaanisha kuingia tena.

127.0.0.1

Anwani ya loopback ya seva ya muda ya callback ambayo FastMCP huanzisha kwa kuingia kwenye kivinjari, kwenye bandari huru au callback_port.

60 days

Muda wa refresh token ya easyCoexistence MCP; access token huishi saa moja, na kila kuonyesha upya hutoa jozi mpya.

8 seconds

Muda ambao easyCoexistence husubiri njia yako ijibu maoni au DM iliyotumwa; hutumwa mara moja tu na haijaribiwi tena.

Ni zana zipi wakala wa LangChain hupata kutoka easyCoexistence?

Zaidi ya 50, kama zana za kawaida za LangChain ambazo create_agent inaweza kuziita. Zana za mitandao ya kijamii huchukua account_id, kwa hiyo wakala huanza na list_social_accounts na kupitisha vitambulisho vyake kwa zana za kuchapisha, kusoma, kujibu maoni, kuyaficha na kusoma takwimu. Zana zinazomilikiwa na mtandao mmoja hubeba jina lake, kama publish_tiktok_post au upload_youtube_video, na nambari ya WhatsApp huanza kutoka list_numbers, ambayo hurudisha connection_id ambayo send_message na send_template huchukua. Maelezo ya kila zana yana sheria za mtandao husika, hivyo modeli hujifunza, kwa mfano, kwamba jibu la TikTok ni la umma. Kuchapisha baadaye huchukua hoja moja zaidi: scheduled_at huweka chapisho kwenye foleni ya easyCoexistence.

Instagrampublish_instagram_post, reply_to_comment, send_social_dm, get_social_insights
TikTokpublish_tiktok_post, get_tiktok_publish_status, reply_to_comment with post_id
WhatsApplist_numbers, send_message, send_template, get_number_health
Facebookpublish_facebook_post, reply_to_comment, send_social_dm for Messenger
YouTube and LinkedInupload_youtube_video, reply_to_youtube_comment, publish_linkedin_post, get_linkedin_stats
The queuelist_scheduled_posts, update_scheduled_post, cancel_scheduled_post, retry_scheduled_post

Wakala huingiaje kwenye easyCoexistence?

Kwa msaidizi wa OAuth wa FastMCP, ambao MCPAdapter hutumia kwa uthibitishaji. Katika mara ya kwanza, hugundua seva ya idhini ya easyCoexistence, hujisajili kama mteja, hufungua kivinjari kwenye skrini ya idhini, ambapo client_name yake inaonekana, na kupokea msimbo kwenye callback ya ndani kwenye 127.0.0.1. Baada ya hapo, access token huonyeshwa upya bila kivinjari. Token huhifadhiwa kwenye kumbukumbu isipokuwa msaidizi apate backend ya token_storage, kwa hiyo mfano huu huziweka diskini, zikisimbwa kwa ufunguo wa Fernet. Chuja orodha kabla create_agent haijaiona: zana hushikilia mteja wa MCP, hivyo wakala unaendelea kufanya kazi baada ya kizuizi cha async with kufungwa.

A reply agent's tools, with a sign-in that survives restarts
import os

from cryptography.fernet import Fernet
from fastmcp import Client
from fastmcp.client.auth import OAuth
from key_value.aio.stores.disk import DiskStore
from key_value.aio.wrappers.encryption import FernetEncryptionWrapper
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

URL = "https://easycoexistence.com/api/mcp"

# Kept on disk and encrypted, so the browser sign-in happens once
oauth = OAuth(
    client_name="Acme reply agent",  # shown on easyCoexistence's consent screen
    callback_port=8765,
    token_storage=FernetEncryptionWrapper(
        key_value=DiskStore(directory="~/.easycoexistence/oauth"),
        fernet=Fernet(os.environ["TOKEN_KEY"]),
    ),
)

REPLY_TOOLS = {"list_social_accounts", "list_social_comments", "reply_to_comment",
               "hide_comment", "send_social_dm"}

RULES = (
    "You reply to comments and DMs for Acme, on the account_id in the event. "
    "TikTok replies are public and need the video ID as post_id. "
    "Never reply to the account's own messages or replies."
)

async def build_reply_agent(model: str):
    async with MCPAdapter(Client(URL, auth=oauth)) as adapter:
        tools = [t for t in await adapter.list_tools() if t.name in REPLY_TOOLS]
    return create_agent(model, tools, system_prompt=RULES)

Maoni na DM hufikaje kwa wakala wa LangChain?

Kama maombi ya POST yaliyosainiwa kwenda kwenye njia yako, kwa sababu MCP hujibu tu simu ambazo wakala hufanya. Elekeza kila akaunti kwenye njia kwa set_social_webhook_destination, ukimwomba wakala mara moja au ukiiendesha kutoka Claude au ChatGPT, na uhifadhi signing_secret inayorudishwa. Instagram na Facebook husambaza maoni, kutajwa na DM, na TikTok husambaza maoni; kila tukio hubeba platform, account_id, external_id na ingizo lake la mtandao husika. Njia hukagua X-EC-Signature, hujibu papo hapo, kwa sababu easyCoexistence husubiri sekunde 8 na haijaribu tena, kisha hukabidhi tukio kwa wakala chinichini. Checkpointer yenye thread_id kwa kila mtumaji wa DM huhifadhi historia ya mazungumzo.

A FastAPI route that verifies the event, then runs the agent
import hashlib, hmac, json, time

from fastapi import BackgroundTasks, FastAPI, HTTPException, Request

app = FastAPI()  # at startup: app.state.agent = await build_reply_agent("<MODEL>")
SECRETS: dict[str, str] = {}  # account_id -> signing_secret, kept in your database

def signed(raw: bytes, header: str, secret: str) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t, v1 = parts.get("t", ""), parts.get("v1", "")
    if not t.isdigit() or abs(time.time() - int(t)) > 300:
        return False
    mac = hmac.new(secret.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac.encode(), v1.encode())

@app.post("/hooks/social")
async def social_event(request: Request, background: BackgroundTasks):
    raw = await request.body()
    event = json.loads(raw)  # platform, account_id, external_id, entry
    secret = SECRETS.get(event.get("account_id", ""))
    if not secret or not signed(raw, request.headers.get("x-ec-signature", ""), secret):
        raise HTTPException(status_code=401)
    background.add_task(reply, event)  # runs after the response is sent
    return {"received": True}

async def reply(event: dict) -> None:
    prompt = json.dumps(event)  # the agent reads the platform, the account and the entry
    await app.state.agent.ainvoke({"messages": [{"role": "user", "content": prompt}]})

Kila mtandao unamruhusu wakala kufanya nini?

Kile API ya mtandao inachoruhusu akaunti, ambacho maelekezo ya wakala yanapaswa kukisema waziwazi:

  • DM za Instagram na Messenger: send_social_dm hujibu watu walioandika ndani ya saa 24 zilizopita, na Instagram hupunguza DM hadi baiti 1,000 za UTF-8.
  • Majibu ya maoni: reply_to_comment hujibu hadharani, au private ikiwa true hutuma DM moja kwa kila maoni ya Instagram au Facebook ndani ya siku 7 tangu yaliandikwa.
  • TikTok: majibu daima ni ya umma na yanahitaji ID ya video kama post_id, na hakuna DM kwenye TikTok.
  • WhatsApp: send_message hufanya kazi ndani ya saa 24 tangu ujumbe wa mwisho wa mteja, na send_template yenye kiolezo kilichoidhinishwa nje ya muda huo.
  • Midia: kila faili liko kwenye kiungo cha umma cha HTTPS; Instagram hupokea picha za JPEG, na machapisho ya picha ya TikTok hupokea JPEG au WebP.

Lini msimbo uite mitandao bila wakala?

Wakati hatua inapaswa kutokea kwa njia ile ile kila wakati, au bila mtu wa kuingia. get_social_credentials humpa wakala msingi wa API wa akaunti, kitambulisho chake kwenye mtandao na, kwenye TikTok, YouTube na LinkedIn, token inayofanya kazi sasa, na Partner API hurudisha vilevile kutoka GET /api/v1/channels/:id?credentials=1 kwa ufunguo wa ec_live_, hivyo kazi ya Python inaweza kuita TikTok, Google au LinkedIn moja kwa moja. Majibu yanayopaswa kutumwa wakati wowote bila wakala, kama maandishi yaliyowekwa kwa neno kuu, yanafaa kwa sheria za maoni na otomatiki, ambazo easyCoexistence huziendesha yenyewe.

Makosa ya kawaida

  • Kujibu matukio yaliyosababishwa na akaunti yenyewe. Instagram hurudisha DM za akaunti kwa is_echo kuwa true na hurudisha majibu yake ya umma kama maoni, kwa hiyo yaondoe kabla wakala hajayaona, la sivyo atajijibu mwenyewe.
  • Kuendesha wakala kabla njia haijajibu. easyCoexistence husubiri sekunde 8 kwa 2xx na haijaribu tena, kwa hiyo kidhibiti kinachosubiri modeli hupoteza tukio; jibu kwanza, fanya kazi chinichini.
  • Kuita reply_to_comment kwa maoni ya TikTok bila post_id. Jibu la TikTok linataja video pamoja na maoni, kwa hiyo pitisha video_id ya tukio kama post_id.
  • Kumpa wakala wa majibu zana za kuchapisha. Chuja orodha kwa jina kabla create_agent, ili maoni yaliyosomwa vibaya yasiweze kuchapisha chapisho, kulifuta au kubadilisha otomatiki.
Kufanya hili ukitumia EasyCoexistence

easyCoexistence huwapa mawakala wako wa LangChain uwezo wa kufikia wateja kwenye WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn na chaneli nyingine nyingi, kila moja kupitia API yake rasmi: seva moja ya MCP nyuma ya kuingia kwa OAuth, matukio yaliyosainiwa ya maoni na DM, na foleni inayoweza kuchapisha hadi siku 90 mbele, huku kila muunganisho ukifuatiliwa 24/7. Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kadri unavyoongeza muunganisho, na siku 3 za kwanza ni bure.

Maswali yanayoulizwa mara kwa mara

Je, wakala anahitaji programu yake ya msanidi ya Meta, TikTok au Google?

Hapana. Akaunti huunganishwa kupitia programu rasmi ya easyCoexistence kwenye kila mtandao, kwenye dashboard au kupitia kiungo cha kuunganisha cha Partner API, na wakala anazifikia zote kupitia kuingia mmoja wa easyCoexistence.

Je, wakala anaweza kupanga machapisho badala ya kuchapisha mara moja?

Ndiyo. publish_instagram_post, publish_facebook_post, publish_tiktok_post na publish_linkedin_post huchukua scheduled_at, muda wa ISO 8601 wenye saa za eneo kutoka dakika 1 hadi siku 90 mbele. YouTube hupanga yenyewe kwa upload_youtube_video na publish_at.

Ni modeli zipi zinaweza kuendesha wakala?

Modeli yoyote ya mazungumzo ambayo create_agent inaweza kutumia pamoja na zana. Zana za MCP hazitegemei modeli, na mtoa huduma wa modeli hutoza matumizi yake; easyCoexistence hutoza kwa kila muunganisho, si kwa kila wito wa zana.

easyCoexistence inagharimu kiasi gani kwa wakala wa LangChain?

Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kadri unavyoongeza muunganisho, na ni sawa kwenye kila mtandao. Seva ya MCP, matukio yaliyosambazwa na Partner API vimejumuishwa, na siku 3 za kwanza ni bure.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye