మల్టీ-టెనెంట్ సోషల్ మీడియా API: ఒక API కీ, అనేక కస్టమర్ల ఖాతాలు
easyCoexistence Partner API డిజైన్ ప్రకారమే మల్టీ-టెనెంట్: మీ ఖాతాలోని ఒకే ec_live_ కీ అనేక కస్టమర్ల WhatsApp నంబర్లను మరియు సోషల్ ఖాతాలను కనెక్ట్ చేసి నిర్వహిస్తుంది. ప్రతి కనెక్షన్లో మీ కస్టమర్ ID external_ref గా ఉంటుంది, ఆ కస్టమర్ స్వంత టోకెన్ ఉంటుంది, దానికి ప్రత్యేక వెబ్హుక్ గమ్యం ఉంటుంది, మరియు సంతకం చేసిన స్టేటస్ ఈవెంట్లలో కనిపిస్తుంది, కాబట్టి GET /channels?external_ref= ఒక కస్టమర్ ఖాతాలను జాబితా చేస్తుంది.
కనెక్ట్ సెషన్ తీసుకునే గరిష్ట external_ref: మీ కస్టమర్ కోసం మీ స్వంత ID, అది సృష్టించే కనెక్షన్పై నిల్వ అవుతుంది.
ఒక easyCoexistence ఖాతా ఒకేసారి కలిగి ఉండగల API కీలు; వేర్వేరు కీలు అంటే వేర్వేరు ఖాతాలు, వేర్వేరు బిల్లులు.
ఒక ఖాతా ఒకేసారి తెరిచి ఉంచగల కనెక్ట్ సెషన్లు, గంటకు 100 కొత్త సెషన్ల పరిమితితో పాటు.
సంతకం చేసిన ఈవెంట్ టైమ్స్టాంప్ తిరస్కరించాల్సిన వయస్సు, HMAC స్థిరమైన సమయంలో పోల్చబడుతుంది.
ఒక ఖాతా అనేక కస్టమర్లకు ఎలా సేవ చేస్తుంది?
మీ easyCoexistence ఖాతా మీ ఉత్పత్తిని సూచిస్తుంది, ప్రతి కస్టమర్ వారు తెచ్చే కనెక్షన్లపై ఒక ట్యాగ్ మాత్రమే. కస్టమర్లకు స్వంత ఖాతా ఉండదు, వారు మీ కీని ఎప్పుడూ చూడరు, మరియు వారికి బిల్లు మీరు చేస్తారు, easyCoexistence కాదు:
ప్రతి కనెక్షన్ను మీ కస్టమర్తో ఎలా ట్యాగ్ చేస్తారు?
కనెక్ట్ సెషన్పై external_ref పంపండి. ఆ విలువ సెషన్ సృష్టించే నంబర్ లేదా ఛానల్పై నిల్వ అవుతుంది, రీడైరెక్ట్కు జోడించబడుతుంది, మరియు దాని స్టేటస్ ఈవెంట్లలో చేర్చబడుతుంది. ఒకే Facebook లేదా LinkedIn సైన్-ఇన్ అనేక పేజీలను తెచ్చినప్పుడు, ప్రతి దానికి ట్యాగ్ వేయబడుతుంది. ఒక కస్టమర్ ఖాతాలను చూడడానికి, రెండు జాబితాల్లో దేనినైనా ఫిల్టర్ చేయండి:
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"కస్టమర్ల టోకెన్లు వేరుగా ఎలా ఉంచబడతాయి?
ప్రతి కనెక్షన్ తన కస్టమర్ యొక్క స్వంత టోకెన్ను కలిగి ఉంటుంది. WhatsApp నంబర్ టోకెన్ Embedded Signup వద్ద Meta జారీ చేసే వ్యాపార టోకెన్, ఆ కస్టమర్ ఆస్తులకు మాత్రమే పరిమితం; సోషల్ ఖాతా టోకెన్ దాని యజమాని మంజూరు చేసినది. ఆధారాలు మీ కీ ద్వారా మాత్రమే, మీ బ్యాకెండ్ నుండి మాత్రమే వస్తాయి, మరియు మీ ఖాతాలో లేని ID 404 not_found అని జవాబిస్తుంది. ఒక పని ఏ కస్టమర్కు చెందినదో ముందుగా ఆ కనెక్షన్ను చూడండి, అప్పుడు మాత్రమే దాని టోకెన్ను పొందండి, తద్వారా ఒక టెనెంట్ పని మరొకరి ఖాతాపై ఎప్పుడూ నడవదు.
ప్రతి కస్టమర్కు వెబ్హుక్లు ఎలా పని చేస్తాయి?
ప్రతి ఖాతాకు ఒక గమ్యం, మీరు ఎంచుకున్నది. ఛానళ్లన్నింటినీ ఒక URL కు పాయింట్ చేసి, బాడీలోని account_id ఆధారంగా రూట్ చేయండి, లేదా ప్రతి కస్టమర్కు స్వంత URL ఇవ్వండి. ప్రతి ఛానల్ PUT /channels/{id}/webhook నుండి తన స్వంత సీక్రెట్తో సంతకం చేస్తుంది, కాబట్టి account_id ఏ సీక్రెట్తో ధృవీకరించాలో మీకు చెబుతుంది. నంబర్ సందేశాలు Meta నుండి WhatsApp Business Account పై సెట్ చేసిన webhook_url కు వెళ్తాయి, కాబట్టి వాటిని phone_number_id ఆధారంగా రూట్ చేయండి.
స్టేటస్ ఈవెంట్లు ఏ కస్టమర్కు చెందినవో ఎలా చెబుతాయి?
మీ external_ref ను కలిగి ఉండడం ద్వారా. ప్రతి ఖాతాకు ఒక ఈవెంట్ల URLకు connection.* మరియు channel.* ఈవెంట్లు చేరతాయి, ప్రతి దానిలో కనెక్షన్ లేదా ఛానల్ వ్యూ ఉంటుంది, external_ref తో సహా; post.published మరియు post.failed పోస్ట్ను, దాని ఛానల్ను కలిగి ఉంటాయి. ఈవెంట్లు X-EC-Signature లో ఖాతా స్వంత సీక్రెట్తో సంతకం చేయబడతాయి, మీ ఎండ్పాయింట్ విఫలమైనప్పుడు మళ్లీ పంపబడతాయి, కాబట్టి ప్రతి డెలివరీ ID ని ఒక్కసారి మాత్రమే నిర్వహించండి.
ఎంతమంది కస్టమర్లను ఎంత వేగంగా ఆన్బోర్డ్ చేయవచ్చు?
ప్రతి ఖాతాకు 50 తెరిచి ఉన్న కనెక్ట్ సెషన్లు, గంటకు 100 కొత్తవి. Meta ప్రతి మొదటిసారి WhatsApp ఆన్బోర్డింగ్ను, అందరు easyCoexistence ఖాతాలు పంచుకునే యాప్-వ్యాప్త పరిమితికి వ్యతిరేకంగా లెక్కిస్తుంది, మరియు ఈ పరిమితులు ఒక ప్లాట్ఫామ్ దిగుమతి దాన్ని ఖర్చు చేయకుండా కాపాడతాయి. ప్రతి సెషన్ను దాని కస్టమర్ కనెక్ట్ కావడానికి సిద్ధమైనప్పుడే సృష్టించండి; పరిమితి 429 cap_reached లేదా rate_limited గా జవాబిస్తుంది.
కస్టమర్ ఖాతా ఇప్పటికే మరెక్కడో కనెక్ట్ అయి ఉంటే ఏమవుతుంది?
సైన్-ఇన్ తిరస్కరించబడుతుంది. ఒక సోషల్ ఖాతా ఒకేసారి ఒక easyCoexistence ఖాతా ద్వారా మాత్రమే కనెక్ట్ అవుతుంది, కాబట్టి easyCoexistence ను ఉపయోగించే మరొక సేవ దాన్ని కలిగి ఉంటే, సెషన్ యొక్క last_error అది చెబుతుంది, మరియు కస్టమర్ అక్కడ తీసివేయాలి లేదా వేరే ఖాతాతో సైన్ ఇన్ చేయాలి. మీ స్వంత ఖాతాలో, కస్టమర్ ఎన్ని ఖాతాలైనా కనెక్ట్ చేయవచ్చు, ప్రతి దానికి అదే external_ref ట్యాగ్ ఉంటుంది.
ఒక కస్టమర్ను ఎలా తొలగిస్తారు?
వారి కనెక్షన్లు, ఛానళ్లను external_ref ద్వారా జాబితా చేసి, ప్రతిదాన్ని DELETE చేయండి. నంబర్ను తీసివేస్తే Meta వద్ద easyCoexistence యాక్సెస్ రద్దవుతుంది మరియు పర్యవేక్షణ ఆగిపోతుంది; ఛానల్ను తీసివేస్తే నెట్వర్క్ వద్ద యాక్సెస్ రద్దవుతుంది మరియు క్యూలో ఇంకా ఉన్న దాని పోస్ట్లు రద్దవుతాయి. ప్రతిదానికి బిల్లింగ్ సైకిల్ ముగింపులో ఆగుతుంది, మరియు కస్టమర్ యొక్క ఇతర కనెక్షన్లు, ఇతర టెనెంట్ల వలెనే, తాకబడవు.
సాధారణ పొరపాట్లు
- ఈమెయిల్ను external_ref గా వాడడం. ఈమెయిల్లు మారుతాయి, మరియు విలువ ప్రతి కనెక్షన్పై నిల్వ అవుతుంది, కాబట్టి మీ స్వంత డేటాబేస్ నుండి స్థిరమైన ID ను వాడండి.
- ఫార్వర్డ్ చేసిన ఈవెంట్లను తప్పు టెనెంట్ సీక్రెట్తో ధృవీకరించడం. బాడీలోని account_id ద్వారా సీక్రెట్ను వెతకండి, ఎందుకంటే ప్రతి ఛానల్ తన స్వంతదానితో సంతకం చేస్తుంది.
- కస్టమర్ లందరికీ ఒకేసారి కనెక్ట్ లింక్లు పంపడం. ఖాతాకు 50 సెషన్లు మాత్రమే తెరిచి ఉండగలవు, కాబట్టి కస్టమర్లను విడతలుగా ఆహ్వానించండి.
- మీ స్వంత డేటాబేస్లో మాత్రమే కస్టమర్ను తొలగించడం. వారి కనెక్షన్లు మీ ఖాతాలోనే, మీ బిల్లులోనే ఉంటాయి, ప్రతిదాన్ని API ద్వారా తీసివేసే వరకు.
easyCoexistence ఒక API కీ ద్వారా మీ మొత్తం కస్టమర్ బేస్కు సేవ చేయడానికి అనుమతిస్తుంది: వారి WhatsApp నంబర్లు, Instagram, Facebook, TikTok, YouTube మరియు LinkedIn ఖాతాలు, ఇంకా మరిన్ని ఛానళ్లు, ప్రతిదీ మీ కస్టమర్ ID తో ట్యాగ్ చేయబడి, స్వంత టోకెన్, వెబ్హుక్ మరియు సంతకం చేసిన ఈవెంట్లతో, ప్రతి కనెక్షన్ 24/7 పర్యవేక్షించబడుతుంది. ప్రతి కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీరు కనెక్షన్లు జోడించే కొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
ప్రతి కస్టమర్కు నాకు ఒక easyCoexistence ఖాతా అవసరమా?
లేదు. ఒక ఖాతా మరియు దాని కీ అనేక కస్టమర్ల కనెక్షన్లను కలిగి ఉండగలదు, అవి external_ref ద్వారా వేరు చేయబడతాయి. వేర్వేరు బిల్లులు కావాలంటేనే వేర్వేరు ఖాతాలు అవసరం.
నా కస్టమర్లు ఒకరి ఖాతాలను మరొకరు చూడగలరా?
easyCoexistence ద్వారా కాదు. వారు మీ కీని ఎప్పుడూ కలిగి ఉండరు, వారు తమ స్వంత కనెక్ట్ లింక్లను మాత్రమే తెరుస్తారు. మీ ఉత్పత్తిలో ప్రతి కస్టమర్ ఏమి చూస్తారో మీ కోడ్ నిర్ణయిస్తుంది.
ప్రతి కస్టమర్కు వేరే వెబ్హుక్ URL ఇవ్వగలనా?
అవును. ప్రతి నంబర్ మరియు ప్రతి ఛానల్ తన స్వంత గమ్యాన్ని తీసుకుంటుంది, కాబట్టి కస్టమర్-నిర్దిష్ట URL పనిచేస్తుంది, అలాగే account_id ద్వారా రూట్ చేయబడిన ఒకే భాగస్వామ్య URL కూడా.
అనేక టెనెంట్ల ఖాతాకు బిల్లింగ్ ఎలా ఉంటుంది?
మీ కస్టమర్లందరి కలిపి ప్రతి కనెక్షన్కు: నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీ మొత్తం సంఖ్య యొక్క బ్యాండ్ ద్వారా నిర్ణయించబడుతుంది, మొదటి 3 రోజులు ఉచితం.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ