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

Dajte LangChain agentu Instagram, TikTok i WhatsApp alate

LangChain agent dobiva Instagram, TikTok, WhatsApp i druge kanale kao alate s easyCoexistence MCP poslužitelja na https://easycoexistence.com/api/mcp, koje učitava MCPAdapter, LangChainov MCP klijent, a prijavu putem OAuth-a vodi FastMCP. create_agent zatim može objavljivati i zakazivati objave, odgovarati na komentare i DM-ove te čitati uvide kroz službeni API svake mreže, dok potpisani događaji dovode nove komentare i poruke na vašu rutu.

Beta

LangChainova oznaka za njegov prostor imena langchain.mcp, za koji je potreban langchain[mcp] 1.4.0 ili noviji i koji uvodi FastMCP.

In memory

Mjesto na kojem FastMCP čuva OAuth tokene ako token_storage ne navede pozadinsku pohranu, pa ponovno pokretanje znači ponovnu prijavu.

127.0.0.1

Povratna adresa privremenog poslužitelja za povratni poziv koji FastMCP pokreće za prijavu u pregledniku, na slobodnom priključku ili callback_port.

60 days

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

8 seconds

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

Koje alate LangChain agent dobiva od easyCoexistencea?

Više od 50, kao obični LangChain alati koje create_agent može pozvati. Društveni alati uzimaju account_id, pa agent počinje s list_social_accounts i prosljeđuje njegove ID-ove alatima za objavu, čitanje i odgovaranje na komentare, njihovo skrivanje i čitanje uvida. Alati vezani uz jednu mrežu nose njezin naziv, kao publish_tiktok_post ili upload_youtube_video, a WhatsApp broj kreće s list_numbers, koji vraća connection_id što preuzimaju send_message i send_template. Opis svakog alata nosi pravila te mreže, pa model uči, primjerice, da je odgovor na TikToku uvijek javan. Objava kasnije uzima još jedan argument: scheduled_at stavlja objavu u red čekanja easyCoexistencea.

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ćnikom za OAuth iz FastMCP-a, koji MCPAdapter koristi za autentifikaciju. Pri prvom pokretanju otkriva easyCoexistenceov autorizacijski poslužitelj, registrira se kao klijent, otvara preglednik na zaslonu za pristanak, gdje se prikazuje njegov client_name, i prima kod na lokalnom povratnom pozivu na 127.0.0.1. Nakon toga se pristupni tokeni osvježavaju bez preglednika. Tokeni ostaju u memoriji osim ako pomoćnik ne dobije pozadinsku pohranu token_storage, pa primjer čuva tokene na disku, šifrirane Fernet ključem. Filtrirajte popis prije nego create_agent to vidi: alati drže MCP klijenta, pa agent radi i 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 zahtjevi na vašu rutu, jer MCP odgovara samo na pozive koje agent sam šalje. Svaki račun usmjerite na rutu pomoću set_social_webhook_destination, što agentu zatražite jednom ili pokrenete iz Claudea ili ChatGPT-ja, i čuvajte signing_secret koji vrati. Instagram i Facebook proslijeđuju komentare, spominjanja i DM-ove, a TikTok proslijeđuje komentare; svaki događaj nosi platform, account_id, external_id i unos te mreže. Ruta provjerava X-EC-Signature, odmah odgovara, jer easyCoexistence čeka 8 sekundi i ne ponavlja, te događaj predaje agentu u pozadini. Checkpointer s thread_id-em po pošiljatelju DM-a čuva povijest 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}]})

Što svaka mreža dopušta agentu?

Ono što API mreže dopušta računu. Upute agenta to trebaju jasno navesti:

  • Instagram i Messenger DM-ovi: send_social_dm odgovara osobama koje su pisale u posljednja 24 sata, a Instagram ograničava DM na 1.000 bajtova UTF-8.
  • Odgovori na komentare: reply_to_comment odgovara javno, a s private postavljenim na true šalje jednu DM poruku po komentaru na Instagramu ili Facebooku, unutar 7 dana od njega.
  • TikTok: odgovori su uvijek javni i trebaju ID videa kao post_id, a na TikToku nema DM-ova.
  • WhatsApp: send_message radi unutar 24 sata od posljednje poruke korisnika, a send_template s odobrenim predloškom izvan tog roka.
  • Medijske datoteke: svaka datoteka nalazi se na javnoj HTTPS poveznici; Instagram prihvaća JPEG slike, a TikTok fotoobjave JPEG ili WebP.

Kada kod treba zvati mreže bez agenta?

Kada se korak mora odvijati uvijek na isti način ili kada nitko nije tu da se prijavi. get_social_credentials agentu predaje osnovnu adresu API-ja računa, njegov ID na mreži i, na TikToku, YouTubeu i LinkedInu, token koji vrijedi upravo sada, a Partner API vraća isto s GET /api/v1/channels/:id?credentials=1 uz ključ ec_live_, pa Python posao može izravno pozivati TikTok, Google ili LinkedIn. Odgovori koji moraju otići u bilo koje doba bez agenta, poput fiksnog teksta za ključnu riječ, pripadaju pravilima za komentare i automatizacijama, koje easyCoexistence pokreće sam.

Uobičajene pogreške

  • Odgovaranje na događaje koje je račun sam izazvao. Instagram vraća DM-ove računa s is_echo postavljenim na true i javne odgovore kao komentare, pa ih izbacite prije nego ih agent vidi, inače će odgovarati sam sebi.
  • Pokretanje agenta prije nego ruta odgovori. easyCoexistence čeka 8 sekundi na 2xx i nikad ne ponavlja, pa rukovatelj koji čeka model gubi događaj; prvo odgovorite, zatim radite u pozadini.
  • Pozivanje reply_to_comment za TikTok komentar bez post_id. TikTokov odgovor imenuje i video i komentar, pa predajte video_id događaja kao post_id.
  • Davanje agentu za odgovore alata za objavljivanje. Filtrirajte popis po imenu prije create_agent, da pogrešno pročitan komentar ne može objaviti, obrisati objavu ili promijeniti automatizaciju.
Radite ovo uz EasyCoexistence

easyCoexistence vašim LangChain agentima daje doseg do kupaca na WhatsAppu, Instagramu, Facebooku, TikToku, YouTubeu, LinkedInu i još kanala, svaki kroz službeni API: jedan MCP poslužitelj iza OAuth prijave, potpisani događaji za komentare i DM-ove te red čekanja koji objavljuje do 90 dana unaprijed, uz praćenje svake veze 24/7. Od US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, s besplatnim probnim razdobljem od 3 dana.

Često postavljana pitanja

Treba li agentu vlastita razvojna aplikacija za Meta, TikTok ili Google?

Ne. Računi se povezuju kroz easyCoexistenceovu vlastitu aplikaciju na svakoj mreži, u nadzornoj ploči ili putem poveznice za povezivanje Partner API-ja, a agent do svih njih dolazi jednom easyCoexistence prijavom.

Može li agent zakazivati objave umjesto da odmah objavljuje?

Može. publish_instagram_post, publish_facebook_post, publish_tiktok_post i publish_linkedin_post uzimaju scheduled_at, vrijeme u ISO 8601 formatu s vremenskom zonom, od 1 minute do 90 dana unaprijed. YouTube zakazuje izvorno uz upload_youtube_video i publish_at.

Koji modeli mogu pokretati agenta?

Svaki model za razgovor koji create_agent može koristiti s alatima. MCP alati ne ovise o modelu, a pružatelj modela naplaćuje vlastitu 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 mjesečno, uz pad kako dodajete veze, jednako na svakoj mreži. MCP poslužitelj, proslijeđeni događaji i Partner API uključeni su, 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