Posting ke Instagram, TikTok dan Facebook dari Node.js dengan satu API
Dengan easyCoexistence, backend Node.js atau TypeScript memposting ke Instagram, Facebook, TikTok, YouTube dan LinkedIn melalui API resmi masing-masing jaringan. Akun masuk sekali lewat tautan yang di-host; satu fetch lalu mengembalikan token baru untuk setiap tugas pada TikTok, YouTube dan LinkedIn, dan event yang ditandatangani membawa komentar dan DM ke rute Anda. Agen yang dibangun dengan TypeScript MCP SDK mendapatkan akun yang sama sebagai alat.
Video yang diterima endpoint publikasi TikTok per akun, dengan batas tidak lebih dari enam per menit.
Seberapa jauh ke depan postingan Halaman Facebook dapat dijadwalkan dengan published false dan scheduled_publish_time.
Header respons yang membawa URN postingan LinkedIn baru, dikirim dengan status 201.
Seberapa cepat TikTok mengirim event comment.update setelah komentar dibuat, dihapus, atau diubah visibilitasnya.
Berapa lama tautan koneksi Partner API tetap terbuka sebelum sesinya kedaluwarsa.
Bagaimana backend Node.js menghubungkan akun dan mendapatkan token-nya?
Backend Anda membuka sesi koneksi dan pemilik akun menyelesaikannya di peramban. Permintaan POST ke /connect-sessions, dengan kunci ec_live_ Anda sebagai bearer token, saluran seperti tiktok atau linkedin, redirect_url, dan external_ref untuk pelanggan Anda, mengembalikan url di easycoexistence.com. Di sana pemilik masuk di layar persetujuan milik jaringan dan kembali ke redirect_url Anda dengan status=connected dan channel_id; percobaan yang dibatalkan bisa dicoba kembali dari tautan yang sama hingga kedaluwarsa, satu jam setelah dibuat.
Setiap tugas kemudian dimulai dengan GET /channels/{id}?credentials=1. Jawabannya berisi token yang berlaku saat ini (bukan di Instagram dan Facebook, yang tokennya tidak pernah diberikan) ditambah kolom yang dibutuhkan setiap jaringan: graph_api_base dan account_id_on_meta di Instagram dan Facebook, api_base dan business_id di TikTok, channel_id di YouTube, author_urn dan required_headers di LinkedIn. Event channel.connected, channel.disconnected, channel.removed dan channel.suspended yang ditandatangani, dikirim ke URL event yang diatur di dashboard Anda, memberi tahu aplikasi Anda saat sebuah akun berubah.
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;
}Bagaimana cara memposting ke Instagram dan Facebook dari Node.js?
Instagram menerbitkan melalui sebuah container. Untuk Reel, buat dengan media_type REELS, video_url dan caption, lalu polling status_code sampai bernilai FINISHED, kemudian panggil media_publish dengan id container sebagai creation_id. Meta menyarankan polling sekitar satu menit sekali dan berhenti menunggu setelah lima menit; kesalahan atau EXPIRED berarti container tidak akan terbit, dan container yang belum diterbitkan selama 24 jam kedaluwarsa dengan sendirinya.
Halaman Facebook menerima foto dalam satu panggilan ke /{page-id}/photos, dengan url gambar dan caption, sedangkan teks dan tautan dikirim ke /{page-id}/feed. Keduanya menerima published false dengan scheduled_publish_time, dan Meta sendiri menerbitkan postingan saat waktunya tiba, antara 10 menit hingga 30 hari ke depan. Token dikirim sebagai header bearer, versi Graph API sudah ada di dalam graph_api_base, dan media harus berada di URL publik yang diunduh Meta.
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
});
}Bagaimana cara memposting ke LinkedIn dan mengunggah ke YouTube dari Node.js?
LinkedIn membutuhkan dua header tambahan selain bearer token di setiap panggilan: LinkedIn-Version, dengan nilai YYYYMM yang dikembalikan easyCoexistence di required_headers, dan X-Restli-Protocol-Version diatur ke 2.0.0. Postingan berupa POST ke /rest/posts dengan URN penulis, teks sebagai commentary, visibilitas PUBLIC, feed utama sebagai distribution, dan lifecycleState PUBLISHED. LinkedIn menjawab 201 dan menaruh URN postingan baru di header x-restli-id, dan URN apa pun yang diletakkan di path URL harus di-URL-encode.
YouTube membutuhkan dua permintaan. POST ke endpoint unggah dengan uploadType=resumable dan part=snippet,status mengirim metadata dan mengembalikan alamat sesi di header Location; PUT byte file ke alamat itu mengembalikan resource video beserta id-nya. Mengunggah sebagai private dengan tanggal publishAt membiarkan penerbitan ke penjadwal YouTube sendiri, sehingga tidak ada yang harus berjalan di sistem Anda pada jam tersebut.
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;
}Bagaimana cara menerima komentar dan DM di rute Node.js?
Setiap saluran meneruskan ke URL yang Anda berikan di PUT /channels/{id}/webhook, dan panggilan itu mengembalikan signing_secret saluran sekali saja. Setiap pengiriman berupa POST berisi platform, account_id, external_id dan entry, dengan header X-EC-Signature berbentuk t=<unix>,v1=<hex>, di mana v1 adalah HMAC-SHA256 dari t, titik, dan body mentah. Ambil body sebagai teks sebelum mem-parsing-nya, tolak t yang lebih lama dari lima menit, dan bandingkan dengan timingSafeEqual.
Untuk Instagram dan Facebook, entry adalah entry webhook Meta persis seperti yang dikirim Meta: changes untuk komentar dan mention, messaging untuk DM. Untuk TikTok isinya event comment.update, yang dikirim TikTok dalam lima menit setelah komentar, dengan comment_id dan video_id sebagai string agar JavaScript tidak membulatkan angka 64-bit tersebut. Hanya ada satu percobaan per event dan tidak ada salinan yang disimpan, jadi balas 204 segera dan proses dari antrean.
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 });
}Bagaimana cara membalas komentar dan DM dari Node.js?
Dengan panggilan kredensial baru dan id dari event. Di Instagram dan Facebook, balasan DM dikirim ke /{account-id}/messages, menggunakan account_id_on_meta, dengan id pengirim sebagai recipient dan dalam 24 jam dari pesan terakhir mereka; Halaman menambahkan messaging_type RESPONSE, dan Instagram mengizinkan paling banyak 1.000 byte teks. Komentar mendapat balasan publik, di /{comment-id}/replies di Instagram atau /{comment-id}/comments di Facebook, atau satu balasan privat dalam 7 hari.
Percakapan TikTok tetap publik, karena TikTok tidak punya DM. business/comment/reply/create/, dengan header Access-Token, business_id, video_id dan comment_id, mengirim balasan hingga 1.200 karakter. Baca kolom code pada jawaban, di mana 0 berarti berhasil, bukan status HTTP. Bertindaklah hanya pada comment_action insert dengan comment_type comment, karena balasan Anda sendiri juga datang sebagai event.
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 },
});
}
}
}Bagaimana cara memposting ke TikTok dan memberi agen TypeScript alat ini?
Keduanya melalui server MCP easyCoexistence di https://easycoexistence.com/api/mcp, yang hanya menerima OAuth 2.1: pendaftaran klien dinamis, kode otorisasi dengan PKCE, access token yang berlaku satu jam, dan refresh token. Dengan @modelcontextprotocol/client, SDK TypeScript resmi untuk Node 20 ke atas, OAuthClientProvider menyimpan klien, token, dan verifier PKCE; koneksi pertama mengirim pengguna untuk masuk dan melempar UnauthorizedError, dan finishAuth dengan query dari callback menyelesaikannya.
Publikasi TikTok ada di sini karena TikTok hanya mengunduh media dari prefiks URL yang sudah diverifikasi untuk aplikasi pengembang di balik token. publish_tiktok_post menerima tautan HTTPS Anda dan memberi TikTok alamat bertanda tangan pada rute media terverifikasi easyCoexistence, dan get_tiktok_publish_status memantau postingan. Klien yang sama memberi agen setiap alat untuk jaringan akun tersebut; panggil list_social_accounts terlebih dahulu, yang account_id-nya adalah id saluran Partner API.
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_statusKesalahan umum
- Menghitung HMAC atas JSON yang sudah di-parse dan diserialisasi ulang. Tanda tangan mencakup body mentah byte demi byte, jadi panggil req.text() terlebih dahulu dan parse setelahnya, atau setiap pengiriman gagal pemeriksaan.
- Mengubah id TikTok menjadi angka. Id komentar dan video berukuran 64-bit dan Number() membulatkannya, jadi simpan string yang dibawa event saat membalas atau mencari komentar.
- Hanya menyimpan channel_id dari redirect. Login Facebook atau LinkedIn bisa menambahkan beberapa Halaman sekaligus, jadi daftarkan dengan GET /channels?external_ref= dan simpan setiap satunya.
- Membalas DM Messenger atau Instagram dari batch malam hari. Di luar 24 jam dari pesan terakhir orang tersebut, pengiriman gagal, jadi balas dari event handler selama jendela masih terbuka.
easyCoexistence memberi backend Node.js dan agen AI jangkauan ke pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn dan saluran lainnya, masing-masing melalui API resminya. Hubungkan akun dengan Partner API, ambil token baru dan event yang ditandatangani, dan biarkan agen TypeScript bertindak melalui server MCP, dengan setiap koneksi dipantau 24/7. US$ 9 hingga US$ 0.75 per koneksi per bulan, makin turun seiring penambahan koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah saya butuh SDK untuk memanggil API ini dari Node?
Tidak. Partner API dan API jaringan adalah HTTPS biasa, sehingga fetch global di Node 18 ke atas sudah cukup. @modelcontextprotocol/client hanya dibutuhkan untuk alat MCP, termasuk publikasi TikTok.
Mengapa publikasi TikTok melalui server MCP?
TikTok hanya mengunduh video dan foto dari domain atau prefiks URL yang diverifikasi untuk aplikasi pengembang, dan aplikasi itu milik easyCoexistence. publish_tiktok_post menyajikan file HTTPS Anda dari alamat terverifikasi tersebut, sehingga domain Anda sendiri tidak perlu verifikasi.
Bisakah satu login menghubungkan beberapa Halaman Facebook atau LinkedIn?
Bisa. Setiap Halaman, dan di LinkedIn profil anggota itu sendiri, menjadi saluran sendiri dengan koneksinya sendiri. Redirect membawa channel_id pertama, dan GET /channels?external_ref= mendaftarkan semuanya.
Berapa biaya easyCoexistence untuk Node.js?
US$ 9 hingga US$ 0.75 per koneksi per bulan, makin turun seiring penambahan koneksi, dan sama di setiap jaringan. Partner API dan konektor MCP sudah termasuk, tanpa kursi, dan 3 hari pertama gratis.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada