Objavljujte na Instagramu, TikToku i Facebooku iz Node.js-a jednim API-jem
Uz easyCoexistence, backend na Node.js-u ili TypeScriptu objavljuje na Instagramu, Facebooku, TikToku, YouTubeu i LinkedInu preko zvaničnog API-ja svake mreže. Nalozi se povezuju jednom, preko hostovanog linka; jedan fetch zatim vraća svež token za svaki posao na TikToku, YouTubeu i LinkedInu, a potpisani događaji šalju komentare i DM poruke na vašu rutu. Agenti napravljeni na TypeScript MCP SDK-u dobijaju iste naloge kao alate.
Video objave koje TikTokov endpoint za objavljivanje prihvata po nalogu, najviše šest u minuti.
Koliko unapred se Facebook objava na stranici može zakazati uz published false i scheduled_publish_time.
Zaglavlje odgovora koje nosi URN nove LinkedIn objave, poslato uz status 201.
Koliko brzo TikTok šalje događaj comment.update nakon što se komentar kreira, obriše ili promeni mu se vidljivost.
Koliko dugo ostaje otvoren link za povezivanje Partner API-ja pre nego što sesija istekne.
Kako backend na Node.js-u povezuje naloge i dobija njihove tokene?
Vaš backend otvara sesiju za povezivanje, a vlasnik naloga završava u pregledaču. POST na /connect-sessions, sa ec_live_ ključem kao bearer tokenom, kanalom poput tiktok ili linkedin, redirect_url i external_ref za vašeg kupca, vraća url na easycoexistence.com. Tamo se vlasnik naloga prijavljuje na sopstveni ekran za saglasnost mreže i vraća na vaš redirect_url sa status=connected i channel_id. Otkazan pokušaj može da se ponovi preko istog linka dok ne istekne, sat vremena posle kreiranja.
Svaki posao zatim počinje sa GET /channels/{id}?credentials=1. Odgovor sadrži token koji važi odmah (ne na Instagramu i Facebooku, čiji se tokeni nikada ne izdaju) i polja koja svaka mreža traži: graph_api_base i account_id_on_meta za Instagram i Facebook, api_base i business_id za TikTok, channel_id za YouTube, author_urn i required_headers za LinkedIn. Potpisani događaji channel.connected, channel.disconnected, channel.removed i channel.suspended, poslati na URL za događaje podešen u kontrolnoj tabli, govore vašoj aplikaciji kada se nalog promeni.
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;
}Kako objavljujete na Instagramu i Facebooku iz Node.js-a?
Instagram objavljuje preko kontejnera. Za Reel ga kreirajte sa media_type REELS, video_url i caption, zatim proveravajte status_code dok ne bude FINISHED, pa pozovite media_publish sa id-jem kontejnera kao creation_id. Meta preporučuje proveru otprilike jednom u minut i odustajanje posle pet minuta. ERROR ili EXPIRED znači da kontejner neće biti objavljen, a onaj koji ostane neobjavljen 24 sata ističe sam od sebe.
Facebook stranica prima fotografiju u jednom pozivu na /{page-id}/photos, sa url-om slike i opisom, dok se tekst i linkovi šalju na /{page-id}/feed. Oba prihvataju published false sa scheduled_publish_time, a Meta sama objavljuje kada dođe vreme, između 10 minuta i 30 dana unapred. Token ide kao bearer zaglavlje, verzija Graph API-ja je već u graph_api_base, a medijski fajl mora da stoji na javnom URL-u koji Meta preuzima.
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
});
}Kako objavljujete na LinkedInu i otpremate na YouTube iz Node.js-a?
LinkedIn traži dva zaglavlja uz bearer token pri svakom pozivu: LinkedIn-Version, sa vrednošću YYYYMM koju easyCoexistence vraća u required_headers, i X-Restli-Protocol-Version postavljeno na 2.0.0. Objava je POST na /rest/posts sa URN-om autora, tekstom kao commentary, PUBLIC vidljivošću, glavnim feedom kao distribution i lifecycleState PUBLISHED. LinkedIn odgovara sa 201 i stavlja URN nove objave u zaglavlje x-restli-id, a svaki URN koji ide u putanju URL-a mora biti URL-enkodovan.
YouTube traži dva zahteva. POST na endpoint za otpremanje sa uploadType=resumable i part=snippet,status šalje metapodatke i vraća adresu sesije u zaglavlju Location. PUT bajtova fajla na tu adresu vraća resurs videa sa njegovim id-jem. Otpremanje kao privatni video sa datumom publishAt prepušta objavljivanje YouTubeovom sopstvenom planeru, pa ništa vaše ne mora da radi u tom trenutku.
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;
}Kako primate komentare i DM poruke u Node.js ruti?
Svaki kanal šalje događaje na URL koji navedete u PUT /channels/{id}/webhook, a taj poziv jednom vraća signing_secret kanala. Svaka isporuka je POST sa platform, account_id, external_id i entry, i zaglavljem X-EC-Signature oblika t=<unix>,v1=<hex>, gde je v1 HMAC-SHA256 od t, tačke i sirovog tela. Telo uzmite kao tekst pre parsiranja, odbacite t starije od pet minuta i poredite sa timingSafeEqual.
Za Instagram i Facebook, entry je Metin webhook entry kakav je Meta poslala: changes za komentare i pominjanja, messaging za DM poruke. Za TikTok sadrži događaj comment.update, koji TikTok šalje u roku od pet minuta od komentara, sa comment_id i video_id kao stringovima, da JavaScript ne bi zaokružio ta 64-bitna broja. Postoji jedan pokušaj po događaju i nema sačuvane kopije, pa odmah odgovorite 204 i obradu radite iz reda čekanja.
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 });
}Kako odgovarate na komentare i DM poruke iz Node.js-a?
Svežim pozivom credentials i id-jevima iz događaja. Na Instagramu i Facebooku, odgovor na DM ide na /{account-id}/messages, preko account_id_on_meta, sa id-jem pošiljaoca kao recipient i unutar 24 sata od njegove poslednje poruke. Stranica dodaje messaging_type RESPONSE, a Instagram dopušta najviše 1.000 bajtova teksta. Komentar dobija javni odgovor, na /{comment-id}/replies na Instagramu ili /{comment-id}/comments na Facebooku, ili jedan privatni odgovor u roku od 7 dana.
TikTok razgovori ostaju javni, jer na TikToku nema DM poruka. business/comment/reply/create/, sa zaglavljem Access-Token, business_id, video_id i comment_id, objavljuje odgovor do 1.200 znakova. Čitajte polje code u odgovoru, gde 0 znači uspeh, a ne HTTP status. Reagujte samo na comment_action insert sa comment_type comment, jer i vaši sopstveni odgovori stižu kao događaji.
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 },
});
}
}
}Kako objavljujete na TikToku i dajete TypeScript agentu ove alate?
Oboje ide preko easyCoexistence MCP servera na https://easycoexistence.com/api/mcp, koji prihvata samo OAuth 2.1: dinamičku registraciju klijenta, kod za autorizaciju sa PKCE, pristupne tokene koji važe sat vremena i tokene za osvežavanje. Uz @modelcontextprotocol/client, zvanični TypeScript SDK za Node 20 i novije, OAuthClientProvider čuva klijenta, tokene i PKCE verifikator. Prvo povezivanje šalje korisnika na prijavu i baca UnauthorizedError, a finishAuth sa query parametrima povratnog poziva ga završava.
TikTok objavljivanje je ovde jer TikTok preuzima medijske fajlove samo sa URL prefiksa verifikovanih za developer aplikaciju iza tokena. publish_tiktok_post uzima vaš HTTPS link i daje TikToku potpisanu adresu na verifikovanoj medijskoj ruti easyCoexistence-a, a get_tiktok_publish_status prati objavu. Isti klijent agentu daje sve alate za mreže povezane na nalogu. Prvo pozovite list_social_accounts, čiji je account_id id kanala iz Partner API-ja.
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_statusČeste greške
- Računanje HMAC-a nad parsiranim i ponovo serijalizovanim JSON-om. Potpis pokriva sirovo telo bajt po bajt, pa prvo pozovite req.text(), a parsirajte posle, inače svaka isporuka pada na proveri.
- Pretvaranje TikTok id-jeva u brojeve. Id-jevi komentara i videa su 64-bitni, a Number() ih zaokružuje, pa zadržite stringove koje događaj nosi kad odgovarate ili tražite komentar.
- Zadržavanje samo channel_id iz preusmeravanja. Prijava na Facebook ili LinkedIn može odjednom dodati više stranica, pa ih izlistajte preko GET /channels?external_ref= i sačuvajte svaku.
- Odgovaranje na Messenger ili Instagram DM iz noćne serije. Posle 24 sata od poslednje poruke osobe slanje ne uspeva, pa odgovarajte iz rukovaoca događajima dok je prozor otvoren.
easyCoexistence daje backendima na Node.js-u i AI agentima pristup kupcima na WhatsAppu, Instagramu, Facebooku, TikToku, YouTubeu, LinkedInu i još kanala, svaki preko zvaničnog API-ja. Povezujte naloge preko Partner API-ja, dobijajte sveže tokene i potpisane događaje, a TypeScript agenti deluju preko MCP servera, uz praćenje svake veze 24/7. Od US$ 9 do US$ 0,75 po vezi mesečno, a cena pada kako dodajete veze, uz prva 3 dana besplatno.
Često postavljana pitanja
Da li su mi potrebni SDK-ovi za pozivanje ovih API-ja iz Node.js-a?
Ne. Partner API i API-ji mreža su obični HTTPS, pa globalni fetch u Node 18 i novijim verzijama pokriva sve. @modelcontextprotocol/client je potreban samo za MCP alate, među kojima je i objavljivanje na TikToku.
Zašto objavljivanje na TikToku ide preko MCP servera?
TikTok preuzima video snimke i fotografije samo sa domena ili URL prefiksa verifikovanog za developer aplikaciju, a ta aplikacija pripada easyCoexistence-u. publish_tiktok_post servira vaš HTTPS fajl sa te verifikovane adrese, pa vaš sopstveni domen ne treba verifikaciju.
Može li jedna prijava da poveže više Facebook ili LinkedIn stranica?
Može. Svaka stranica, a na LinkedInu i sopstveni profil člana, postaje zaseban kanal i zasebna veza. Preusmeravanje nosi prvi channel_id, a GET /channels?external_ref= ih sve izlistava.
Koliko košta easyCoexistence za Node.js?
Od US$ 9 do US$ 0,75 po vezi mesečno, uz pad kako dodajete veze, i isto na svakoj mreži. Partner API i MCP konektor su uključeni, bez naplate po korisniku, a prva 3 dana su besplatna.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na