ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Архитектура SaaS с ИИ-агентом: как охватить клиентов ваших клиентов в WhatsApp, Instagram и TikTok

SaaS с ИИ-агентом, который отвечает клиентам ваших клиентов, работает в пять уровней: подключения, где каждый клиент подключает WhatsApp, Instagram, TikTok и другие каналы через Partner API easyCoexistence; приём событий, который проверяет вебхуки и ставит их в очередь; хранилище диалогов, которое принадлежит вам; воркер агента, который запускает вашу модель; и исходящие отправки, которые отвечают, публикуют и отслеживают события статуса через официальный API каждой сети.

smb_message_echoes

Вебхук, который описывает сообщение, отправленное бизнесом из приложения WhatsApp Business на номере Coexistence.

7 days

Как долго Meta повторяет вебхук WhatsApp, который ваш эндпоинт не принял, что может доставить одно и то же сообщение дважды.

1 attempt

Доставки каждого переданного события Instagram, Facebook или TikTok без повторных попыток и без сохранённой копии.

24 hours

Окно обслуживания клиентов WhatsApp после сообщения человека: за его пределами бизнес отправляет только одобренные шаблоны.

20 mps

Фиксированная пропускная способность номера, который используется и в приложении WhatsApp Business, и в Cloud API.

Из каких уровней состоит SaaS с ИИ-агентом?

Пять, у каждого своя задача: медленная модель никогда не теряет сообщение, а отключившийся аккаунт не выводит продукт из строя. easyCoexistence работает на первом и последнем уровнях: подключает аккаунты и поддерживает их в рабочем состоянии, а логика диалогов и модель остаются в вашем бэкенде.

1ConnectionsHosted links, channel_id and connection_id per customer
2IngestionVerify, queue, then answer 2xx
3ConversationsYour store, one thread per person
4AgentYour model, prompts and tools
5OutboundReplies, posts and status events

Как моделировать тенантов, каналы и диалоги?

В трёх таблицах. Тенант является вашим клиентом, и его id передаётся как external_ref в каждой сессии подключения, поэтому каждое подключение и событие статуса возвращается с его меткой. Строка канала хранит connection_id номера WhatsApp или channel_id аккаунта в соцсети, а также сеть и её статус. Диалог привязан к каналу и ID человека в этой сети: номер WhatsApp в поле from, Instagram-scoped ID в личных сообщениях (DM) или ветка комментария в TikTok.

Куда сначала попадают входящие события?

В надёжную очередь, до запуска любой модели. Эндпоинт приёма проверяет секрет в пути URL для доставок WhatsApp и заголовок X-EC-Signature для пересланных событий соцсетей, записывает событие в очередь и отвечает 2xx. Источники ведут себя по-разному: Meta повторяет вебхук WhatsApp до 7 дней, поэтому одно сообщение может прийти дважды, а пересланное событие Instagram, Facebook или TikTok отправляется один раз и нигде не сохраняется, так что событие, которое отбросил ваш эндпоинт, потеряно. Устраняйте дубликаты по собственному ID сообщения или комментария в сети.

Как сохранить порядок и своевременность ответов?

Один воркер на диалог и проверка перед каждой отправкой. Блокируйте диалог, пока агент работает, чтобы два сообщения от одного человека получали ответы по очереди и никогда не дублировались. Перед отправкой ответа WhatsApp сравните последнее сообщение человека с 24-часовым окном и переключитесь на одобренный шаблон, как только окно закрылось. Ставьте отправки каждого номера в очередь не быстрее 20 сообщений в секунду: это фиксированная скорость номера Coexistence. Помните, что ответ в TikTok является публичным комментарием.

Как человек перехватывает диалог у агента?

Через сам канал. При Coexistence сотрудники вашего клиента продолжают пользоваться приложением WhatsApp Business на том же номере, и каждое их сообщение приходит на ваш вебхук как smb_message_echoes. Считайте эхо сигналом передачи диалога человеку: приостановите агента в этом диалоге, передайте модели ответ сотрудника как контекст и возобновите работу после паузы или когда сотрудник вернёт диалог в вашем продукте. Instagram также возвращает личные сообщения самого аккаунта как эхо, поэтому то же правило не даёт агенту отвечать самому себе.

Должен ли агент также публиковать посты?

Может, через то же подключение. Агент готовит посты, а ваш бэкенд ставит их в очередь через POST /channels/:id/posts для Instagram, Facebook, TikTok и LinkedIn, за срок от 1 минуты до 90 дней вперёд. События post.published и post.failed возвращаются в хранилище диалогов. Посты LinkedIn уходят только после того, как человек одобрит каждый в вашем продукте, потому что Условия API LinkedIn ограничивают автоматическую публикацию.

Как продукт реагирует на обрыв подключения?

Через состояние в строке канала. Событие статуса переводит её в disconnected, removed или suspended, агент прекращает отправку по этому каналу, а ваш интерфейс просит тенанта переподключиться через новую сессию подключения. Событие connection.token_missing оставляет номер в режиме приёма, но без возможности отправки, поэтому агент готовит черновики ответов для сотрудников. Событие connection.connected или channel.connected возвращает строку в состояние active, и воркер получает свежие учётные данные до следующего ответа.

Какие данные хранятся у вас, а какие у easyCoexistence?

Диалоги хранит ваш продукт. Сообщения номера WhatsApp идут от Meta прямо на ваш вебхук, а пересланные события соцсетей проходят через easyCoexistence без копирования. easyCoexistence хранит то, что нужно для работы подключения: запись аккаунта, его токены, историю состояния и публикуемые посты. Если в вашем аккаунте включены собственные автоматизации easyCoexistence, текст их сообщений хранится 7 дней, а журналы запусков 30 дней.

Распространённые ошибки

  • Привязка диалогов только к номеру телефона человека. Один и тот же человек может писать двум вашим тенантам, поэтому ключом диалога делайте канал и ID человека в этой сети вместе.
  • Допускать, чтобы два воркера отвечали в одном диалоге. Параллельные воркеры могут отправить ответы не по порядку или дважды, поэтому блокируйте диалог, пока агент с ним работает.
  • Оставлять агента включённым после того, как сотрудники ответили из приложения WhatsApp Business. Эхо показывает, что диалог перешёл к человеку, поэтому приостановите агента там, пока ваше правило передачи не вернёт ему диалог.
  • Публиковать черновики агента для LinkedIn по таймеру. Каждый пост в LinkedIn одобряет человек, поэтому направляйте такие черновики на проверку до того, как они попадут в очередь.
Настройка с EasyCoexistence

easyCoexistence является уровнем подключений для вашего продукта с агентом: номера WhatsApp ваших клиентов и их аккаунты в Instagram, Facebook, TikTok, YouTube и LinkedIn, а также другие каналы подключаются по ссылкам для подключения, с актуальными учётными данными, вебхуками, очередью публикаций и подписанными событиями статуса; каждое подключение круглосуточно под мониторингом. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений. Первые 3 дня бесплатно.

Часто задаваемые вопросы

Нужно ли клиентам ваших клиентов что-то устанавливать?

Нет. Они пишут бизнесу, как и раньше: в WhatsApp, в личные сообщения Instagram или Messenger или в комментарии, а ваш агент отвечает в том же канале.

Могут ли сотрудники клиентов продолжать отвечать вручную?

Да. При Coexistence приложение WhatsApp Business продолжает работать на том же номере, а каждое сообщение сотрудника приходит на ваш вебхук как эхо, поэтому агент может отойти в сторону.

Запускает ли easyCoexistence модель?

Нет. Модель, её промпты и память работают в вашем бэкенде. easyCoexistence подключает аккаунты, доставляет их события и поддерживает их доступ.

Сколько стоит easyCoexistence за каждого клиента SaaS с агентом?

Каждый подключённый номер или аккаунт стоит от US$ 9 до US$ 0,75 в месяц, и цена снижается по мере роста общего количества подключений, поэтому клиент с WhatsApp и Instagram считается дважды. Первые 3 дня бесплатно.

Читайте дальше

Как построить продукт с ИИ-агентом в WhatsApp, Instagram и TikTok ваших клиентовСоздайте продукт с ИИ-агентом в WhatsApp, Instagram, Facebook и TikTok клиентов: Partner API, своя модель и правила каждой сети.Как построить планировщик постов в соцсетях на API: очередь, медиа и статусыПланировщик постов на API easyCoexistence: публикация до 90 дней вперёд, копирование медиа при планировании, шесть статусов и события постов.Перепродажа функций соцсетей в вашем SaaS: маржа при цене от US$ 9 до US$ 0,75 за подключениеМаржа SaaS при перепродаже функций соцсетей и WhatsApp от US$ 9 до US$ 0,75 за подключение: расчёты для фиксированной надстройки и за аккаунт.API соцсетей для агентств: ведите аккаунты клиентов из собственного ПОAPI для агентств: подключайте аккаунты клиентов по ссылке, помечайте их id клиента, публикуйте после одобрения, направляйте ответы и собирайте отчёты.Как получать сообщения клиентов WhatsApp и комментарии соцсетей по вебхукуВебхук на каждое подключение: сообщения WhatsApp напрямую от Meta, защита секретом в URL, а комментарии и DM соцсетей подписаны X-EC-Signature.Как узнать, что подключение клиента к WhatsApp или соцсети отключилосьСобытия connection.* и channel.*: тело запроса, причины вроде PRIMARY_INACTIVITY, X-EC-Signature, повторы около 33 часов и дедупликация по id.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на