Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

LangChain agent'a Instagram, TikTok ve WhatsApp araçları verin

Bir LangChain agent'ı, easyCoexistence'ın MCP sunucusundan https://easycoexistence.com/api/mcp adresinde Instagram, TikTok, WhatsApp ve diğer kanalları araç olarak alır. Bu araçları, LangChain'in MCP istemcisi olan MCPAdapter yükler; OAuth girişini FastMCP yönetir. create_agent ardından gönderi yayımlayabilir ve planlayabilir, yorumları ve DM'leri yanıtlayabilir, her ağın resmi API'si üzerinden içgörüleri okuyabilir; imzalı olaylar ise yeni yorum ve mesajları rotanıza getirir.

Beta

LangChain'in langchain.mcp ad alanı için kullandığı etiket; langchain[mcp] 1.4.0 veya sonrasını gerektirir ve FastMCP'yi getirir.

In memory

FastMCP'nin token_storage bir arka uç belirtmediği sürece OAuth token'larını tuttuğu yer; bu nedenle yeniden başlatmada tekrar giriş yapmak gerekir.

127.0.0.1

FastMCP'nin tarayıcı girişi için başlattığı geçici geri çağırma sunucusunun loopback adresi; boş bir bağlantı noktasında ya da callback_port'ta çalışır.

60 days

Bir easyCoexistence MCP yenileme token'ının ne kadar geçerli kaldığı; erişim token'ları bir saat geçerlidir ve her yenileme yeni bir çift verir.

8 seconds

easyCoexistence'ın, yönlendirilen bir yorum ya da DM için yolunuzun yanıt vermesini ne kadar beklediği; olay bir kez gönderilir ve asla yeniden denenmez.

Bir LangChain agent'ı easyCoexistence'tan hangi araçları alır?

create_agent'ın çağırabildiği sıradan LangChain araçları olarak 35'ten fazla. Sosyal araçlar account_id alır; bu yüzden agent önce list_social_accounts ile başlar ve ID'leri gönderi yayımlama, okuma, yorum yanıtlama, gizleme ve içgörü okuma araçlarına aktarır. Tek bir ağa ait araçlar onun adını taşır, örneğin publish_tiktok_post veya upload_youtube_video. WhatsApp numarası list_numbers ile başlar; bu araç, send_message ve send_template'in aldığı connection_id'yi döndürür. Her aracın açıklaması ağın kendi kurallarını taşır; model, örneğin bir TikTok yanıtının herkese açık olduğunu öğrenir. Gönderiyi sonradan planlamak için bir argüman daha gerekir: scheduled_at, gönderiyi easyCoexistence'ın kuyruğuna koyar.

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

Agent easyCoexistence'a nasıl giriş yapar?

MCPAdapter'ın kimlik doğrulaması için kullandığı FastMCP'nin OAuth yardımcısıyla. İlk çalıştırmada easyCoexistence'ın yetkilendirme sunucusunu keşfeder, kendini istemci olarak kaydeder, onay ekranını açmak için tarayıcıyı başlatır (ekranda client_name görünür) ve kodu 127.0.0.1 üzerindeki yerel geri çağırmada alır. Bundan sonra erişim token'ları tarayıcı olmadan yenilenir. Yardımcı bir token_storage arka ucu almadıkça token'lar bellekte tutulur; bu yüzden örnek, token'ları Fernet anahtarıyla şifreleyerek diskte saklar. create_agent listeyi görmeden önce listeyi filtreleyin: araçlar MCP istemcisini tutar, bu sayede async with bloğu kapandıktan sonra da agent çalışmaya devam eder.

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)

Yorumlar ve DM'ler LangChain agent'ına nasıl ulaşır?

Yolunuza gönderilen imzalı POST istekleri olarak, çünkü MCP yalnızca agent'ın yaptığı çağrılara yanıt verir. Her hesabı set_social_webhook_destination ile yönlendirin; bunu agent'a bir kez sorabilir ya da Claude veya ChatGPT'den çalıştırabilirsiniz, ve döndürdüğü signing_secret'ı saklayın. Instagram ve Facebook yorumları, bahsetmeleri ve DM'leri; TikTok ise yorumları iletir. Her olay platform, account_id, external_id ve ağın kendi kaydını taşır. Yol X-EC-Signature'ı denetler, hemen yanıt verir, çünkü easyCoexistence 8 saniye bekler ve yeniden denemez, ardından olayı arka planda agent'a devreder. Her DM gönderenine ait bir thread_id ile çalışan bir checkpointer, konuşma geçmişini tutar.

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

Her ağ agent'a neye izin verir?

Ağın API'sinin hesaba izin verdikleri; agent'ın talimatları bunları açıkça belirtmelidir:

  • Instagram ve Messenger DM'leri: send_social_dm, son 24 saat içinde yazan kişilere yanıt verir; Instagram bir DM'i UTF-8 olarak en fazla 1.000 bayta sınırlar.
  • Yorum yanıtları: reply_to_comment herkese açık yanıt verir; private değeri true ise her Instagram veya Facebook yorumuna, yorumdan itibaren 7 gün içinde bir DM gönderir.
  • TikTok: yanıtlar her zaman herkese açıktır ve post_id olarak videonun ID'sini gerektirir; TikTok'ta DM yoktur.
  • WhatsApp: send_message, müşterinin son mesajından sonraki 24 saat içinde çalışır; bu süre dışında onaylı bir şablonla send_template kullanılır.
  • Medya: her dosya herkese açık bir HTTPS bağlantısında bulunmalıdır; Instagram JPEG görsel kabul eder, TikTok fotoğraf gönderileri JPEG veya WebP kabul eder.

Kod, agent olmadan ağlara ne zaman doğrudan istek atmalı?

Bir adımın her seferinde aynı şekilde yapılması gerektiğinde ya da başında kimsenin giriş yapamayacağı durumlarda. get_social_credentials agent'a bir hesabın API tabanını, ağdaki kimliğini ve TikTok, YouTube ve LinkedIn'de şu an geçerli bir token'ı verir. Partner API, ec_live_ anahtarıyla GET /api/v1/channels/:id?credentials=1 üzerinden aynısını döndürür; böylece bir Python işi TikTok, Google veya LinkedIn'i doğrudan çağırabilir. Agent olmadan her saat yayımlanması gereken yanıtlar, örneğin bir anahtar kelime için sabit metin, yorum kurallarına ve otomasyonlara uyar; bunları easyCoexistence kendisi çalıştırır.

Yaygın hatalar

  • Hesabın kendi yaptığı olaylara yanıt vermek. Instagram, hesabın kendi DM'lerini is_echo değeri true ile yankılar ve kendi herkese açık yanıtlarını yorum olarak döndürür; bunları agent görmeden önce atın, yoksa agent kendi kendine yanıt vermeye başlar.
  • Yolu yanıt vermeden önce agent'ı çalıştırmak. easyCoexistence 2xx yanıtı için 8 saniye bekler ve asla yeniden denemez; modeli bekleyen bir işleyici olayı kaybeder. Önce yanıt verin, işi arka planda yapın.
  • TikTok yorumu için post_id olmadan reply_to_comment çağırmak. TikTok yanıtı hem yorumu hem videoyu adlandırır; bu yüzden olayın video_id'sini post_id olarak geçirin.
  • Yanıt agent'ına yayımlama araçlarını vermek. create_agent'tan önce listeyi ada göre filtreleyin; böylece yanlış okunan bir yorum gönderi yayımlayamaz, silemez ya da bir otomasyonu değiştiremez.
Bunu EasyCoexistence'la yapmak

easyCoexistence, LangChain agent'larınıza WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn ve diğer kanallardaki müşterilere erişim verir; her biri resmi API'si üzerinden çalışır: tek OAuth girişinin arkasında bir MCP sunucusu, imzalı yorum ve DM olayları ve 90 güne kadar önceden gönderi planlayan bir kuyruk; her bağlantı 7/24 izlenir. Bağlantı başına ayda US$ 9 ila US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.

Sık sorulan sorular

Agent'ın kendi Meta, TikTok veya Google geliştirici uygulamasına ihtiyacı var mı?

Hayır. Hesaplar her ağda easyCoexistence'ın kendi uygulamasıyla bağlanır; panelden ya da bir Partner API bağlantı linkiyle, ve agent hepsine tek bir easyCoexistence girişiyle ulaşır.

Agent, hemen yayımlamak yerine gönderileri planlayabilir mi?

Evet. publish_instagram_post, publish_facebook_post, publish_tiktok_post ve publish_linkedin_post, scheduled_at alır: saat dilimi içeren bir ISO 8601 zamanı, şimdiden 1 dakika ile 90 gün arasında. YouTube ise upload_youtube_video ve publish_at ile yerel olarak planlar.

Agent hangi modellerle çalışabilir?

create_agent'ın araçlarla kullanabildiği her sohbet modeli. MCP araçları modele bağlı değildir; modelin sağlayıcısı kendi kullanımını faturalandırır. easyCoexistence ise araç çağrısı başına değil, bağlantı başına ücret alır.

Bir LangChain agent için easyCoexistence ne kadar tutar?

Bağlantı başına ayda US$ 9 ila US$ 0.75 arasında, bağlantı ekledikçe düşer; her ağda aynıdır. MCP sunucusu, yönlendirilen olaylar ve Partner API dahildir; ilk 3 gün ücretsizdir.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi