איך לבנות מוצר סוכן AI בערוצי ה-WhatsApp, Instagram ו-TikTok של הלקוחות
מוצר סוכן AI בערוצי הלקוחות נשען על שלושה רכיבים: קישור חיבור מתארח לכל מספר WhatsApp או חשבון רשת חברתית של לקוח; וובהוק (Webhook) שמעביר את ההודעות והתגובות לשרת שלכם, שבו המודל שלכם כותב תשובות ושולח אותן דרך ה-API הרשמי של כל רשת עם האסימון של הלקוח; ואירועי סטטוס לחיבורים שנפסקים. הסוכן שומר על כללי כל רשת, כמו חלון של 24 שעות של WhatsApp.
easyCoexistence מעניק לסוכני ה-AI של המוצר שלכם קול במספרי ה-WhatsApp של הלקוחות ובחשבונות Instagram, Facebook, TikTok, YouTube ו-LinkedIn שלהם, וגם בערוצים נוספים: קישורי חיבור מתארחים, פרטי הרשאה טריים, וובהוקים ואירועי סטטוס חתומים דרך ה-API הרשמי של כל רשת, עם ניטור של כל חיבור 24/7.
חלון שירות הלקוחות של WhatsApp נפתח בעקבות הודעה או שיחה של משתמש; כל הודעה חדשה מאפסת אותו.
מה שעסק WhatsApp יכול לשלוח אחרי שחלון שירות הלקוחות נסגר: הודעות תבנית שאושרו מראש.
תנאי Meta אוסרים על ספקי AI להשתמש ב-WhatsApp כדי להציע AI כתכונה המרכזית, ולא כתוספת נלווית.
החלון לתשובה פרטית אחת לתגובה בחשבון Instagram, נספר מהרגע שבו נכתבה התגובה.
קצב קבוע של מספר המשמש גם באפליקציית WhatsApp Business וגם ב-Cloud API.
אילו דברים צריך מוצר סוכן AI מכל ערוץ של לקוח?
ארבעה דברים: דרך שבה הלקוח מחבר אותו, הודעות שמגיעות לשרת שלכם, אסימון לשליחת תשובות, ודרך לדעת מתי החיבור מפסיק לפעול. ה-Partner API מכסה כל אחד מהם, בעוד שהמודל, הפרומפטים ולוגיקת השיחה נשארים שלכם. easyCoexistence מחבר את החשבון, שומר על חידוש הגישה שלו ומנטר אותו, והתשובות שלכם יוצאות מהשרת שלכם ישירות ל-API של הרשת.
איך כל לקוח מתחבר?
השרת שלכם יוצר סשן חיבור עם POST /connect-sessions, ובו מציינים את הערוץ, את redirect_url ואת external_ref של הלקוח. למספר מוסיפים גם את השדה webhook_url ואת webhook_verify_token. הלקוח פותח את הקישור המתארח, נכנס באמצעות Meta, TikTok, Google או LinkedIn, וחוזר לאפליקציה שלכם עם connection_id או channel_id. אין צורך בחשבון easyCoexistence, באימייל או בכרטיס אשראי, וכל חיבור שנוצר דרך המפתח שלכם שייך לחשבון שלכם.
איך הודעות ותגובות מגיעות למודל?
דרך וובהוק (Webhook), ברשתות שמשדרות אותם. Meta שולחת את ההודעות של מספר ישירות אל השדה webhook_url שלו, וכל מה שצוות העסק שולח מאפליקציית WhatsApp Business מגיע לשם בתור smb_message_echoes. תגובות, אזכורים והודעות ישירות של Instagram ו-Facebook, וגם תגובות TikTok, מועברים ליעד של כל ערוץ וחתומים בסוד שלו. YouTube ו-LinkedIn אינם שולחים אירועי תגובות, ולכן הסוכן קורא תגובות חדשות דרך ה-API שלהן לפי לוח זמנים. יש להשיב לכל משלוח מיד עם 2xx, ולתת לתהליך ברקע לקרוא למודל.
איך הסוכן משיב?
דרך ה-API של הרשת עצמה, עם פרטי ההרשאה שהשרת שלכם שלף. תשובת WhatsApp היא POST אל send_endpoint של המספר עם האסימון של הלקוח; הודעת DM ב-Instagram או ב-Facebook הולכת אל messages edge של החשבון; ותשובה ב-TikTok נשלחת מתחת לתגובה דרך business/comment/reply/create/. הקטע שלמטה משיב להודעות WhatsApp: הוא בודק את הסוד בנתיב כתובת ה-URL, מכניס לתור כל הודעה נכנסת, ומשיב במה שהמודל שלכם מחזיר.
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, כשהסוכן הוא המוצר שלכם והלקוחות מביאים את הערוצים: השרת שלכם מחזיק במפתח, מקבל אירועים ומריץ כל מודל שתבחרו. שרת MCP בכתובת https://easycoexistence.com/api/mcp מתאים לעוזר כמו Claude או ChatGPT הפועל על חשבון easyCoexistence שלכם, דרך כלים שהוא קורא להם לפי בקשה, לאחר כניסה עם OAuth. מספרים וערוצים שחוברו עם המפתח שלכם נמצאים גם הם בחשבון הזה, כך שסשן MCP יכול להגיע אליהם לעבודה של הצוות שלכם.
| 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 |
איך סוכנויות מפעילות סוכנים עבור לקוחות רבים?
בחשבון אחד, כשכל לקוח מסומן. מעבירים את מזהה הלקוח כ-external_ref בכל סשן חיבור, מציגים את שם הסוכנות בדף המתארח עם partner_name, ומאפשרים לשלוף את החיבורים של לקוח אחד עם GET /connections?external_ref= וגם עם GET /channels?external_ref=. כל חיבור מחויב לסוכנות בסך US$ 9 עד US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמתווספים חיבורים, בעוד Meta מחייבת את חיובי השיחות של WhatsApp בחשבון WhatsApp Business של הלקוח עצמו. עם Coexistence, צוות הלקוח ממשיך לענות באפליקציית WhatsApp Business לצד הסוכן.
אילו כללים הסוכן חייב לשמור עליהם?
אלה של הרשתות עצמן, שהקוד שלכם צריך לבדוק לפני שתשובת המודל יוצאת. הפלטפורמות שומרות עליהם מטעם הלקוחות שלהן, כי האכיפה של Meta פוגעת בחשבון הלקוח:
- WhatsApp: תשובות בטקסט חופשי רק בתוך 24 שעות מההודעה האחרונה של הלקוח; אחר כך, תבנית מאושרת שנשלחת דרך ה-API, כי אפליקציית WhatsApp Business לא יכולה לשלוח תבניות ב-Coexistence.
- WhatsApp: תנאי Meta אוסרים להציע AI כתכונה המרכזית, וכפי שמסמך ה-Partner API מציין, לא מתירים בוטי AI לשימוש כללי; כוונון עדין על נתוני WhatsApp מותר רק לשימוש הבלעדי של העסק.
- Instagram ו-Facebook: הודעות DM עד 24 שעות מההודעה האחרונה של האדם, ותשובה פרטית אחת לכל תגובה, בתוך 7 ימים ממנה.
- TikTok: תשובות לתגובות הן ציבוריות, כי לחיבור TikTok אין הודעות DM.
- נפח: 20 הודעות בשנייה לכל מספר Coexistence, ותבניות שיווקיות דורשות אמצעי תשלום בחשבון WhatsApp Business של הלקוח.
איך הסוכן יודע שערוץ הפסיק לפעול?
מאירועי סטטוס. connection.disconnected או channel.disconnected אומרים שהתשובות נכשלות עד שהלקוח מתחבר מחדש, ולכן משהים את הסוכן של אותו לקוח, מודיעים לו ושולחים קישור חיבור חדש. connection.token_missing אומר שהמספר יכול לקבל הודעות, אבל עדיין לא יכול לשלוח. כשמגיע שוב connection.connected או channel.connected, שולפים פרטי הרשאה טריים וממשיכים. כל אירוע חתום עם X-EC-Signature ונשלח שוב במשך כ-33 שעות.
טעויות נפוצות
- לתת למודל לענות בטקסט חופשי להודעת WhatsApp בת יותר מ-24 שעות. החלון נסגר, ולכן בדקו מתי הלקוח שלח הודעה נכנסת לאחרונה, ועברו לתבנית מאושרת.
- אימון מודל משותף על שיחות ה-WhatsApp של לקוחות. תנאי Meta מתירים כוונון עדין על נתוני WhatsApp Business Platform רק לשימוש הבלעדי של העסק, ולעולם לא לשיפור מודלים אחרים.
- לטפל בהודעות מסוג smb_message_echoes כהודעות לקוח. אלה מה שצוות העסק שלח מהאפליקציה, ולכן מעבירים אותן למודל כהקשר ולא כהודעות שיש להשיב עליהן.
- להשיב להודעות שהחשבון עצמו כתב. הודעות DM שהחשבון שולח ב-Instagram חוזרות כ-echoes, ותשובות TikTok חוזרות כאירועי תגובה, ולכן יש לדלג על כל מה שהחשבון כתב בעצמו, אחרת הסוכן ישיב לעצמו.
US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים בחינם.
שאלות נפוצות
האם אפשר להשתמש במודל AI משלי?
כן. השרת שלכם מקבל את ההודעות, קורא לכל מודל שתבחרו ומשיב דרך ה-API של הרשת עם האסימון של הלקוח. הודעות של מספר WhatsApp עוברות מ-Meta ישירות לוובהוק שלכם, ולעולם אינן עוברות דרך easyCoexistence.
מה משמעות מדיניות ה-AI של Meta לסוכן WhatsApp?
תנאי Meta אוסרים על ספקי AI להשתמש ב-WhatsApp Business Platform כדי להציע טכנולוגיית AI כפונקציונליות העיקרית, ולא ככזו שנלווית או משנית, כפי ש-Meta קובעת. שמרו עליהם מטעם הלקוחות שלכם, לצד חלון 24 השעות ותבניות מאושרות.
האם הסוכן יכול לשלוח DM ב-TikTok, YouTube או LinkedIn?
לא. ברשתות האלה הסוכן עובד בתגובות: תשובות TikTok הן ציבוריות, ותגובות YouTube ו-LinkedIn נקראות ונענות דרך ה-API שלהן.
כמה עולה easyCoexistence למוצר סוכן AI?
לכל חיבור, באותו מחיר בכל רשת: US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים בחינם. Meta מחייבת את חיובי השיחות של WhatsApp בחשבון WhatsApp Business של כל לקוח.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-