התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

איך לבנות מוצר סוכן AI בערוצי ה-WhatsApp, Instagram ו-TikTok של הלקוחות

מוצר סוכן AI בערוצי הלקוחות נשען על שלושה רכיבים: קישור חיבור מתארח לכל מספר WhatsApp או חשבון רשת חברתית של לקוח; וובהוק (Webhook) שמעביר את ההודעות והתגובות לשרת שלכם, שבו המודל שלכם כותב תשובות ושולח אותן דרך ה-API הרשמי של כל רשת עם האסימון של הלקוח; ואירועי סטטוס לחיבורים שנפסקים. הסוכן שומר על כללי כל רשת, כמו חלון של 24 שעות של WhatsApp.

easyCoexistence מעניק לסוכני ה-AI של המוצר שלכם קול במספרי ה-WhatsApp של הלקוחות ובחשבונות Instagram, Facebook, TikTok, YouTube ו-LinkedIn שלהם, וגם בערוצים נוספים: קישורי חיבור מתארחים, פרטי הרשאה טריים, וובהוקים ואירועי סטטוס חתומים דרך ה-API הרשמי של כל רשת, עם ניטור של כל חיבור 24/7.

24 hours

חלון שירות הלקוחות של WhatsApp נפתח בעקבות הודעה או שיחה של משתמש; כל הודעה חדשה מאפסת אותו.

Templates only

מה שעסק WhatsApp יכול לשלוח אחרי שחלון שירות הלקוחות נסגר: הודעות תבנית שאושרו מראש.

Section 4.7

תנאי Meta אוסרים על ספקי AI להשתמש ב-WhatsApp כדי להציע AI כתכונה המרכזית, ולא כתוספת נלווית.

7 days

החלון לתשובה פרטית אחת לתגובה בחשבון Instagram, נספר מהרגע שבו נכתבה התגובה.

20 mps

קצב קבוע של מספר המשמש גם באפליקציית WhatsApp Business וגם ב-Cloud API.

אילו דברים צריך מוצר סוכן AI מכל ערוץ של לקוח?

ארבעה דברים: דרך שבה הלקוח מחבר אותו, הודעות שמגיעות לשרת שלכם, אסימון לשליחת תשובות, ודרך לדעת מתי החיבור מפסיק לפעול. ה-Partner API מכסה כל אחד מהם, בעוד שהמודל, הפרומפטים ולוגיקת השיחה נשארים שלכם. easyCoexistence מחבר את החשבון, שומר על חידוש הגישה שלו ומנטר אותו, והתשובות שלכם יוצאות מהשרת שלכם ישירות ל-API של הרשת.

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, באימייל או בכרטיס אשראי, וכל חיבור שנוצר דרך המפתח שלכם שייך לחשבון שלכם.

איך הודעות ותגובות מגיעות למודל?

דרך וובהוק (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, מכניס לתור כל הודעה נכנסת, ומשיב במה שהמודל שלכם מחזיר.

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, כשהסוכן הוא המוצר שלכם והלקוחות מביאים את הערוצים: השרת שלכם מחזיק במפתח, מקבל אירועים ומריץ כל מודל שתבחרו. שרת MCP בכתובת https://easycoexistence.com/api/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

איך סוכנויות מפעילות סוכנים עבור לקוחות רבים?

בחשבון אחד, כשכל לקוח מסומן. מעבירים את מזהה הלקוח כ-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 חוזרות כאירועי תגובה, ולכן יש לדלג על כל מה שהחשבון כתב בעצמו, אחרת הסוכן ישיב לעצמו.
עושים את זה עם EasyCoexistence

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 של כל לקוח.

המשיכו לקרוא

איך מקבלים את אסימוני ה-API של לקוחותיכם ב-WhatsApp, Instagram ו-TikTokמה קריאת פרטי הגישה מחזירה עבור מספר WhatsApp של לקוח ועבור כל חשבון רשת, שדה אחר שדה, וכיצד פועלים סיבוב האסימונים והשדה token_ready.איך מקבלים בוובהוק (Webhook) את הודעות WhatsApp ואת התגובות ברשתות החברתיות של הלקוחות שלכםוובהוק לכל חיבור: הודעות WhatsApp ישירות מ-Meta, מאומתות בסוד בכתובת, ותגובות ו-DM מהרשתות החברתיות חתומות בכותרת X-EC-Signature.איך לדעת מתי חיבור של לקוח ב-WhatsApp או ברשת חברתית מתנתקאירועי connection.* ו-channel.*: ה-payload, סיבות כמו PRIMARY_INACTIVITY, חתימת X-EC-Signature וניסיונות חוזרים במשך כ-33 שעות.ממשק API לרשתות חברתיות לסוכני AI: פרסום, תזמון, תגובות ומדידהממשק API ושרת MCP שמאפשרים לסוכני AI לפרסם, לתזמן, להגיב ולקרוא אנליטיקה ברשתות חברתיות, דרך ה-API הרשמי של כל רשת.Coexistence של WhatsApp לסוכנויות ולחברות ייעוץמחברים מספרי WhatsApp של לקוחות בלי להעביר אותם ובלי להכשיר מחדש את הצוות. חשבון אחד, מספרים רבים, כל אחד ב-Business Portfolio של הלקוח.חלון שירות הלקוחות בן 24 השעותמהו חלון שירות הלקוחות, מתי הוא נפתח ונסגר, מה מותר לשלוח בתוכו ומחוצה לו, ולמה תשובות בתוכו בחינם.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-