AI agent sa WhatsApp, Instagram at TikTok ng inyong mga customer: paano gumawa
Ang AI agent product sa channel ng mga customer ay nakasalalay sa tatlong bahagi: isang hosted connect link para sa WhatsApp number o social account ng bawat customer, webhook na naghahatid ng kanilang mensahe at comment sa inyong backend, kung saan isinusulat ng sarili ninyong model ang mga reply na ipinapadala sa pamamagitan ng opisyal na API ng bawat network gamit ang token ng customer, at status event para sa mga koneksyon na nawawala. Sinusunod ng agent ang patakaran ng bawat network, gaya ng 24-hour window ng WhatsApp.
Binibigyan ng easyCoexistence ng tinig ang mga AI agent ng inyong product sa mga WhatsApp number ng inyong customer at sa kanilang Instagram, Facebook, TikTok, YouTube at LinkedIn account, at marami pang channel: hosted connect link, bagong credentials, webhook, at naka-sign na status event sa opisyal na API ng bawat network, kung saan binabantayan ang bawat koneksyon 24/7.
Ang customer service window ng WhatsApp pagkatapos ng mensahe o tawag ng user; nire-reset ito ng bawat bagong mensahe.
Ang maipapadala ng WhatsApp business kapag nagsara na ang customer service window: mga pre-approved na template message.
Ipinagbabawal ng terms ng Meta sa mga AI provider ang paggamit ng WhatsApp para mag-alok ng AI bilang pangunahing functionality, at hindi bilang pantulong lamang.
Window para sa iisang private reply ng Instagram account sa isang comment, binibilang mula nang ginawa ang comment.
Nakapirmihang throughput ng numerong ginagamit sa WhatsApp Business app at sa Cloud API.
Ano ang kailangan ng AI agent product mula sa channel ng bawat customer?
Apat na bagay: paraan para ma-connect ito ng customer, pagdating ng kanilang mensahe sa inyong backend, token para makapag-reply, at abiso kapag huminto sa paggana ang koneksyon. Sakop ng Partner API ang bawat isa rito, habang nananatili sa inyo ang model, mga prompt, at lohika ng usapan. Ikinokonekta ng easyCoexistence ang account, pinapanatiling bago ang access nito, at binabantayan ito, at dumidiretso ang mga reply ng inyong backend sa API ng network.
Paano kumokonekta ang bawat customer?
Gumagawa ang inyong backend ng connect session gamit ang POST /connect-sessions, na tinutukoy ang channel, redirect_url, at external_ref para sa customer, at para sa number, ang webhook_url at webhook_verify_token. Binubuksan ng customer ang hosted link, nag-sign in gamit ang Meta, TikTok, Google o LinkedIn, at babalik sa inyong app na may connection_id o channel_id. Hindi nila kailangan ng easyCoexistence account, email, o card, at bawat koneksyon na ginawa gamit ang inyong key ay nasa inyong account.
Paano nakakarating sa inyong model ang mga mensahe at comment?
Sa pamamagitan ng webhook, sa mga network na nagpapadala nito. Direktang ipinapadala ng Meta ang mga mensahe ng isang number sa webhook_url nito, at ang mga mensaheng ipinapadala ng staff ng negosyo mula sa WhatsApp Business app ay dumarating doon bilang smb_message_echoes. Ang comment, mention, at DM sa Instagram at Facebook, at comment sa TikTok, ay ipinapasa sa destinasyon ng bawat channel, na naka-sign gamit ang sariling secret. Hindi nagpapadala ng comment event ang YouTube at LinkedIn, kaya binabasa ng agent ang mga bagong comment sa pamamagitan ng kanilang API sa takdang iskedyul. Sagutin po ninyo ng 2xx agad ang bawat delivery, at hayaang tawagin ng worker ang model.
Paano nagre-reply ang agent?
Sa pamamagitan ng sariling API ng network, gamit ang credentials na kinuha ng inyong backend. Ang WhatsApp reply ay POST sa send_endpoint ng number gamit ang token ng customer; ang Instagram o Facebook DM ay napupunta sa messages edge ng account; at ang TikTok reply ay inilalagay sa ilalim ng comment sa pamamagitan ng business/comment/reply/create/. Ang halimbawang nasa ibaba ay sumasagot sa mga mensahe sa WhatsApp: sinusuri nito ang secret sa URL path, ini-queue ang bawat papasok na mensahe, at nagre-reply gamit ang anumang ibinabalik ng inyong 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 o Partner API: alin ang ginagamit ng agent?
Ang Partner API, kapag ang agent ang inyong product at ang mga customer ninyo ang nagdadala ng channel: hawak ng inyong backend ang key, tumatanggap ng event, at nagpapatakbo ng anumang model na pipiliin ninyo. Ang MCP server sa https://easycoexistence.com/api/mcp ay angkop sa assistant tulad ng Claude o ChatGPT na kumikilos sa sarili ninyong easyCoexistence account, sa pamamagitan ng mga tool na tinatawag nito kapag hiniling, pagkatapos ng OAuth sign-in. Nasa account din na iyon ang mga number at channel na naka-connect gamit ang inyong key, kaya maaabot ng MCP session ang mga ito para sa trabaho ng sarili ninyong team.
| Partner API | MCP server | |
|---|---|---|
| Built for | Your product, serving your customers | An assistant working on your own account |
| Signs in with | An ec_live_ key, one per account | OAuth, from Claude, ChatGPT or another client |
| Incoming messages | Webhooks to your backend | Read when the assistant calls a tool |
| The model | Any model you run | The assistant's own |
| Replies | Your code calls each network's API | Tools such as send_message and reply_to_comment |
Paano pinapatakbo ng mga agency ang agent para sa maraming client?
Sa iisang account, na may tag ang bawat client. Ipasa ang ID ng client bilang external_ref sa bawat connect session, ipakita ang pangalan ng inyong agency sa hosted page gamit ang partner_name, at ilista ang koneksyon ng isang client gamit ang GET /connections?external_ref= at GET /channels?external_ref=. Sinisingil sa agency ang bawat koneksyon ng US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, na bumababa habang dumarami ang koneksyon, samantalang sinisingil ng Meta ang WhatsApp conversation charges sa sariling WhatsApp Business Account ng client. Sa Coexistence, patuloy na sumasagot ang staff ng client sa WhatsApp Business app kasabay ng agent.
Anong mga patakaran ang dapat sundin ng agent?
Ang sariling patakaran ng mga network, na dapat tingnan ng inyong code bago lumabas ang reply ng model. Pinapanatili ito ng mga platform sa ngalan ng kanilang mga customer, dahil ang enforcement ng Meta ay tumatama sa account ng customer:
- WhatsApp: free-form na reply lamang sa loob ng 24 oras mula sa huling mensahe ng customer; pagkatapos nito, isang approved na template na ipinapadala sa pamamagitan ng API, dahil hindi makapagpadala ng template ang WhatsApp Business app sa Coexistence.
- WhatsApp: ipinagbabawal ng terms ng Meta ang pag-aalok ng AI bilang pangunahing functionality, na ayon sa Partner API reference ay nangangahulugang walang general-purpose na AI bot, at pinapayagan ang fine-tuning sa datos ng WhatsApp para lamang sa eksklusibong gamit ng negosyo.
- Instagram at Facebook: DM sa loob ng 24 oras mula sa huling mensahe ng tao, at isang private reply sa bawat comment sa loob ng 7 araw mula rito.
- TikTok: pampubliko ang mga reply sa comment, dahil walang DM ang koneksyon sa TikTok.
- Volume: 20 mensahe kada segundo kada Coexistence number, at kailangan ng marketing template ng payment method sa WhatsApp Business Account ng customer.
Paano nalalaman ng agent na huminto sa paggana ang channel?
Mula sa status event. Ang connection.disconnected o channel.disconnected ay nangangahulugang mabibigo ang mga reply hanggang muling mag-connect ang customer, kaya i-pause ang agent ng customer na iyon, ipaalam sa kanila, at magpadala ng bagong connect link. Ang connection.token_missing naman ay nangangahulugang makakatanggap pa ang number ngunit hindi pa makapagpapadala. Kapag muling dumating ang connection.connected o channel.connected, kumuha ng bagong credentials at ipagpatuloy. Naka-sign ang bawat event gamit ang X-EC-Signature at inuulit ang pagpapadala nang humigit-kumulang 33 oras.
Mga karaniwang pagkakamali
- Hinahayaan ang model na sumagot ng free-form text sa WhatsApp message na mahigit 24 oras na ang edad. Sarado na ang window, kaya suriin ang oras ng huling inbound na mensahe ng customer at lumipat sa approved template.
- Pagsasanay ng shared model sa mga usapan ng customer sa WhatsApp. Pinapayagan lamang ng terms ng Meta ang fine-tuning sa datos ng WhatsApp Business Platform para sa eksklusibong gamit ng negosyo, hindi kailanman para pagandahin ang ibang model.
- Pagtrato sa smb_message_echoes bilang mensahe ng customer. Ito ang mga ipinadala ng staff ng negosyo mula sa app, kaya ibigay ang mga ito sa model bilang konteksto, hindi bilang mensaheng sasagutin.
- Pagsagot sa sarili nitong reply ng account. Bumabalik bilang echo ang mga Instagram DM na ipinapadala nito, at bilang comment event ang mga TikTok reply, kaya laktawan ang anumang isinulat ng account mismo, kung hindi ay magre-reply ang agent sa sarili nito.
Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang nadadagdagan ang inyong koneksyon, at libre ang unang 3 araw.
Mga madalas itanong
Maaari ko bang gamitin ang sarili kong AI model?
Oo. Tumatanggap ang inyong backend ng mga mensahe, tumatawag ng anumang model na pipiliin ninyo, at nagre-reply sa pamamagitan ng API ng network gamit ang token ng customer. Ang mga mensahe ng WhatsApp number ay dumarating mula sa Meta diretso sa inyong webhook, hindi dumaraan sa easyCoexistence.
Ano ang ibig sabihin ng AI policy ng Meta para sa WhatsApp agent?
Ipinagbabawal ng terms ng Meta sa mga AI provider ang paggamit ng WhatsApp Business Platform para mag-alok ng AI technology bilang pangunahing functionality, at hindi bilang pantulong o karagdagan lamang, ayon sa pagtukoy ng Meta. Sundin ito sa ngalan ng inyong mga customer, kasama ang 24-hour window at mga approved template.
Maaari bang magpadala ng DM ang agent sa TikTok, YouTube o LinkedIn?
Hindi. Sa mga network na iyon, sa comment gumagana ang agent: pampubliko ang mga reply sa TikTok, at binabasa at sinasagot ang mga comment sa YouTube at LinkedIn sa pamamagitan ng kanilang API.
Magkano ang presyo ng easyCoexistence para sa AI agent product?
Kada koneksyon, pareho sa bawat network: mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang nadadagdagan ang koneksyon, at libre ang unang 3 araw. Sinisingil ng Meta ang WhatsApp conversation charges sa sariling WhatsApp Business Account ng bawat customer.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong