लॉग इनमुफ़्त ट्रायल शुरू करें
easyCoexistence आधिकारिक एपीआई

ग्राहकों के WhatsApp, Instagram और TikTok पर एआई एजेंट प्रोडक्ट कैसे बनाएं

ग्राहकों के चैनल पर चलने वाला एआई एजेंट प्रोडक्ट तीन हिस्सों पर टिका है: हर ग्राहक के WhatsApp नंबर या सोशल अकाउंट के लिए एक होस्टेड कनेक्ट लिंक; वेबहुक, जो उनके मैसेज और कमेंट आपके बैकएंड तक पहुँचाते हैं, जहाँ आपका अपना मॉडल जवाब लिखता है और उसे ग्राहक के टोकन के साथ हर नेटवर्क के आधिकारिक एपीआई से भेजा जाता है; और स्टेटस इवेंट, जो बंद होने वाले कनेक्शनों की खबर देते हैं। एजेंट हर नेटवर्क के नियम मानता है, जैसे WhatsApp की 24 घंटे वाली विंडो।

easyCoexistence आपके प्रोडक्ट के एआई एजेंट को आपके ग्राहकों के WhatsApp नंबरों और उनके Instagram, Facebook, TikTok, YouTube और LinkedIn अकाउंट पर आवाज़ देता है, और आगे और चैनल भी जुड़ेंगे: होस्टेड कनेक्ट लिंक, ताज़ा क्रेडेंशियल, वेबहुक और हस्ताक्षरित स्टेटस इवेंट, हर नेटवर्क के आधिकारिक एपीआई पर, और हर कनेक्शन 24/7 निगरानी में।

24 hours

उपयोगकर्ता के मैसेज या कॉल के बाद WhatsApp की ग्राहक सेवा विंडो; हर नया मैसेज इसे फिर से शुरू करता है।

Templates only

ग्राहक सेवा विंडो बंद होने के बाद WhatsApp कारोबार क्या भेज सकता है: पहले से मंज़ूर किए गए टेम्पलेट मैसेज।

Section 4.7

Meta की शर्तें AI प्रदाताओं को WhatsApp पर AI को मुख्य कार्यक्षमता के रूप में देने से रोकती हैं, सहायक या गौण के रूप में नहीं।

7 days

Instagram अकाउंट की एक कमेंट पर एक निजी जवाब की विंडो, जो कमेंट किए जाने के समय से गिनी जाती है।

20 mps

WhatsApp Business ऐप और Cloud API दोनों के साथ इस्तेमाल होने वाले नंबर का तय थ्रूपुट।

हर ग्राहक के चैनल से एआई एजेंट प्रोडक्ट को क्या चाहिए?

चार चीज़ें: ग्राहक के लिए उसे कनेक्ट करने का तरीका, उनके मैसेज का आपके बैकएंड तक पहुँचना, जवाब भेजने के लिए एक टोकन, और कनेक्शन बंद होने पर खबर। Partner API इन सब को कवर करता है, जबकि मॉडल, प्रॉम्प्ट और बातचीत का लॉजिक आपके पास रहते हैं। easyCoexistence अकाउंट को कनेक्ट करता है, उसका एक्सेस रीन्यू रखता है और उस पर नज़र रखता है, और आपके जवाब आपके बैकएंड से सीधे नेटवर्क के एपीआई पर जाते हैं।

1ConnectA hosted link per customer: POST /connect-sessions
2ReceiveMessages from Meta; comments and DMs forwarded, signed
3DecideYour model, your prompts, your memory
4ReplyThe network's API, with the customer's token
5Watchconnection.* and channel.* status events

हर ग्राहक कैसे कनेक्ट करता है?

आपका बैकएंड POST /connect-sessions से एक कनेक्ट सेशन बनाता है, जिसमें चैनल, redirect_url और आपके ग्राहक के लिए external_ref लिखा होता है, और नंबर के लिए webhook_url और webhook_verify_token भी। ग्राहक होस्टेड लिंक खोलता है, Meta, TikTok, Google या LinkedIn से लॉग इन करता है, और connection_id या channel_id के साथ आपके ऐप पर लौट आता है। उसे easyCoexistence अकाउंट, ईमेल या कार्ड की ज़रूरत नहीं होती, और आपकी एपीआई की से बने हर कनेक्शन आपके अकाउंट में जुड़ते हैं।

मैसेज और कमेंट आपके मॉडल तक कैसे पहुँचते हैं?

वेबहुक के ज़रिए, उन नेटवर्क पर जो उन्हें भेजते हैं। Meta किसी नंबर के मैसेज सीधे उसके webhook_url पर भेजता है, और कारोबार के स्टाफ़ द्वारा WhatsApp Business ऐप से भेजे गए मैसेज smb_message_echoes के रूप में वहीं पहुँचते हैं। Instagram और Facebook के कमेंट, मेंशन और DM, तथा TikTok के कमेंट, हर चैनल के वेबहुक डेस्टिनेशन पर, उसके सीक्रेट से हस्ताक्षरित होकर, आगे भेजे जाते हैं। YouTube और LinkedIn कोई कमेंट इवेंट नहीं भेजते, इसलिए एजेंट शेड्यूल पर उनके एपीआई से नए कमेंट पढ़ता है। हर डिलीवरी को तुरंत 2xx से जवाब दें और मॉडल को वर्कर से कॉल करवाएं।

एजेंट जवाब कैसे देता है?

नेटवर्क के अपने एपीआई से, उन क्रेडेंशियल्स के साथ जो आपके बैकएंड ने प्राप्त किए हैं। WhatsApp जवाब नंबर के send_endpoint पर ग्राहक के टोकन के साथ किया गया POST है; Instagram या Facebook का DM अकाउंट के messages edge पर जाता है; TikTok का जवाब कमेंट के नीचे business/comment/reply/create/ के ज़रिए जाता है। नीचे दिया नमूना कोड WhatsApp मैसेज का जवाब देता है: वह URL path में सीक्रेट जाँचता है, आने वाला हर मैसेज कतार में डालता है, और आपके मॉडल का लौटाया जवाब भेजता है।

Python: a WhatsApp agent on your own model
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request

EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"}  # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"]  # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {}  # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)

@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
    if not hmac.compare_digest(secret, PATH_SECRET):
        abort(404)
    if request.method == "GET":  # Meta's handshake when the destination is set
        if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
            abort(403)
        return request.args.get("hub.challenge", "")
    for entry in request.get_json().get("entry", []):
        for change in entry.get("changes", []):
            if change.get("field") == "messages":  # echoes and history are context, not prompts
                value = change["value"]
                for msg in value.get("messages", []):
                    jobs.put((value["metadata"]["phone_number_id"], msg))
    return "", 200  # answer at once; dedupe on msg["id"], since Meta can deliver twice

def worker() -> None:
    while True:
        phone_number_id, msg = jobs.get()
        conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
                            headers=KEY, params={"credentials": 1}).json()
        creds = conn["credentials"]
        if not creds["access_token"]:  # token_ready is false: a new connect session issues one
            continue
        reply = my_model(conn["external_ref"], msg)  # your model, your prompt, your memory
        requests.post(creds["send_endpoint"],  # a reply to a fresh message is inside the 24 hours
                      headers={"Authorization": f"Bearer {creds['access_token']}"},
                      json={"messaging_product": "whatsapp", "to": msg["from"],
                            "type": "text", "text": {"body": reply}})

threading.Thread(target=worker, daemon=True).start()

MCP सर्वर या Partner API: एजेंट कौन सा इस्तेमाल करता है?

Partner API, जब एजेंट आपका प्रोडक्ट है और ग्राहक अपने चैनल लाते हैं: आपका बैकएंड एपीआई की रखता है, इवेंट प्राप्त करता है और आपकी चुनी कोई भी मॉडल चलाता है। https://easycoexistence.com/api/mcp पर MCP सर्वर Claude या ChatGPT जैसे असिस्टेंट के लिए ठीक है, जो आपके अपने easyCoexistence अकाउंट पर काम करता है, OAuth से लॉग इन के बाद उन टूल्स के ज़रिए जिन्हें वह अनुरोध पर बुलाता है। आपकी एपीआई की से कनेक्ट किए गए नंबर और चैनल भी उसी अकाउंट पर रहते हैं, इसलिए MCP सेशन आपकी अपनी टीम के काम के लिए उन तक पहुँच सकता है।

Partner APIMCP server
Built forYour product, serving your customersAn assistant working on your own account
Signs in withAn ec_live_ key, one per accountOAuth, from Claude, ChatGPT or another client
Incoming messagesWebhooks to your backendRead when the assistant calls a tool
The modelAny model you runThe assistant's own
RepliesYour code calls each network's APITools such as send_message and reply_to_comment

एजेंसियाँ कई क्लाइंट के लिए एजेंट कैसे चलाती हैं?

एक ही अकाउंट पर, हर क्लाइंट को टैग करके। हर कनेक्ट सेशन पर क्लाइंट का ID external_ref के रूप में भेजें, partner_name से अपनी एजेंसी का नाम होस्टेड पेज पर दिखाएं, और एक क्लाइंट के कनेक्शन GET /connections?external_ref= और GET /channels?external_ref= से सूचीबद्ध करें। हर कनेक्शन का बिल एजेंसी को US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह के हिसाब से जाता है, जो कनेक्शन जुड़ने के साथ घटता है। WhatsApp बातचीत का शुल्क Meta क्लाइंट के अपने WhatsApp Business Account को लगाता है। Coexistence के साथ, क्लाइंट का स्टाफ़ एजेंट के साथ-साथ WhatsApp Business ऐप में जवाब देता रहता है।

एजेंट को कौन से नियम मानने होते हैं?

नेटवर्क के अपने नियम, जिन्हें आपके कोड को मॉडल का जवाब जाने से पहले जाँचना चाहिए। प्लेटफ़ॉर्म इन्हें अपने ग्राहकों की ओर से लागू रखते हैं, क्योंकि Meta की कार्रवाई ग्राहक के अकाउंट पर होती है:

  • WhatsApp: फ़्री-फ़ॉर्म जवाब केवल ग्राहक के आख़िरी मैसेज के 24 घंटे के भीतर; उसके बाद मंज़ूरशुदा टेम्पलेट, जो एपीआई से भेजा जाए, क्योंकि Coexistence में WhatsApp Business ऐप टेम्पलेट नहीं भेज सकता।
  • WhatsApp: Meta की शर्तें एआई को मुख्य कार्य के रूप में देने पर रोक लगाती हैं, जिसे Partner API संदर्भ में सामान्य-प्रयोजन एआई बॉट न होने के रूप में दर्ज करता है, और WhatsApp डेटा पर फ़ाइन-ट्यूनिंग केवल कारोबार के अनन्य उपयोग के लिए अनुमत है।
  • Instagram और Facebook: व्यक्ति के आख़िरी मैसेज के 24 घंटे के भीतर DM, और हर कमेंट पर एक निजी जवाब उसके 7 दिन के भीतर।
  • TikTok: कमेंट के जवाब सार्वजनिक होते हैं, क्योंकि TikTok कनेक्शन में DM नहीं होते।
  • वॉल्यूम: हर Coexistence नंबर पर प्रति सेकंड 20 मैसेज, और मार्केटिंग टेम्पलेट के लिए ग्राहक के WhatsApp Business Account पर भुगतान विधि ज़रूरी है।

एजेंट को कैसे पता चलता है कि चैनल काम करना बंद कर चुका है?

स्टेटस इवेंट से। connection.disconnected या channel.disconnected का मतलब है कि ग्राहक के दोबारा कनेक्ट करने तक जवाब विफल होंगे, इसलिए उस ग्राहक का एजेंट रोकें, उसे बताएं और नया कनेक्ट लिंक भेजें; connection.token_missing का मतलब है कि नंबर मैसेज प्राप्त कर सकता है पर अभी भेज नहीं सकता। जब connection.connected या channel.connected फिर आए, तो नए क्रेडेंशियल लें और फिर से शुरू करें। हर इवेंट X-EC-Signature से हस्ताक्षरित होता है और लगभग 33 घंटे तक दोबारा भेजा जाता है।

आम गड़बड़ियाँ

  • 24 घंटे से पुराने WhatsApp मैसेज का जवाब मॉडल को फ़्री टेक्स्ट में देने देना। विंडो बंद हो चुकी है, इसलिए ग्राहक का आख़िरी इनबाउंड समय जाँचें और मंज़ूरशुदा टेम्पलेट पर बदलें।
  • ग्राहकों की WhatsApp बातचीत पर साझा मॉडल को प्रशिक्षित करना। Meta की शर्तें WhatsApp Business Platform डेटा पर फ़ाइन-ट्यूनिंग केवल कारोबार के अनन्य उपयोग के लिए अनुमत करती हैं, दूसरे मॉडल सुधारने के लिए कभी नहीं।
  • smb_message_echoes को ग्राहक के मैसेज मानना। ये वे मैसेज हैं जो कारोबार के स्टाफ़ ने ऐप से भेजे, इसलिए इन्हें मॉडल को संदर्भ के रूप में दें, जवाब देने वाले मैसेज के रूप में नहीं।
  • अकाउंट के अपने जवाबों का जवाब देना। उसके भेजे Instagram DM इको के रूप में लौटते हैं और TikTok जवाब कमेंट इवेंट के रूप में, इसलिए अकाउंट का खुद लिखा हर संदेश छोड़ें, वरना एजेंट खुद को जवाब देता रहेगा।
EasyCoexistence के साथ ऐसा करना

US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह, कनेक्शन जोड़ने के साथ घटती दर, पहले 3 दिन मुफ़्त।

अक्सर पूछे जाने वाले सवाल

क्या मैं अपना एआई मॉडल इस्तेमाल कर सकता हूँ?

हाँ। आपका बैकएंड मैसेज प्राप्त करता है, आपकी चुनी कोई भी मॉडल कॉल करता है और ग्राहक के टोकन के साथ नेटवर्क के एपीआई से जवाब देता है। WhatsApp नंबर के मैसेज Meta से सीधे आपके वेबहुक पर जाते हैं, कभी easyCoexistence से होकर नहीं।

Meta की एआई नीति WhatsApp एजेंट के लिए क्या मायने रखती है?

Meta की शर्तें एआई प्रदाताओं को WhatsApp Business Platform से एआई तकनीक को मुख्य कार्यक्षमता के रूप में देने से रोकती हैं, सहायक या गौण के रूप में नहीं, जैसा Meta तय करे। इसका पालन अपने ग्राहकों की ओर से करें, साथ में 24 घंटे की विंडो और मंज़ूरशुदा टेम्पलेट के साथ।

क्या एजेंट TikTok, YouTube या LinkedIn पर DM भेज सकता है?

नहीं। इन नेटवर्क पर एजेंट कमेंट में काम करता है: TikTok के जवाब सार्वजनिक होते हैं, और YouTube व LinkedIn के कमेंट उनके एपीआई से पढ़े और उनका जवाब दिए जाते हैं।

एक एआई एजेंट प्रोडक्ट के लिए easyCoexistence की लागत कितनी है?

प्रति कनेक्शन, हर नेटवर्क पर एक जैसी: US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह, कनेक्शन जोड़ने के साथ घटती दर, पहले 3 दिन मुफ़्त। Meta WhatsApp की बातचीत का शुल्क हर ग्राहक के अपने WhatsApp Business Account पर लगाता है।

पढ़ना जारी रखें

WhatsApp, Instagram और TikTok के लिए ग्राहकों के एपीआई टोकन कैसे लेंWhatsApp नंबर और हर सोशल अकाउंट की क्रेडेंशियल कॉल क्या लौटाती है, फ़ील्ड दर फ़ील्ड, और टोकन रोटेशन व token_ready कैसे काम करते हैं।वेबहुक के ज़रिए ग्राहकों के WhatsApp मैसेज और सोशल कमेंट कैसे प्राप्त करेंहर कनेक्शन का अपना वेबहुक: WhatsApp मैसेज सीधे Meta से, यूआरएल में सीक्रेट से प्रमाणित, और सोशल कमेंट व DMs X-EC-Signature से साइन किए हुए।ग्राहक का WhatsApp या सोशल कनेक्शन कब टूटता है, यह कैसे जानेंconnection.* और channel.* स्टेटस इवेंट: पेलोड, PRIMARY_INACTIVITY जैसे कारण, X-EC-Signature और लगभग 33 घंटे तक रीट्राई।AI एजेंट के लिए सोशल मीडिया API: पोस्ट प्रकाशित करें, शेड्यूल करें, जवाब दें और मापेंAI एजेंट के लिए एक API और MCP सर्वर: हर नेटवर्क की आधिकारिक API से पोस्ट प्रकाशित, शेड्यूल, जवाब और एनालिटिक्स।एजेंसियों और कंसल्टेंसी के लिए WhatsApp Coexistenceक्लाइंट के WhatsApp नंबर बिना माइग्रेट किए जोड़ें और स्टाफ को दोबारा ट्रेन न करें। एक खाते में कई नंबर, हर नंबर क्लाइंट के Business Portfolio में।24 घंटे की ग्राहक सेवा विंडोजानें ग्राहक सेवा विंडो कब खुलती और बंद होती है, इसमें क्या भेज सकते हैं और अंदर के जवाब मुफ़्त क्यों हैं।

दो मिनट में अपना पहला चैनल कनेक्ट करें।

किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।

  • 3 दिन मुफ़्त
  • कभी भी रद्द करें
  • सिर्फ़ आधिकारिक एपीआई
  • 24/7 निगरानी

इस तारीख को सत्यापित