Как построить продукт с ИИ-агентом в WhatsApp, Instagram и TikTok ваших клиентов
Продукт с ИИ-агентом в каналах клиентов держится на трёх элементах: ссылке подключения для номера WhatsApp или аккаунта в соцсети каждого клиента; вебхуках, которые передают сообщения и комментарии на ваш бэкенд, где ваша модель пишет ответы и отправляет их через официальный API каждой сети с токеном клиента; и событиях статуса для подключений, которые обрываются. Агент соблюдает правила каждой сети, например 24-часовое окно WhatsApp.
easyCoexistence даёт ИИ-агентам вашего продукта голос в номерах WhatsApp ваших клиентов и в их аккаунтах Instagram, Facebook, TikTok, YouTube и LinkedIn, а также в других каналах: ссылки подключения, свежие учётные данные, вебхуки и подписанные события статуса через официальный API каждой сети, при этом каждое подключение находится под мониторингом 24/7.
Окно обслуживания клиентов WhatsApp открывается после сообщения или звонка пользователя; каждое новое сообщение его перезапускает.
Что бизнес в WhatsApp может отправить после закрытия окна обслуживания клиентов: заранее одобренные шаблонные сообщения.
Условия Meta запрещают поставщикам ИИ использовать WhatsApp для предложения ИИ как основной, а не сопутствующей функции.
Окно для единственного приватного ответа на комментарий в аккаунте Instagram, отсчитываемое от момента написания комментария.
Фиксированная пропускная способность номера, который используется и в приложении WhatsApp Business, и в Cloud API.
Что продукту с ИИ-агентом нужно от канала каждого клиента?
Четыре вещи: способ подключить канал, доставка сообщений клиента на ваш бэкенд, токен для ответа и уведомление, когда подключение перестаёт работать. 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, ни почта, ни карта, а каждое подключение, сделанное через ваш ключ, принадлежит вашему аккаунту.
Как сообщения и комментарии попадают к вашей модели?
Через вебхук, в тех сетях, которые их отправляют. Meta передаёт сообщения номера прямо на его webhook_url, а то, что сотрудники бизнеса отправляют из приложения WhatsApp Business, приходит туда как smb_message_echoes. Комментарии, упоминания и личные сообщения Instagram и Facebook, а также комментарии TikTok пересылаются на назначение каждого канала и подписанные его секретом. YouTube и LinkedIn событий о комментариях не присылают, поэтому агент читает новые комментарии через их API по расписанию. Отвечайте на каждую доставку кодом 2xx сразу, а модель вызывайте из воркера.
Как агент отвечает?
Через собственный API сети, с учётными данными, которые ваш бэкенд получил заранее. Ответ в WhatsApp отправляется POST-запросом к send_endpoint номера с токеном клиента; личное сообщение в 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 |
Как агентства ведут агентов для многих клиентов?
На одном аккаунте, где каждый клиент помечен. Передавайте ID клиента как 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 запрещают предлагать ИИ как основную функцию, что в справочнике Partner API сформулировано как запрет на универсальных ИИ-ботов, и разрешают дообучение на данных WhatsApp только для исключительного использования бизнесом.
- Instagram и Facebook: личные сообщения в течение 24 часов после последнего сообщения человека и один приватный ответ на комментарий в течение 7 дней после него.
- TikTok: ответы на комментарии публичные, так как подключение TikTok не содержит личных сообщений.
- Объём: 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 сообщениями клиентов. Это то, что сотрудники бизнеса отправили из приложения, поэтому передавайте их модели как контекст, а не как сообщения, на которые нужно ответить.
- Отвечать на собственные ответы аккаунта. Личные сообщения Instagram, которые он отправляет, возвращаются как echoes, а ответы TikTok как события комментариев, поэтому пропускайте всё, что написал сам аккаунт, иначе агент начнёт отвечать сам себе.
От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Можно ли использовать собственную модель ИИ?
Да. Ваш бэкенд получает сообщения, вызывает любую модель, которую вы выберете, и отвечает через API сети с токеном клиента. Сообщения номера WhatsApp идут от Meta прямо на ваш вебхук, никогда не проходя через easyCoexistence.
Что означает политика Meta в отношении ИИ для агента в WhatsApp?
Условия Meta запрещают поставщикам ИИ использовать платформу WhatsApp Business для предложения ИИ-технологий как основной, а не побочной или вспомогательной функции, так как это определяет Meta. Соблюдайте её от имени своих клиентов, вместе с 24-часовым окном и одобренными шаблонами.
Может ли агент отправлять личные сообщения в TikTok, YouTube или LinkedIn?
Нет. В этих сетях агент работает в комментариях: ответы TikTok публичные, а комментарии YouTube и LinkedIn читаются и на них отвечают через их API.
Сколько стоит easyCoexistence для продукта с ИИ-агентом?
За подключение, одинаково для всех сетей: от US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня бесплатно. Meta выставляет плату за диалоги WhatsApp аккаунту WhatsApp Business каждого клиента.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на