InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Geef een LangChain-agent Instagram-, TikTok- en WhatsApp-tools

Een LangChain-agent krijgt Instagram, TikTok, WhatsApp en meer kanalen als tools van de MCP-server van easyCoexistence op https://easycoexistence.com/api/mcp, geladen door MCPAdapter, de MCP-client van LangChain, terwijl FastMCP de OAuth-aanmelding afhandelt. create_agent kan vervolgens posts publiceren en inplannen, reageren op reacties en DM's en inzichten lezen via de officiële API van elk netwerk, terwijl ondertekende events nieuwe reacties en berichten naar je route brengen.

Beta

LangChain's label voor zijn langchain.mcp-namespace, die langchain[mcp] 1.4.0 of nieuwer vereist en FastMCP meebrengt.

In memory

Waar FastMCP OAuth-tokens bewaart tenzij token_storage een backend aanwijst, zodat een herstart opnieuw aanmelden betekent.

127.0.0.1

Het loopback-adres van de tijdelijke callbackserver die FastMCP start voor de aanmelding in de browser, op een vrije poort of callback_port.

60 days

Hoe lang een easyCoexistence MCP-refreshtoken geldig is; access-tokens gelden een uur, en elke refresh geeft een nieuw paar uit.

8 seconds

Hoe lang easyCoexistence wacht op het antwoord van je route op een doorgestuurde reactie of DM, die eenmaal wordt verstuurd en nooit opnieuw.

Welke tools krijgt een LangChain-agent van easyCoexistence?

Meer dan 50, als gewone LangChain-tools die create_agent kan aanroepen. De social-tools nemen een account_id, dus de agent begint met list_social_accounts en geeft de ID's door om te publiceren, te lezen, op reacties te reageren, ze te verbergen en inzichten op te halen. Tools die bij één netwerk horen dragen de naam ervan, zoals publish_tiktok_post of upload_youtube_video, en een WhatsApp-nummer begint bij list_numbers, dat de connection_id teruggeeft die send_message en send_template nodig hebben. De beschrijving van elke tool bevat de eigen regels van het netwerk, zodat het model bijvoorbeeld leert dat een TikTok-reactie publiek is. Posten met een planning vraagt één argument extra: scheduled_at zet de post in de wachtrij van 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

Hoe meldt de agent zich aan bij easyCoexistence?

Met de OAuth-helper van FastMCP, die MCPAdapter gebruikt voor authenticatie. Bij de eerste keer zoekt die de autorisatieserver van easyCoexistence, registreert zichzelf als client, opent de browser op het toestemmingsscherm, waar zijn client_name wordt getoond, en ontvangt de code op een lokale callback op 127.0.0.1. Daarna worden access-tokens ververst zonder browser. Tokens staan in het geheugen tenzij de helper een token_storage-backend krijgt, dus het voorbeeld bewaart ze op schijf, versleuteld met een Fernet-sleutel. Filter de lijst voordat create_agent hem ziet: de tools bevatten de MCP-client, dus de agent blijft werken nadat het async with-blok sluit.

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)

Hoe bereiken reacties en DM's een LangChain-agent?

Als ondertekende POST-verzoeken naar een route van jou, want MCP beantwoordt alleen de aanroepen die de agent doet. Koppel elk account aan de route met set_social_webhook_destination, die je eenmalig aan de agent vraagt of uitvoert vanuit Claude of ChatGPT, en bewaar de signing_secret die terugkomt. Instagram en Facebook sturen reacties, vermeldingen en DM's door, en TikTok stuurt reacties door; elk event bevat platform, account_id, external_id en het eigen item van het netwerk. De route controleert X-EC-Signature en antwoordt meteen, want easyCoexistence wacht 8 seconden en probeert het niet opnieuw. Daarna geeft de route het event op de achtergrond aan de agent. Een checkpointer met een thread_id per DM-afzender bewaart de geschiedenis van een gesprek.

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

Wat staat de agent per netwerk toe?

Wat de API van het netwerk het account toestaat, wat de instructies van de agent duidelijk moeten vermelden:

  • Instagram- en Messenger-DM's: send_social_dm antwoordt op mensen die in de laatste 24 uur schreven, en Instagram beperkt een DM tot 1,000 bytes UTF-8.
  • Reacties beantwoorden: reply_to_comment antwoordt publiekelijk, of met private op true stuurt het één DM per Instagram- of Facebook-reactie, binnen 7 dagen na die reactie.
  • TikTok: antwoorden zijn altijd publiek en vereisen het ID van de video als post_id, en er zijn geen DM's op TikTok.
  • WhatsApp: send_message werkt binnen 24 uur na het laatste bericht van de klant, en send_template met een goedgekeurd template daarbuiten.
  • Media: elk bestand staat op een publieke HTTPS-link; Instagram accepteert JPEG-afbeeldingen, en TikTok-fotoposts accepteren JPEG of WebP.

Wanneer moet code de netwerken aanroepen zonder de agent?

Wanneer een stap altijd op dezelfde manier moet gebeuren, of zonder iemand die kan inloggen. get_social_credentials geeft de agent de API-basis van een account, zijn ID op het netwerk en, bij TikTok, YouTube en LinkedIn, een token dat nu geldig is, en de Partner API geeft hetzelfde terug via GET /api/v1/channels/:id?credentials=1 met een ec_live_-sleutel, zodat een Python-script TikTok, Google of LinkedIn rechtstreeks kan aanroepen. Antwoorden die op elk uur moeten uitgaan zonder de agent, zoals vaste tekst voor een trefwoord, passen bij reactieregels en automatiseringen, die easyCoexistence zelf uitvoert.

Veelgemaakte fouten

  • Reageren op events die het account zelf veroorzaakte. Instagram herhaalt de eigen DM's van het account met is_echo op true en geeft de openbare antwoorden terug als reacties, dus filter ze weg voordat de agent ze ziet, anders antwoordt hij zichzelf.
  • De agent draaien voordat de route antwoordt. easyCoexistence wacht 8 seconden op een 2xx en probeert het nooit opnieuw, dus een handler die op het model wacht verliest het event; antwoord eerst en werk daarna op de achtergrond.
  • reply_to_comment aanroepen voor een TikTok-reactie zonder post_id. Het antwoord op TikTok noemt zowel de video als de reactie, dus geef de video_id van het event door als post_id.
  • Een antwoordagent de publicatietools geven. Filter de lijst op naam voordat create_agent start, zodat een verkeerd gelezen reactie geen post kan publiceren, verwijderen of een automatisering kan wijzigen.
Dit doen met EasyCoexistence

easyCoexistence geeft je LangChain-agenten bereik tot klanten op WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn en meer kanalen, elk via de officiële API: één MCP-server achter een OAuth-aanmelding, ondertekende reactie- en DM-events, en een wachtrij die tot 90 dagen vooruit publiceert, met elke verbinding 24/7 gemonitord. US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met de eerste 3 dagen als gratis proefperiode.

Veelgestelde vragen

Heeft de agent een eigen Meta-, TikTok- of Google-developerapp nodig?

Nee. Accounts koppelen via de eigen app van easyCoexistence op elk netwerk, in het dashboard of via een connectlink van de Partner API, en de agent bereikt ze allemaal via één aanmelding bij easyCoexistence.

Kan de agent posts inplannen in plaats van direct publiceren?

Ja. publish_instagram_post, publish_facebook_post, publish_tiktok_post en publish_linkedin_post nemen scheduled_at, een ISO 8601-tijd met tijdzone van 1 minuut tot 90 dagen vooruit. YouTube plant zelf in met upload_youtube_video en publish_at.

Welke modellen kunnen de agent aansturen?

Elk chatmodel dat create_agent met tools kan gebruiken. De MCP-tools hangen niet af van het model, en de provider van het model rekent het eigen verbruik; easyCoexistence rekent per verbinding, nooit per toolaanroep.

Hoeveel kost easyCoexistence voor een LangChain-agent?

US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, en hetzelfde op elk netwerk. De MCP-server, de doorgestuurde events en de Partner API zijn inbegrepen, en de eerste 3 dagen zijn een gratis proefperiode.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op