Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Dajte LangChain agentu alate za Instagram, TikTok i WhatsApp

LangChain agent dobija Instagram, TikTok, WhatsApp i još kanala kao alate sa easyCoexistence MCP servera na https://easycoexistence.com/api/mcp, koje učitava MCPAdapter, LangChain-ov MCP klijent, dok FastMCP vodi prijavu preko OAuth-a. create_agent zatim može da objavljuje i zakazuje objave, odgovara na komentare i DM-ove i čita uvide preko zvaničnog API-ja svake mreže, dok potpisani događaji u vašu rutu donose nove komentare i poruke.

Beta

LangChain-ova oznaka za njegov prostor imena langchain.mcp, koji zahteva langchain[mcp] 1.4.0 ili noviji i uvodi FastMCP.

In memory

Gde FastMCP čuva OAuth tokene ako token_storage ne navede pozadinski sistem, pa restart znači ponovnu prijavu.

127.0.0.1

Loopback adresa privremenog povratnog servera koji FastMCP pokreće za prijavu u pregledaču, na slobodnom portu ili na callback_port.

60 days

Koliko traje easyCoexistence MCP refresh token; pristupni tokeni traju sat vremena, a svako osvežavanje izdaje novi par.

8 seconds

Koliko easyCoexistence čeka da vaša ruta odgovori na prosleđeni komentar ili DM; šalje se jednom i nikad se ne ponavlja.

Koje alate LangChain agent dobija od easyCoexistence-a?

Više od 50, kao obični LangChain alati koje create_agent može da poziva. Društveni alati uzimaju account_id, pa agent počinje sa list_social_accounts i prosleđuje njegove ID-jeve za objavljivanje, čitanje i odgovore na komentare, njihovo sakrivanje i čitanje uvida. Alati vezani za jednu mrežu nose njen naziv, poput publish_tiktok_post ili upload_youtube_video, a WhatsApp broj počinje od list_numbers, koji vraća connection_id koji send_message i send_template prihvataju. Opis svakog alata nosi pravila te mreže, pa model uči, na primer, da je odgovor na TikTok uvek javan. Zakazivanje objave traži još jedan argument: scheduled_at stavlja objavu u red za čekanje easyCoexistence-a.

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

Kako se agent prijavljuje u easyCoexistence?

Pomoću FastMCP-ovog OAuth pomoćnika, koji MCPAdapter koristi za autentifikaciju. Pri prvom pokretanju on otkriva easyCoexistence-ov autorizacioni server, registruje se kao klijent, otvara pregledač na ekranu za saglasnost, gde se prikazuje njegov client_name, i prima kod na lokalnom povratnom pozivu na 127.0.0.1. Posle toga pristupni tokeni se osvežavaju bez pregledača. Tokeni stoje u memoriji osim ako pomoćnik ne dobije pozadinski sistem za token_storage, pa primer čuva tokene na disku, šifrovane Fernet ključem. Filtrirajte listu pre nego što create_agent to vidi: alati drže MCP klijent, pa agent radi i dalje nakon što se blok async with zatvori.

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)

Kako komentari i DM-ovi stižu do LangChain agenta?

Kao potpisani POST zahtevi na vašu rutu, jer MCP odgovara samo na pozive koje agent pravi. Svaki nalog usmerite ka ruti pomoću set_social_webhook_destination, koji se jednom zadaje agentu ili pokreće iz Claude-a ili ChatGPT-ja, i sačuvajte signing_secret koji vrati. Instagram i Facebook prosleđuju komentare, pominjanja i DM-ove, a TikTok prosleđuje komentare; svaki događaj nosi platform, account_id, external_id i unos te mreže. Ruta proverava X-EC-Signature, odmah odgovara, jer easyCoexistence čeka 8 sekundi i nikad ne ponavlja pokušaj, i događaj predaje agentu u pozadini. Checkpointer sa thread_id po pošiljaocu DM-a čuva istoriju razgovora.

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

Šta svaka mreža dozvoljava agentu?

Ono što API mreže dozvoljava nalogu, što uputstva agenta treba jasno da navedu:

  • Instagram i Messenger DM-ovi: send_social_dm odgovara ljudima koji su pisali u poslednja 24 sata, a Instagram ograničava DM na 1.000 bajtova UTF-8.
  • Odgovori na komentare: reply_to_comment odgovara javno, a uz private postavljeno na true šalje jedan DM po komentaru na Instagramu ili Facebooku u roku od 7 dana od njega.
  • TikTok: odgovori su uvek javni i zahtevaju ID videa kao post_id, a na TikToku nema DM-ova.
  • WhatsApp: send_message radi u roku od 24 sata od poslednje poruke korisnika, a send_template sa odobrenim šablonom van tog roka.
  • Mediji: svaki fajl se nalazi na javnom HTTPS linku; Instagram prihvata JPEG slike, a TikTok foto objave JPEG ili WebP.

Kada kod treba da poziva mreže bez agenta?

Kada korak mora uvek da se odvija na isti način ili kada nikoga nema da se prijavi. get_social_credentials agentu daje API osnovu naloga, njegov ID na mreži i, na TikToku, YouTubeu i LinkedInu, token koji važi upravo sada, a Partner API vraća isto preko GET /api/v1/channels/:id?credentials=1 uz ključ ec_live_, pa Python posao može direktno da poziva TikTok, Google ili LinkedIn. Odgovori koji moraju da izađu u bilo koje doba bez agenta, poput fiksnog teksta za ključnu reč, uklapaju se u pravila za komentare i automatizacije, koje easyCoexistence sam vodi.

Česte greške

  • Odgovaranje na događaje koje je nalog sam izazvao. Instagram vraća sopstvene DM-ove naloga sa is_echo postavljenim na true, a javne odgovore vraća kao komentare, pa ih izbacite pre nego što ih agent vidi, inače odgovara sam sebi.
  • Pokretanje agenta pre nego što ruta odgovori. easyCoexistence čeka 8 sekundi na 2xx i nikad ne ponavlja, pa obrađivač koji čeka model gubi događaj; prvo odgovorite, pa radite u pozadini.
  • Pozivanje reply_to_comment za TikTok komentar bez post_id. TikTokov odgovor imenuje i video i komentar, pa prosledite video_id događaja kao post_id.
  • Davanje agentu za odgovore alata za objavljivanje. Filtrirajte listu po imenu pre create_agent, da pogrešno pročitan komentar ne može da objavi objavu, obriše je ili promeni automatizaciju.
Ovo radite uz EasyCoexistence

easyCoexistence daje vašim LangChain agentima pristup kupcima na WhatsAppu, Instagramu, Facebooku, TikToku, YouTubeu, LinkedInu i još kanala, svaki preko zvaničnog API-ja: jedan MCP server iza OAuth prijave, potpisani događaji o komentarima i DM-ovima i red koji zakazuje objave do 90 dana unapred, uz praćenje svake veze 24/7. Od US$ 9 do US$ 0,75 po vezi mesečno, sa padom kako dodajete veze, uz besplatni probni period od 3 dana.

Često postavljana pitanja

Da li agentu treba sopstvena Meta, TikTok ili Google aplikacija za programere?

Ne. Nalozi se povezuju preko easyCoexistence-ove sopstvene aplikacije na svakoj mreži, u kontrolnoj tabli ili preko Partner API linka za povezivanje, a agent do svih njih dolazi kroz jednu easyCoexistence prijavu.

Može li agent da zakazuje objave umesto da ih objavi odmah?

Može. publish_instagram_post, publish_facebook_post, publish_tiktok_post i publish_linkedin_post uzimaju scheduled_at, ISO 8601 vreme sa vremenskom zonom od 1 minuta do 90 dana unapred. YouTube zakazuje izvorno uz upload_youtube_video i publish_at.

Koji modeli mogu da pokreću agenta?

Svaki model za chat koji create_agent može da koristi sa alatima. MCP alati ne zavise od modela, a dobavljač modela naplaćuje sopstvenu potrošnju; easyCoexistence naplaćuje po vezi, nikad po pozivu alata.

Koliko košta easyCoexistence za LangChain agenta?

Od US$ 9 do US$ 0,75 po vezi mesečno, sa padom kako dodajete veze, isto na svakoj mreži. MCP server, prosleđeni događaji i Partner API su uključeni, a besplatni probni period traje 3 dana.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na