एकाच API ने Node.js वरून Instagram, TikTok आणि Facebook वर पोस्ट करा
easyCoexistence सह Node.js किंवा TypeScript बॅकएंड प्रत्येक नेटवर्कच्या अधिकृत API द्वारे Instagram, Facebook, TikTok, YouTube आणि LinkedIn वर पोस्ट करतो. खाती एकदाच एका होस्टेड लिंकद्वारे साइन इन होतात; एक fetch TikTok, YouTube व LinkedIn वर प्रत्येक जॉबसाठी ताजा टोकन देतो, आणि साइन केलेले इव्हेंट कमेंट व DM तुमच्या राउटपर्यंत पोहोचवतात. TypeScript MCP SDK वर तयार केलेले एजंट त्याच खात्या टूल्स म्हणून मिळवतात.
TikTok च्या पब्लिशिंग एंडपॉइंटकडून प्रत्येक खात्यासाठी स्वीकारले जाणारे व्हिडिओ पोस्ट, मिनिटाला सहापेक्षा जास्त नाहीत.
published false आणि scheduled_publish_time वापरून Facebook Page पोस्ट किती पुढे शेड्यूल करता येते.
नवीन LinkedIn पोस्टची URN वाहून नेणारा प्रतिसाद हेडर, 201 स्टेटससह पाठवला जातो.
कमेंट तयार, हटवली किंवा दृश्यमानता बदलली गेल्यानंतर TikTok comment.update इव्हेंट किती लवकर पाठवतो.
Partner API कनेक्ट लिंक तिचे सेशन कालबाह्य होण्यापूर्वी किती काळ उघडी राहते.
Node.js बॅकएंड खाती कशी कनेक्ट करतो आणि त्यांचे टोकन कसे मिळवतो?
तुमचा बॅकएंड कनेक्ट सेशन उघडतो आणि खात्याचा मालक ब्राउझरमध्ये प्रक्रिया पूर्ण करतो. /connect-sessions वर POST, bearer टोकन म्हणून तुमची ec_live_ की, tiktok किंवा linkedin सारखा channel, redirect_url आणि तुमच्या ग्राहकासाठी external_ref पाठवल्यास easycoexistence.com वरील url परत येतो. तिथे मालक नेटवर्कच्या स्वतःच्या संमती स्क्रीनवर साइन इन करतो आणि status=connected व channel_id सह तुमच्या redirect_url वर परत येतो. रद्द झालेला प्रयत्न त्याच लिंकवरून पुन्हा करता येतो, ती तयार झाल्यानंतर एक तासाने कालबाह्य होईपर्यंत.
प्रत्येक जॉब GET /channels/{id}?credentials=1 ने सुरू होतो. उत्तरात सध्या वैध असलेला टोकन (Instagram व Facebook चा नाही, ज्यांचे टोकन कधीही दिले जात नाहीत) आणि प्रत्येक नेटवर्कला लागणारी फील्ड्स असतात: Instagram व Facebook वर graph_api_base आणि account_id_on_meta, TikTok वर api_base आणि business_id, YouTube वर channel_id, LinkedIn वर author_urn आणि required_headers. channel.connected, channel.disconnected, channel.removed आणि channel.suspended इव्हेंट्स, जे तुमच्या डॅशबोर्डमध्ये सेट केलेल्या इव्हेंट्स यूआरएलवर साइन करून पाठवले जातात, खाते बदलले की तुमच्या ॲपला सांगतात.
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 वरून Instagram आणि Facebook वर कशी पोस्ट करायची?
Instagram एका कंटेनरद्वारे प्रकाशित होतो. Reel साठी media_type REELS, video_url आणि caption सह कंटेनर तयार करा, त्याचा status_code FINISHED दिसेपर्यंत पोल करा, मग creation_id म्हणून कंटेनर आयडी देऊन media_publish कॉल करा. Meta दर मिनिटाला एकदा पोल करण्याची आणि पाच मिनिटांनंतर सोडून देण्याची शिफारस करते. ERROR किंवा EXPIRED म्हणजे कंटेनर प्रकाशित होणार नाही, आणि 24 तास प्रकाशित न झालेला कंटेनर आपोआप कालबाह्य होतो.
Facebook Page एका कॉलमध्ये /{page-id}/photos वर फोटो घेतो, इमेज यूआरएल आणि caption सह, तर मजकूर व लिंक /{page-id}/feed वर जातात. दोन्ही published false आणि scheduled_publish_time स्वीकारतात; 10 मिनिटे ते 30 दिवस आधी, वेळ आल्यावर पोस्ट Meta स्वतः प्रकाशित करते. टोकन bearer हेडरमध्ये जातो, Graph API आवृत्ती आधीच graph_api_base मध्ये असते, आणि मीडिया 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
});
}Node.js वरून LinkedIn वर पोस्ट कशी करायची आणि YouTube वर अपलोड कशी करायची?
LinkedIn प्रत्येक कॉलवर bearer टोकनसोबत दोन अतिरिक्त हेडर मागते: LinkedIn-Version, ज्यात easyCoexistence required_headers मध्ये परत करतो ती YYYYMM व्हॅल्यू असते, आणि X-Restli-Protocol-Version, 2.0.0 वर सेट केलेला. पोस्ट म्हणजे /rest/posts वर POST, ज्यात author URN, commentary म्हणून मजकूर, PUBLIC visibility, distribution म्हणून मुख्य फीड आणि lifecycleState PUBLISHED असते. LinkedIn 201 देतो आणि नवीन पोस्टची URN x-restli-id हेडरमध्ये ठेवतो. URL पथात ठेवलेली कोणतीही URN URL-encoded करावी लागते.
YouTube साठी दोन विनंत्या लागतात. uploadType=resumable आणि part=snippet,status असलेला POST अपलोड एंडपॉइंटवर मेटाडेटा पाठवतो आणि त्याच्या Location हेडरमध्ये सेशन पत्ता परत करतो. त्या पत्त्यावर फाइलच्या बाइट्सचे PUT केल्यावर id असलेला व्हिडिओ रिसोर्स परत येतो. publishAt तारखेसह private म्हणून अपलोड केल्यास प्रकाशनाची जबाबदारी YouTube च्या स्वतःच्या शेड्युलरकडे जाते, त्यामुळे त्या वेळी तुमचे काहीही चालवावे लागत नाही.
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 राउटमध्ये कमेंट व DM कसे मिळवायचे?
प्रत्येक चॅनल तुम्ही PUT /channels/{id}/webhook ला दिलेल्या यूआरएलवर फॉरवर्ड करतो, आणि तो कॉल चॅनलचा signing_secret एकदाच परत करतो. प्रत्येक डिलिव्हरी platform, account_id, external_id आणि entry सह POST असते, X-EC-Signature हेडरसह ज्याचा आकार t=<unix>,v1=<hex> असतो, जिथे v1 म्हणजे t, एक डॉट आणि कच्च्या बॉडीचा HMAC-SHA256. पार्स करण्यापूर्वी बॉडी टेक्स्ट म्हणून घ्या, पाच मिनिटांपेक्षा जुना t नाकारा, आणि timingSafeEqual ने तुलना करा.
Instagram व Facebook साठी entry म्हणजे Meta ने पाठवलेले तसेच Meta चे वेबहुक entry: कमेंट व उल्लेखांसाठी changes, DM साठी messaging. TikTok साठी त्यात comment.update इव्हेंट असतो, जो कमेंटनंतर पाच मिनिटांत फायर होतो, comment_id आणि video_id स्ट्रिंग म्हणून, जेणेकरून JavaScript ती 64-बिट संख्या गोल करू नये. प्रत्येक इव्हेंटला एकच प्रयत्न मिळतो आणि कॉपी साठवली जात नाही, म्हणून लगेच 204 द्या आणि रांगेतून प्रक्रिया करा.
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 वरून कमेंट व DM ना उत्तर कसे द्यायचे?
ताज्या credentials कॉलसह आणि इव्हेंटमधील आयडींसह. Instagram व Facebook वर DM उत्तर /{account-id}/messages वर जाते, account_id_on_meta वापरून, प्राप्तकर्ता म्हणून पाठवणाऱ्याचा आयडी आणि त्यांच्या शेवटच्या मेसेजच्या 24 तासांच्या आत. Page साठी messaging_type RESPONSE जोडा, आणि Instagram मजकुरासाठी जास्तीत जास्त 1,000 बाइट्स परवानगी देतो. कमेंटला सार्वजनिक उत्तर मिळते, Instagram वर /{comment-id}/replies वर किंवा Facebook वर /{comment-id}/comments वर, किंवा 7 दिवसांत एक खाजगी उत्तर.
TikTok संभाषणे सार्वजनिक राहतात, कारण TikTok वर DM नसतात. business/comment/reply/create/, Access-Token हेडर, business_id, video_id आणि comment_id सह, 1,200 अक्षरांपर्यंतचे उत्तर पोस्ट करते. HTTP स्टेटसऐवजी उत्तराचे code फील्ड वाचा, जिथे 0 म्हणजे यश. फक्त comment_type comment सह comment_action insert वर कृती करा, कारण तुमची स्वतःची उत्तरेही इव्हेंट म्हणून येतात.
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 },
});
}
}
}TikTok वर पोस्ट कशी करायची आणि TypeScript एजंटला ही टूल्स कशी द्यायची?
दोन्ही easyCoexistence च्या MCP सर्व्हरमार्गे जातात: https://easycoexistence.com/api/mcp, जो फक्त OAuth 2.1 स्वीकारतो: डायनॅमिक क्लायंट नोंदणी, PKCE सह authorization code, एक तास चालणारे access टोकन आणि refresh टोकन. Node 20 आणि पुढील आवृत्त्यांसाठी अधिकृत TypeScript SDK असलेल्या @modelcontextprotocol/client सह, OAuthClientProvider क्लायंट, टोकन आणि PKCE verifier ठेवतो. पहिल्या कनेक्टवर वापरकर्ता साइन इन करण्यासाठी पाठवला जातो आणि UnauthorizedError फेकला जातो, आणि कॉलबॅकच्या क्वेरीसह finishAuth ते पूर्ण करते.
TikTok पब्लिशिंग इथे आहे, कारण TikTok मीडिया फक्त त्या टोकनमागील डेव्हलपर ॲपसाठी पडताळलेल्या यूआरएल प्रीफिक्समधूनच डाउनलोड करतो. publish_tiktok_post तुमची HTTPS लिंक घेतो आणि easyCoexistence च्या पडताळलेल्या मीडिया राउटवरील सही केलेला पत्ता TikTok ला देतो, आणि get_tiktok_publish_status पोस्टचा मागोवा घेतो. त्याच क्लायंटद्वारे एजंटला खात्याच्या नेटवर्कसाठी प्रत्येक टूल मिळते. प्रथम list_social_accounts कॉल करा, ज्याचा account_id हा Partner API चा channel id आहे.
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सामान्य चुका
- HMAC पार्स आणि पुन्हा सीरियलाइज केलेल्या JSON वर मोजणे. सही कच्च्या बॉडीच्या प्रत्येक बाइटवर असते, म्हणून आधी req.text() कॉल करा आणि नंतर पार्स करा, नाहीतर प्रत्येक डिलिव्हरी तपासणीत अपयशी ठरेल.
- TikTok आयडी संख्यांमध्ये बदलणे. कमेंट व व्हिडिओ आयडी 64-बिट असतात आणि Number() त्यांना गोल करते, म्हणून उत्तर देताना किंवा कमेंट शोधताना इव्हेंटमधील स्ट्रिंग्स ठेवा.
- redirect मधून फक्त channel_id ठेवणे. Facebook किंवा LinkedIn साइन-इनमध्ये एकाच वेळी अनेक Page जोडता येतात, म्हणून GET /channels?external_ref= ने त्यांची यादी करा आणि प्रत्येकाला साठवा.
- रात्रीच्या बॅचमधून Messenger किंवा Instagram DM ना उत्तर देणे. व्यक्तीच्या शेवटच्या मेसेजच्या 24 तासांनंतर पाठवणे अयशस्वी होते, म्हणून खिडकी उघडी असताना इव्हेंट हँडलरमधूनच उत्तर द्या.
easyCoexistence Node.js बॅकएंड आणि AI एजंट्सना WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn आणि आणखी चॅनलवरील ग्राहकांपर्यंत पोहोच देते, प्रत्येक चॅनल त्याच्या अधिकृत API द्वारे. Partner API ने खाती कनेक्ट करा, ताजे टोकन व साइन केलेले इव्हेंट मिळवा, आणि TypeScript एजंट्सना MCP सर्व्हरद्वारे कृती करू द्या. प्रत्येक कनेक्शनवर 24/7 निरीक्षण ठेवले जाते. प्रति कनेक्शन प्रति महिना US$ 9 ते US$ 0.75, कनेक्शन वाढवाल तसे कमी होत जाते, पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
Node.js वरून या API कॉल करण्यासाठी मला SDK लागतो का?
नाही. Partner API आणि नेटवर्कचे API साधे HTTPS आहेत, म्हणून Node 18 आणि पुढील आवृत्त्यांमधील global fetch पुरेसे आहे. @modelcontextprotocol/client फक्त MCP टूल्ससाठी लागतो, ज्यात TikTok पब्लिशिंगचाही समावेश आहे.
TikTok पब्लिशिंग MCP सर्व्हरमार्गे का जाते?
TikTok व्हिडिओ आणि फोटो फक्त डोमेन किंवा यूआरएल प्रीफिक्समधूनच डाउनलोड करतो, जो डेव्हलपर ॲपसाठी पडताळलेला असतो, आणि ते ॲप easyCoexistence चे आहे. publish_tiktok_post तुमची HTTPS फाइल त्या पडताळलेल्या पत्त्यावरून सर्व्ह करतो, म्हणून तुमच्या स्वतःच्या डोमेनला पडताळणीची गरज नाही.
एकाच साइन-इनमध्ये अनेक Facebook किंवा LinkedIn Page कनेक्ट होऊ शकतात का?
होय. प्रत्येक Page, आणि LinkedIn वर सदस्याची स्वतःची प्रोफाइल, स्वतःचा चॅनल आणि स्वतःचे कनेक्शन बनते. redirect पहिला channel_id घेऊन येतो, आणि GET /channels?external_ref= त्या सर्वांची यादी देतो.
Node.js साठी easyCoexistence किती खर्च येतो?
प्रति कनेक्शन प्रति महिना US$ 9 ते US$ 0.75, कनेक्शन वाढवाल तसे कमी होत जाते, आणि सर्व नेटवर्कवर सारखेच. Partner API आणि MCP कनेक्टर यात समाविष्ट आहेत, सीट्सशिवाय, आणि पहिले 3 दिवस मोफत आहेत.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: