Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Oferiți unui agent LangChain unelte pentru Instagram, TikTok și WhatsApp

Un agent LangChain primește Instagram, TikTok, WhatsApp și alte canale ca unelte de la serverul MCP al easyCoexistence, la https://easycoexistence.com/api/mcp, încărcat de MCPAdapter, clientul MCP al LangChain, iar FastMCP se ocupă de autentificarea OAuth. Apoi create_agent poate publica și programa postări, răspunde la comentarii și DM-uri și citi statisticile prin API-ul oficial al fiecărei rețele, în timp ce evenimentele semnate aduc comentariile și mesajele noi către ruta dumneavoastră.

Beta

Eticheta LangChain pentru spațiul de nume langchain.mcp, care necesită langchain[mcp] 1.4.0 sau o versiune ulterioară și aduce FastMCP.

In memory

Unde FastMCP păstrează token-urile OAuth dacă token_storage nu indică un backend, deci o repornire înseamnă să vă autentificați din nou.

127.0.0.1

Adresa de loopback a serverului temporar de callback pe care FastMCP îl pornește pentru autentificarea din browser, pe un port liber sau pe callback_port.

60 days

Cât durează un token de reîmprospătare MCP easyCoexistence; token-urile de acces durează o oră, iar fiecare reîmprospătare emite o pereche nouă.

8 seconds

Cât așteaptă easyCoexistence ca ruta dumneavoastră să răspundă la un comentariu sau DM redirecționat; se trimite o singură dată și nu se reîncearcă niciodată.

Ce unelte primește un agent LangChain de la easyCoexistence?

Peste 50, ca unelte LangChain obișnuite pe care create_agent le poate apela. Uneltele sociale iau un account_id, deci agentul începe cu list_social_accounts și transmite ID-urile către uneltele de publicare, citire și răspuns la comentarii, de ascundere a acestora și de citire a statisticilor. Uneltele care țin de o singură rețea poartă numele ei, precum publish_tiktok_post sau upload_youtube_video, iar un număr WhatsApp pornește de la list_numbers, care returnează connection_id pe care îl iau send_message și send_template. Descrierea fiecărei unelte conține regulile rețelei, astfel încât modelul află, de exemplu, că un răspuns pe TikTok este public. Programarea unei postări cere un argument în plus: scheduled_at pune postarea în coada 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

Cum se autentifică agentul în easyCoexistence?

Cu utilitarul OAuth al FastMCP, pe care MCPAdapter îl folosește pentru autentificare. La prima rulare, agentul descoperă serverul de autorizare al easyCoexistence, se înregistrează ca client, deschide browserul la ecranul de consimțământ, unde se afișează client_name, și primește codul printr-un callback local la 127.0.0.1. După aceea, token-urile de acces se reîmprospătează fără browser. Token-urile rămân în memorie, dacă utilitarul nu primește un backend token_storage, deci exemplul le păstrează pe disc, criptate cu o cheie Fernet. Filtrați lista înainte ca create_agent să o vadă: uneltele țin clientul MCP, deci agentul continuă să funcționeze după ce blocul async with se închide.

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)

Cum ajung comentariile și DM-urile la un agent LangChain?

Ca cereri POST semnate către o rută a dumneavoastră, deoarece MCP răspunde doar apelurilor făcute de agent. Indicați fiecare cont către rută cu set_social_webhook_destination, cerut agentului o singură dată sau rulat din Claude ori ChatGPT, și păstrați signing_secret pe care îl returnează. Instagram și Facebook redirecționează comentariile, mențiunile și DM-urile, iar TikTok redirecționează comentariile; fiecare eveniment conține platform, account_id, external_id și intrarea proprie a rețelei. Ruta verifică X-EC-Signature, răspunde imediat, deoarece easyCoexistence așteaptă 8 secunde și nu reîncearcă, și predă evenimentul agentului în fundal. Un checkpointer cu un thread_id pentru fiecare expeditor de DM păstrează istoricul conversației.

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

Ce are voie agentul să facă pe fiecare rețea?

Ce permite API-ul rețelei contului, lucru pe care instrucțiunile agentului ar trebui să-l spună clar:

  • DM-uri pe Instagram și Messenger: send_social_dm răspunde persoanelor care au scris în ultimele 24 de ore, iar Instagram limitează un DM la 1,000 de octeți UTF-8.
  • Răspunsuri la comentarii: reply_to_comment răspunde public, sau, cu private setat la true, trimite un singur DM pentru fiecare comentariu de pe Instagram sau Facebook, în termen de 7 zile de la comentariu.
  • TikTok: răspunsurile sunt întotdeauna publice și au nevoie de ID-ul videoclipului drept post_id, iar pe TikTok nu există DM-uri.
  • WhatsApp: send_message funcționează în 24 de ore de la ultimul mesaj al clientului, iar send_template cu un șablon aprobat funcționează în afara acestui interval.
  • Media: fiecare fișier se află la un link public HTTPS; Instagram acceptă imagini JPEG, iar postările foto de pe TikTok acceptă JPEG sau WebP.

Când ar trebui codul să apeleze rețelele fără agent?

Atunci când un pas trebuie să se întâmple mereu în același mod sau când nu este nimeni care să se autentifice. get_social_credentials îi oferă agentului baza API a unui cont, ID-ul său pe rețea și, pe TikTok, YouTube și LinkedIn, un token valid chiar acum, iar Partner API returnează același lucru din GET /api/v1/channels/:id?credentials=1 cu o cheie ec_live_, astfel încât un job Python poate apela direct TikTok, Google sau LinkedIn. Răspunsurile care trebuie trimise la orice oră, fără agent, cum ar fi un text fix pentru un cuvânt cheie, se potrivesc regulilor de comentarii și automatizărilor, pe care easyCoexistence le rulează singur.

Greșeli frecvente

  • Răspunsul la evenimente produse de cont. Instagram repetă DM-urile contului cu is_echo setat la true și returnează răspunsurile publice ca comentarii, deci eliminați-le înainte ca agentul să le vadă, altfel ajunge să-și răspundă singur.
  • Rularea agentului înainte ca ruta să răspundă. easyCoexistence așteaptă 8 secunde un răspuns 2xx și nu reîncearcă niciodată, deci un handler care așteaptă modelul pierde evenimentul; răspundeți mai întâi, apoi lucrați în fundal.
  • Apelarea reply_to_comment pentru un comentariu TikTok fără post_id. Răspunsul de pe TikTok numește și videoclipul, pe lângă comentariu, deci transmiteți video_id-ul evenimentului drept post_id.
  • Acordarea uneltelor de publicare unui agent de răspuns. Filtrați lista după nume înainte de create_agent, astfel încât un comentariu citit greșit să nu poată publica, șterge o postare sau modifica o automatizare.
Faceți acest lucru cu EasyCoexistence

easyCoexistence oferă agenților dumneavoastră LangChain acces la clienții de pe WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn și alte canale, fiecare prin API-ul său oficial: un server MCP în spatele unei autentificări OAuth, evenimente semnate pentru comentarii și DM-uri și o coadă care programează postări cu până la 90 de zile înainte, cu fiecare conexiune monitorizată 24/7. US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, iar primele 3 zile sunt gratuite.

Întrebări frecvente

Are nevoie agentul de propria aplicație de dezvoltator Meta, TikTok sau Google?

Nu. Conturile se conectează prin aplicația proprie a easyCoexistence pe fiecare rețea, din panou sau printr-un link de conectare al Partner API, iar agentul le ajunge pe toate printr-o singură autentificare easyCoexistence.

Poate agentul să programeze postări în loc să publice imediat?

Da. publish_instagram_post, publish_facebook_post, publish_tiktok_post și publish_linkedin_post iau scheduled_at, o oră ISO 8601 cu fus orar, de la 1 minut până la 90 de zile înainte. YouTube programează nativ cu upload_youtube_video și publish_at.

Ce modele pot rula agentul?

Orice model de chat pe care create_agent îl poate folosi cu unelte. Uneltele MCP nu depind de model, iar furnizorul modelului își facturează propria utilizare; easyCoexistence taxează pe conexiune, niciodată pe apel de unealtă.

Cât costă easyCoexistence pentru un agent LangChain?

US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, și același pe fiecare rețea. Serverul MCP, evenimentele redirecționate și Partner API sunt incluse, iar primele 3 zile sunt gratuite.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la