IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Jinsi ya kujenga bidhaa ya wakala wa AI kwenye WhatsApp, Instagram na TikTok za wateja wako

Bidhaa ya wakala wa AI kwenye chaneli za wateja inategemea vipande vitatu: kiungo kilichoandaliwa cha kuunganisha kwa kila nambari ya WhatsApp au akaunti ya mtandao wa kijamii ya mteja; webhook zinazopeleka ujumbe na maoni yao kwenye backend yako, ambapo modeli yako huandika majibu yanayotumwa kupitia API rasmi ya kila mtandao kwa kutumia token ya mteja; na matukio ya hali kwa muunganisho unaokatika. Wakala huzingatia sheria za kila mtandao, kama dirisha la huduma kwa wateja la saa 24 la WhatsApp.

easyCoexistence huwapa wakala wa AI wa bidhaa yako sauti kwenye nambari za WhatsApp za wateja wako na akaunti zao za Instagram, Facebook, TikTok, YouTube na LinkedIn, na chaneli nyingine zinazoongezwa: viungo vilivyoandaliwa vya kuunganisha, vitambulisho vipya, webhook na matukio ya hali yaliyosainiwa kwenye API rasmi ya kila mtandao, kila muunganisho ukifuatiliwa 24/7.

24 hours

Dirisha la huduma kwa wateja la WhatsApp huanza baada ya ujumbe au simu ya mtumiaji; kila ujumbe mpya huliweka upya.

Templates only

Kile ambacho biashara ya WhatsApp inaweza kutuma baada ya dirisha la huduma kwa wateja kufungwa: violezo vya ujumbe vilivyoidhinishwa mapema.

Section 4.7

Sheria za Meta zinakataza watoa huduma wa AI kutumia WhatsApp kutoa AI kama kazi kuu, badala ya kazi ya ziada tu.

7 days

Dirisha la jibu moja la faragha la akaunti ya Instagram kwa maoni, linalohesabiwa tangu maoni yalipoandikwa.

20 mps

Kasi isiyobadilika ya kutuma kwa nambari inayotumiwa na programu ya WhatsApp Business na Cloud API.

Wakala wa AI unahitaji nini kutoka kwenye chaneli ya kila mteja?

Mambo manne: njia ya mteja kuunganisha, ujumbe wake kufika kwenye backend yako, token ya kujibu, na arifa pale muunganisho unaposimama kufanya kazi. Partner API inashughulikia kila kimojawapo, huku modeli, maelekezo na mantiki ya mazungumzo yakibaki yako. easyCoexistence inaunganisha akaunti, inahuisha ufikiaji wake na kuifuatilia, na majibu yako yanatoka kwenye backend yako moja kwa moja hadi API ya mtandao husika.

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

Kila mteja anaunganishaje?

Backend yako huunda kipindi cha kuunganisha kwa POST /connect-sessions, ukitaja chaneli, redirect_url na external_ref ya mteja wako, na kwa nambari webhook_url na webhook_verify_token yake. Mteja anafungua kiungo kilichoandaliwa, anaingia kwa Meta, TikTok, Google au LinkedIn, kisha anarejea kwenye programu yako akiwa na connection_id au channel_id. Hahitaji akaunti ya easyCoexistence, barua pepe wala kadi, na kila muunganisho uliofanywa kwa ufunguo wako unamilikiwa na akaunti yako.

Ujumbe na maoni yanafikaje kwenye modeli yako?

Kupitia webhook, kwenye mitandao inayozituma. Meta inapeleka ujumbe wa nambari moja kwa moja kwenye webhook_url yake, na kile wafanyakazi wa biashara wanachotuma kutoka programu ya WhatsApp Business hufika hapo kama smb_message_echoes. Maoni, kutajwa na DM za Instagram na Facebook, pamoja na maoni ya TikTok, yanasambazwa kwa lengwa la kila chaneli, yakiwa yamesainiwa kwa siri yake. YouTube na LinkedIn hazituma matukio ya maoni, kwa hiyo wakala husoma maoni mapya kupitia API zao kwa ratiba. Jibu kila uwasilishaji kwa 2xx mara moja, kisha acha kichakataji ndicho kiite modeli.

Wakala hujibu vipi?

Kupitia API yenyewe ya mtandao husika, kwa kutumia vitambulisho ambavyo backend yako ilivipata. Jibu la WhatsApp ni POST kwenda send_endpoint ya nambari pamoja na token ya mteja; DM ya Instagram au Facebook huenda kwenye messages edge ya akaunti; na jibu la TikTok huwekwa chini ya maoni kupitia business/comment/reply/create/. Mchoro hapa chini unajibu ujumbe wa WhatsApp: unakagua siri iliyo kwenye njia ya URL, unaweka kila ujumbe unaoingia kwenye foleni na kujibu kwa chochote modeli yako inachorudisha.

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 server au Partner API: wakala unatumia lipi?

Partner API, wakala unapokuwa bidhaa yako na wateja wako wanaleta chaneli: backend yako inashika ufunguo, inapokea matukio na kuendesha modeli yoyote unayochagua. MCP server kwenye https://easycoexistence.com/api/mcp inafaa msaidizi kama Claude au ChatGPT anayefanya kazi kwenye akaunti yako ya easyCoexistence, kupitia zana anazoziita kwa ombi baada ya kuingia kwa OAuth. Nambari na chaneli zilizounganishwa kwa ufunguo wako zipo kwenye akaunti hiyo pia, kwa hiyo kipindi cha MCP kinaweza kuzifikia kwa kazi ya timu yako mwenyewe.

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

Mashirika yanaendeshaje wakala kwa wateja wengi?

Kwenye akaunti moja, kila mteja akiwekewa alama. Tuma ID ya mteja kama external_ref kwenye kila kipindi cha kuunganisha, onyesha jina la shirika lako kwenye ukurasa ulioandaliwa kwa partner_name, na orodhesha muunganisho wa mteja mmoja kwa GET /connections?external_ref= na GET /channels?external_ref=. Kila muunganisho unatozwa shirika kwa kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, unashuka kadri muunganisho unavyoongezwa, huku Meta ikitoza gharama za mazungumzo ya WhatsApp kwenye Akaunti ya WhatsApp Business ya mteja mwenyewe. Kwa Coexistence, wafanyakazi wa mteja wanaendelea kujibu kwenye programu ya WhatsApp Business pembeni ya wakala.

Ni sheria zipi wakala lazima azizingatie?

Sheria za mitandao yenyewe, ambazo msimbo wako unapaswa kuzikagua kabla ya jibu la modeli kutumwa. Majukwaa yanazishikilia kwa niaba ya wateja wao, kwa kuwa utekelezaji wa Meta unafika kwenye akaunti ya mteja:

  • WhatsApp: majibu ya maandishi huru yanaruhusiwa ndani ya saa 24 tu tangu ujumbe wa mwisho wa mteja; baada ya hapo, kiolezo kilichoidhinishwa, kinachotumwa kupitia API kwa sababu programu ya WhatsApp Business haiwezi kutuma kiolezo katika Coexistence.
  • WhatsApp: sheria za Meta zinakataza kutoa AI kama kazi kuu, ambayo rejeleo la Partner API linaeleza kama hakuna chatbot za AI za matumizi ya jumla, na zinaruhusu kuifunza upya modeli kwa data ya WhatsApp kwa matumizi ya kipekee ya biashara pekee.
  • Instagram na Facebook: DM ndani ya saa 24 tangu ujumbe wa mwisho wa mtu huyo, na jibu moja la faragha kwa kila maoni ndani ya siku 7 tangu maoni hayo.
  • TikTok: majibu ya maoni ni ya umma, kwa kuwa muunganisho wa TikTok hauna DM.
  • Kiwango cha kutuma: ujumbe 20 kwa sekunde kwa kila nambari ya Coexistence, na violezo vya masoko vinahitaji njia ya malipo kwenye Akaunti ya WhatsApp Business ya mteja.

Wakala anajuaje kwamba chaneli imeacha kufanya kazi?

Kutoka kwenye matukio ya hali. connection.disconnected au channel.disconnected inamaanisha majibu yanashindwa hadi mteja aunganishe tena, kwa hiyo sitisha wakala wa mteja huyo, mjulishe, kisha tuma kiungo kipya cha kuunganisha; connection.token_missing inamaanisha nambari inaweza kupokea lakini bado haiwezi kutuma. Connection.connected au channel.connected inapofika tena, chukua vitambulisho vipya na uendelee. Kila tukio linasainiwa kwa X-EC-Signature na kujaribiwa tena kwa takriban saa 33.

Makosa ya kawaida

  • Kuruhusu modeli kujibu ujumbe wa WhatsApp wa zaidi ya saa 24 kwa maandishi huru. Dirisha limefungwa, kwa hiyo angalia muda wa ujumbe wa mwisho wa mteja unaoingia na ubadilishe kwa kiolezo kilichoidhinishwa.
  • Kufunza modeli ya pamoja kwa mazungumzo ya WhatsApp ya wateja. Sheria za Meta zinaruhusu kuifunza upya modeli kwa data ya WhatsApp Business Platform kwa matumizi ya kipekee ya biashara pekee, si kuboresha modeli nyingine.
  • Kuchukulia smb_message_echoes kama ujumbe wa wateja. Hizi ni zile zilizotumwa na wafanyakazi wa biashara kutoka programu, kwa hiyo wape modeli kama muktadha, si kama ujumbe wa kujibu.
  • Kujibu majibu ya akaunti yenyewe. DM za Instagram inazotuma hurudi kama echoes na majibu ya TikTok kama matukio ya maoni, kwa hiyo ruka chochote ambacho akaunti yenyewe iliandika, la sivyo wakala atajijibu yenyewe.
Kufanya hili ukitumia EasyCoexistence

Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, unashuka kadri unavyoongeza muunganisho, na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Je, naweza kutumia modeli yangu ya AI?

Ndiyo. Backend yako hupokea ujumbe, huita modeli yoyote unayochagua na kujibu kupitia API ya mtandao kwa token ya mteja. Ujumbe wa nambari ya WhatsApp hutoka Meta moja kwa moja kwenye webhook yako, bila kupitia easyCoexistence.

Sheria ya AI ya Meta inamaanisha nini kwa wakala wa WhatsApp?

Sheria za Meta zinakataza watoa huduma wa AI kutumia Jukwaa la WhatsApp Business kutoa teknolojia ya AI kama kazi kuu, badala ya kazi ya ziada au ya pembeni, kama Meta inavyoamua. Zingatia hilo kwa niaba ya wateja wako, pamoja na dirisha la saa 24 na violezo vilivyoidhinishwa.

Je, wakala anaweza kutuma DM kwenye TikTok, YouTube au LinkedIn?

Hapana. Kwenye mitandao hiyo wakala hufanya kazi kwenye maoni: majibu ya TikTok ni ya umma, na maoni ya YouTube na LinkedIn husomwa na kujibiwa kupitia API zao.

easyCoexistence inagharimu kiasi gani kwa bidhaa ya wakala wa AI?

Kwa kila muunganisho, sawa kwenye kila mtandao: kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inayoshuka kadri unavyoongeza muunganisho, na siku 3 za kwanza bila malipo. Meta inatoza gharama za mazungumzo ya WhatsApp kwenye Akaunti ya WhatsApp Business ya kila mteja mwenyewe.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye