Node.js ile Instagram, TikTok ve Facebook'a tek bir API üzerinden gönderi yapın
easyCoexistence ile Node.js ya da TypeScript arka ucunuz, Instagram, Facebook, TikTok, YouTube ve LinkedIn'e her ağın resmi API'si üzerinden gönderi yayınlar. Hesaplar bir kez, barındırılan bir bağlantı üzerinden oturum açar; her iş için tek bir fetch çağrısı TikTok, YouTube ve LinkedIn için yeni bir token döndürür ve imzalı olaylar yorumları ile DM'leri rotanıza iletir. TypeScript MCP SDK ile kurulan ajanlar aynı hesapları araç olarak kullanır.
TikTok'un yayınlama uç noktasının hesap başına kabul ettiği video gönderileri; dakikada en fazla altı.
published false ve scheduled_publish_time ile bir Facebook Sayfası gönderisinin ne kadar ileriye planlanabileceği.
Yeni bir LinkedIn gönderisinin URN'ini taşıyan, 201 durum koduyla gönderilen yanıt başlığı.
TikTok'un bir yorum oluşturulduktan, silindikten veya görünürlüğü değiştirildikten sonra comment.update olayını ne kadar çabuk tetiklediği.
Partner API bağlantı adresinin oturumu sona ermeden önce ne kadar açık kaldığı.
Node.js arka ucunuz hesapları nasıl bağlar ve token'larını nasıl alır?
Arka ucunuz bir bağlantı oturumu açar, hesap sahibi ise tarayıcıda işlemi tamamlar. ec_live_ anahtarınızı taşıyıcı token olarak kullanan, tiktok ya da linkedin gibi bir kanal, bir redirect_url ve müşteriniz için bir external_ref içeren POST /connect-sessions isteği, easycoexistence.com üzerinde bir url döndürür. Hesap sahibi orada ağın kendi onay ekranında oturum açar ve status=connected ile bir channel_id içeren şekilde redirect_url adresinize geri döner. İptal edilen bir deneme, oluşturulmasından bir saat sonra sona erene kadar aynı bağlantıdan yeniden denenebilir.
Her iş, GET /channels/{id}?credentials=1 çağrısıyla başlar. Yanıtta şu anda geçerli bir token (Instagram ve Facebook'ta değil, bu token'lar hiçbir zaman verilmez) ve her ağın ihtiyaç duyduğu alanlar bulunur: Instagram ve Facebook'ta graph_api_base ile account_id_on_meta, TikTok'ta api_base ile business_id, YouTube'da channel_id, LinkedIn'de author_urn ile required_headers. Uygulamanızın hesabın ne zaman değiştiğini öğrenmesini sağlayan imzalı channel.connected, channel.disconnected, channel.removed ve channel.suspended olayları, panelinizde ayarlanan olay URL'sine gönderilir.
const EC = "https://easycoexistence.com/api/v1";
const KEY = { Authorization: `Bearer ${process.env.EC_API_KEY}` }; // ec_live_...
type Network = "instagram" | "facebook" | "tiktok" | "youtube" | "linkedin";
// A hosted sign-in link for one of your customers on one network
export async function connectLink(customerId: string, channel: Network): Promise<string> {
const r = await fetch(`${EC}/connect-sessions`, {
method: "POST",
headers: { ...KEY, "Content-Type": "application/json" },
body: JSON.stringify({
channel,
redirect_url: "https://app.example.com/connected",
external_ref: customerId,
}),
});
const session = (await r.json()) as { url: string; error?: { message: string } };
if (!r.ok) throw new Error(session.error?.message);
return session.url; // they come back with ?session=...&status=connected&channel_id=...
}
// At the start of every job: the API base and a token that is valid now
export async function credentials(channelId: string) {
const r = await fetch(`${EC}/channels/${channelId}?credentials=1`, { headers: KEY });
const body: any = await r.json(); // the credential fields differ by network
if (!r.ok) throw new Error(body.error.message);
if (!body.credentials.access_token) throw new Error(body.credentials.note);
return body.credentials;
}Node.js'ten Instagram ve Facebook'a nasıl gönderi yaparsınız?
Instagram, bir container üzerinden yayınlar. Bir Reel için media_type REELS, video_url ve caption ile container'ı oluşturun, status_code değeri FINISHED olana kadar yoklayın, sonra creation_id olarak container kimliğiyle media_publish çağırın. Meta, yaklaşık bir dakikada bir yoklamayı ve beş dakika sonra vazgeçmeyi önerir; ERROR ya da EXPIRED, container'ın yayınlanmayacağı anlamına gelir ve 24 saat yayınlanmadan kalan bir container kendiliğinden sona erer.
Bir Facebook Sayfası, image url ve bir açıklama ile tek bir /{page-id}/photos çağrısında fotoğraf yükler; metin ve bağlantılar ise /{page-id}/feed adresine gider. İkisi de published false ve scheduled_publish_time kabul eder; Meta, gönderiyi zamanı geldiğinde kendisi yayınlar ve bu süre 10 dakika ile 30 gün arasındadır. Token bir taşıyıcı başlık olarak iletilir, Graph API sürümü zaten graph_api_base içindedir ve medyanın Meta'nın indirdiği herkese açık bir URL'de olması gerekir.
type Meta = { graph_api_base: string; access_token: string };
async function graph(c: Meta, path: string, body?: object) {
const r = await fetch(`${c.graph_api_base}/${path}`, {
method: body ? "POST" : "GET",
headers: { Authorization: `Bearer ${c.access_token}`, "Content-Type": "application/json" },
body: body && JSON.stringify(body),
});
const data: any = await r.json();
if (!r.ok) throw new Error(data.error?.message ?? `Graph API ${r.status}`);
return data;
}
export async function postReel(channelId: string, videoUrl: string, caption: string) {
const c = await credentials(channelId);
const ig = c.account_id_on_meta;
const { id } = await graph(c, `${ig}/media`, { media_type: "REELS", video_url: videoUrl, caption });
for (let check = 0; check < 5; check++) {
await new Promise((wake) => setTimeout(wake, 60_000)); // about once a minute, as Meta advises
const { status_code } = await graph(c, `${id}?fields=status_code`);
if (status_code === "FINISHED") return graph(c, `${ig}/media_publish`, { creation_id: id });
if (status_code === "ERROR" || status_code === "EXPIRED") throw new Error(`Reel container ${status_code}`);
}
throw new Error("The Reel is still processing after five minutes");
}
export async function schedulePagePhoto(channelId: string, url: string, caption: string, at: Date) {
const c = await credentials(channelId);
return graph(c, `${c.account_id_on_meta}/photos`, {
url,
caption,
published: false,
scheduled_publish_time: Math.floor(at.getTime() / 1000), // 10 minutes to 30 days ahead
});
}Node.js'ten LinkedIn'e nasıl gönderi yaparsınız ve YouTube'a nasıl yüklersiniz?
LinkedIn, her çağrıda taşıyıcı token'a ek olarak iki başlık ister: easyCoexistence'ın required_headers içinde döndürdüğü YYYYMM değeriyle LinkedIn-Version ve 2.0.0 olarak ayarlanmış X-Restli-Protocol-Version. Gönderi, author URN, metin olarak commentary, PUBLIC görünürlük, ana akış olarak distribution ve lifecycleState PUBLISHED ile /rest/posts adresine yapılan bir POST'tur. LinkedIn 201 ile yanıt verir ve yeni gönderinin URN'ini x-restli-id başlığında döndürür; URL yoluna konan her URN URL kodlu olmalıdır.
YouTube iki istek gerektirir. uploadType=resumable ve part=snippet,status ile yükleme uç noktasına yapılan bir POST, üst veriyi gönderir ve oturum adresini Location başlığında döndürür; dosyanın baytlarının bu adrese PUT edilmesi ise id alanı olan video kaynağını döndürür. Video özel olarak ve bir publishAt tarihiyle yüklenirse, yayınlama işini YouTube'un kendi zamanlayıcısı üstlenir, bu yüzden o saatte sizin çalıştırmanız gereken bir şey olmaz.
import { readFile } from "node:fs/promises";
export async function postOnLinkedIn(channelId: string, text: string) {
const c = await credentials(channelId);
const r = await fetch(`${c.api_base}/posts`, {
method: "POST",
headers: {
Authorization: `Bearer ${c.access_token}`,
"LinkedIn-Version": c.required_headers["LinkedIn-Version"],
"X-Restli-Protocol-Version": "2.0.0",
"Content-Type": "application/json",
},
body: JSON.stringify({
author: c.author_urn, // urn:li:organization:... or urn:li:person:...
commentary: text,
visibility: "PUBLIC",
distribution: { feedDistribution: "MAIN_FEED", targetEntities: [], thirdPartyDistributionChannels: [] },
lifecycleState: "PUBLISHED",
isReshareDisabledByAuthor: false,
}),
});
if (r.status !== 201) throw new Error(`LinkedIn ${r.status}: ${await r.text()}`);
return r.headers.get("x-restli-id"); // the new post's URN
}
export async function scheduleOnYouTube(channelId: string, file: string, title: string, publishAt: string) {
const c = await credentials(channelId);
const auth = { Authorization: `Bearer ${c.access_token}` };
const start = await fetch(
"https://www.googleapis.com/upload/youtube/v3/videos?uploadType=resumable&part=snippet,status",
{
method: "POST",
headers: { ...auth, "Content-Type": "application/json; charset=UTF-8", "X-Upload-Content-Type": "video/mp4" },
body: JSON.stringify({
snippet: { title },
status: { privacyStatus: "private", publishAt, selfDeclaredMadeForKids: false },
}),
},
);
const session = start.headers.get("location");
if (!start.ok || !session) throw new Error(`YouTube ${start.status}: ${await start.text()}`);
const done = await fetch(session, {
method: "PUT",
headers: { ...auth, "Content-Type": "video/mp4" },
body: await readFile(file),
});
const video = (await done.json()) as { id: string };
return video.id;
}Node.js rotanızda yorumları ve DM'leri nasıl alırsınız?
Her kanal, PUT /channels/{id}/webhook ile verdiğiniz URL'ye iletir ve bu çağrı kanalın signing_secret değerini bir kez döndürür. Her teslimat; platform, account_id, external_id ve entry alanlarıyla bir POST'tur ve X-EC-Signature başlığı t=<unix>,v1=<hex> biçimindedir; burada v1, t, bir nokta ve ham gövdenin HMAC-SHA256 değeridir. Ayrıştırmadan önce gövdeyi metin olarak alın, beş dakikadan eski bir t değerini reddedin ve timingSafeEqual ile karşılaştırın.
Instagram ve Facebook için entry, Meta'nın gönderdiği biçimiyle Meta'nın webhook girişidir: yorumlar ve bahsetmeler için changes, DM'ler için messaging. TikTok için ise bir yorumdan beş dakika içinde tetiklenen comment.update olayını taşır; comment_id ve video_id, JavaScript bu 64 bitlik sayıları yuvarlayamasın diye string olarak gelir. Olay başına tek bir deneme yapılır ve kayıtlı bir kopya tutulmaz; bu yüzden hemen 204 yanıtı verin ve işlemi bir kuyruktan yapın.
import { createHmac, timingSafeEqual } from "node:crypto";
const secrets = new Map<string, string>(); // channel id -> signing_secret, kept in your database
export async function forwardEvents(channelId: string, url: string) {
const r = await fetch(`${EC}/channels/${channelId}/webhook`, {
method: "PUT",
headers: { ...KEY, "Content-Type": "application/json" },
body: JSON.stringify({ url }),
});
const body = (await r.json()) as { signing_secret: string; error?: { message: string } };
if (!r.ok) throw new Error(body.error?.message);
secrets.set(channelId, body.signing_secret); // returned only this once
}
function verify(raw: string, header: string | null, secret: string): boolean {
const parts = Object.fromEntries((header ?? "").split(",").map((kv) => kv.split("=", 2)));
const t: string = parts.t ?? "";
const v1: string = parts.v1 ?? "";
if (!/^[0-9]+$/.test(t) || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
const mac = createHmac("sha256", secret).update(`${t}.${raw}`).digest("hex");
return mac.length === v1.length && timingSafeEqual(Buffer.from(mac), Buffer.from(v1));
}
// POST /hooks/social as a web-standard handler (Next.js, Hono, Bun and others)
export async function POST(req: Request) {
const raw = await req.text(); // the signature covers these exact bytes
const event = JSON.parse(raw); // { platform, account_id, external_id, entry }
const secret = secrets.get(event.account_id);
if (!secret || !verify(raw, req.headers.get("x-ec-signature"), secret)) {
return new Response("invalid signature", { status: 401 });
}
await enqueue(event); // one attempt per event and no retries: acknowledge first
return new Response(null, { status: 204 });
}Node.js'ten yorumlara ve DM'lere nasıl yanıt verirsiniz?
Taze bir kimlik bilgisi çağrısı ve olaydaki kimliklerle. Instagram ve Facebook'ta bir DM yanıtı, account_id_on_meta kullanılarak /{account-id}/messages adresine, alıcı olarak göndericinin kimliğiyle ve kişinin son mesajından itibaren 24 saat içinde gönderilir. Bir Sayfa messaging_type RESPONSE ekler ve Instagram en fazla 1,000 bayt metne izin verir. Bir yoruma herkese açık yanıt, Instagram'da /{comment-id}/replies ya da Facebook'ta /{comment-id}/comments adresine gider veya 7 gün içinde tek bir özel yanıt verilebilir.
TikTok'taki görüşmeler herkese açık kalır, çünkü TikTok'ta DM yoktur. business/comment/reply/create/ adresine, Access-Token başlığı, business_id, video_id ve comment_id ile yapılan istek, 1,200 karakterlik bir yanıt gönderir. HTTP durumu yerine, yanıttaki code alanını okuyun; 0 başarı anlamına gelir. Yalnızca comment_type comment ile comment_action insert olayına göre işlem yapın, çünkü sizin kendi yanıtlarınız da olay olarak gelir.
export async function reply(event: any, text: string) {
const c = await credentials(event.account_id);
if (event.platform === "tiktok") {
const e = event.entry.content; // the comment.update event, ids as strings
if (e.comment_action !== "insert" || e.comment_type !== "comment") return; // your replies arrive as "reply"
const r = await fetch(`${c.api_base}/business/comment/reply/create/`, {
method: "POST",
headers: { "Access-Token": c.access_token, "Content-Type": "application/json" },
body: JSON.stringify({ business_id: c.business_id, video_id: e.video_id, comment_id: e.comment_id, text }),
});
const out = (await r.json()) as { code: number; message: string };
if (out.code !== 0) throw new Error(out.message); // 0 is success, whatever the HTTP status
} else if (event.platform === "facebook") {
for (const m of event.entry.messaging ?? []) {
if (!m.message || m.message.is_echo) continue; // only what people sent the Page
await graph(c, `${c.account_id_on_meta}/messages`, {
recipient: { id: m.sender.id },
messaging_type: "RESPONSE", // within 24 hours of their last message
message: { text },
});
}
}
}Node.js'ten TikTok'a nasıl gönderi yaparsınız ve bu araçları bir TypeScript ajanına nasıl verirsiniz?
İkisi de easyCoexistence'ın https://easycoexistence.com/api/mcp adresindeki MCP sunucusu üzerinden geçer; bu sunucu yalnızca OAuth 2.1 kabul eder: dinamik istemci kaydı, PKCE ile bir yetkilendirme kodu, bir saat geçerli erişim token'ları ve yenileme token'ları. Node 20 ve sonrası için resmi TypeScript SDK olan @modelcontextprotocol/client ile bir OAuthClientProvider istemciyi, token'ları ve PKCE doğrulayıcısını tutar; ilk bağlantı kullanıcıyı oturum açmaya yönlendirir ve UnauthorizedError fırlatır, geri çağrının sorgusuyla finishAuth ise süreci tamamlar.
TikTok yayını burada yer alır, çünkü TikTok medyayı yalnızca token'ın bağlı olduğu geliştirici uygulaması için doğrulanmış URL öneklerinden indirir. publish_tiktok_post, HTTPS bağlantınızı alır ve TikTok'a easyCoexistence'ın doğrulanmış medya rotasında imzalı bir adres verir; get_tiktok_publish_status ise gönderiyi takip eder. Aynı istemci, bir ajana hesabın ağları için her aracı verir; önce list_social_accounts çağırın, bunun account_id değeri Partner API'nin kanal kimliğidir.
import { createInterface } from "node:readline/promises";
import { Client, StreamableHTTPClientTransport, UnauthorizedError, type OAuthClientProvider } from "@modelcontextprotocol/client";
const MCP = new URL("https://easycoexistence.com/api/mcp");
const saved: Record<string, any> = {}; // persist this, so the browser sign-in happens once
const provider: OAuthClientProvider = {
redirectUrl: "http://localhost:8090/callback",
clientMetadata: { client_name: "My social agent", redirect_uris: ["http://localhost:8090/callback"] },
state: () => (saved.state = crypto.randomUUID()),
clientInformation: () => saved.client,
saveClientInformation: (info) => { saved.client = info; },
tokens: () => saved.tokens,
saveTokens: (tokens) => { saved.tokens = tokens; },
saveCodeVerifier: (verifier) => { saved.verifier = verifier; },
codeVerifier: () => saved.verifier,
redirectToAuthorization: (url) => console.log("Sign in to easyCoexistence:", url.href),
};
const client = new Client({ name: "my-social-agent", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(MCP, { authProvider: provider });
try {
await client.connect(transport);
} catch (error) {
if (!(error instanceof UnauthorizedError)) throw error;
const rl = createInterface({ input: process.stdin, output: process.stdout });
const back = new URL(await rl.question("Paste the address you were sent back to: ")).searchParams;
rl.close();
if (back.get("state") !== saved.state) throw new Error("state mismatch");
await transport.finishAuth(back);
await client.connect(new StreamableHTTPClientTransport(MCP, { authProvider: provider }));
}
const result = await client.callTool({
name: "publish_tiktok_post",
arguments: {
account_id: process.env.TIKTOK_CHANNEL_ID, // the Partner API channel id
video_url: "https://cdn.example.com/launch.mp4",
caption: "New drop #behindthescenes",
},
});
console.log(result.content); // a share_id to follow with get_tiktok_publish_statusYaygın hatalar
- HMAC'i ayrıştırılmış ve yeniden serileştirilmiş JSON üzerinden hesaplamak. İmza ham gövdeyi bayt bayt kapsar; bu yüzden önce req.text() çağırın, ayrıştırmayı sonra yapın; yoksa her teslimat doğrulamada başarısız olur.
- TikTok kimliklerini sayıya çevirmek. Yorum ve video kimlikleri 64 bitliktir ve Number() bunları yuvarlar; bu yüzden yanıt verirken ya da bir yorumu ararken olayın taşıdığı string değerleri koruyun.
- Yönlendirmeden yalnızca channel_id'yi tutmak. Bir Facebook ya da LinkedIn oturum açması aynı anda birkaç Sayfa ekleyebilir; bu yüzden GET /channels?external_ref= ile hepsini listeleyin ve her birini kaydedin.
- Bir Messenger ya da Instagram DM'ine gece toplu işinden yanıt vermek. Kişinin son mesajından 24 saat sonra gönderim başarısız olur; bu yüzden pencere açıkken olay işleyicisinden yanıt verin.
easyCoexistence, Node.js arka uçlarına ve AI ajanlarına WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn ve daha fazla kanaldaki müşterilere erişim verir; her biri kendi resmi API'si üzerinden çalışır. Hesapları Partner API ile bağlayın, taze token'ları ve imzalı olayları alın, TypeScript ajanlarının MCP sunucusu üzerinden işlem yapmasını sağlayın; her bağlantı 24/7 izlenir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
Bu API'leri Node'dan çağırmak için bir SDK'ya ihtiyacım var mı?
Hayır. Partner API ve ağların API'leri düz HTTPS'tir, bu yüzden Node 18 ve sonrasındaki global fetch bunları karşılar. @modelcontextprotocol/client yalnızca MCP araçları için gerekir; TikTok yayını da bunların arasındadır.
TikTok yayını neden MCP sunucusu üzerinden gider?
TikTok videoları ve fotoğrafları yalnızca geliştirici uygulaması için doğrulanmış bir alan adından ya da URL önekinden indirir; bu uygulama easyCoexistence'a ait. publish_tiktok_post, HTTPS dosyanızı bu doğrulanmış adresten sunar; bu yüzden kendi alan adınızın doğrulanmasına gerek yoktur.
Tek bir oturum açma ile birden fazla Facebook ya da LinkedIn Sayfası bağlanabilir mi?
Evet. Her Sayfa ve LinkedIn'de üyenin kendi profili, kendi kanalını ve kendi bağlantısını oluşturur. Yönlendirme ilk channel_id'yi taşır; GET /channels?external_ref= hepsini listeler.
easyCoexistence, Node.js için ne kadar tutar?
Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer ve her ağda aynıdır. Partner API ve MCP bağlayıcısı buna dahildir, koltuk ücreti yoktur ve 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