Arquitectura de SaaS con agentes de IA: llegar a los clientes de tus clientes en WhatsApp, Instagram y TikTok
Un SaaS con agentes de IA que llega a los clientes de tus clientes funciona en cinco capas: conexiones, donde cada cliente vincula WhatsApp, Instagram, TikTok y más canales mediante la Partner API de easyCoexistence; ingesta, que verifica y encola los webhooks; un almacén de conversaciones que tú controlas; un worker del agente que ejecuta tu modelo; y salida, que responde, publica y sigue los eventos de estado mediante la API oficial de cada red.
El webhook que describe un mensaje que la empresa envió desde la app de WhatsApp Business en un número con Coexistencia.
Durante cuánto tiempo reintenta Meta un webhook de WhatsApp que tu endpoint no aceptó, lo que puede entregar el mismo mensaje dos veces.
Entregas de cada evento de Instagram, Facebook o TikTok reenviado, sin reintento y sin copia conservada.
La ventana de atención de WhatsApp tras un mensaje de una persona; fuera de ella, una empresa solo envía plantillas aprobadas.
Throughput fijo de un número usado tanto con la app de WhatsApp Business como con la Cloud API.
¿Cuáles son las capas de un SaaS con agentes de IA?
Cinco, cada una con una sola tarea, para que un modelo lento nunca pierda un mensaje y una cuenta caída nunca tumbe el producto. easyCoexistence está en la primera y en la última: conecta las cuentas y las mantiene funcionando, mientras que la lógica de conversación y el modelo permanecen en tu backend.
¿Cómo modelas tenants, canales y conversaciones?
En tres tablas. Un tenant es tu cliente, y su id se envía como external_ref en cada sesión de conexión, de modo que cada conexión y evento de estado regresa etiquetado con él. Una fila de canal guarda el connection_id de un número de WhatsApp o el channel_id de una cuenta social, junto con la red y su estado. Una conversación se identifica por el canal y el ID de la persona en esa red: el número de WhatsApp en from, el ID con alcance de Instagram en un DM, o el hilo del comentario en TikTok.
¿Dónde deben llegar primero los eventos entrantes?
En una cola duradera, antes de que se ejecute cualquier modelo. El endpoint de ingesta verifica el secreto en la ruta de la URL en las entregas de WhatsApp y X-EC-Signature en los eventos sociales reenviados, escribe el evento en la cola y responde 2xx. Las dos fuentes se comportan de forma distinta: Meta reintenta un webhook de WhatsApp durante hasta 7 días, así que el mismo mensaje puede llegar dos veces, mientras que un evento reenviado de Instagram, Facebook o TikTok se envía una sola vez y nunca se conserva, por lo que un evento que tu endpoint descarte se pierde. Deduplica por el ID de mensaje o comentario de la propia red.
¿Cómo mantienes las respuestas en orden y a tiempo?
Un worker por conversación, y una verificación antes de cada envío. Bloquea la conversación mientras trabaja el agente, para que dos mensajes de una misma persona se respondan por turnos y nunca dos veces. Antes de que salga una respuesta de WhatsApp, compara el último mensaje de la persona con la ventana de 24 horas, y cambia a una plantilla aprobada cuando se haya cerrado. Encola los envíos de cada número con un máximo de 20 mensajes por segundo, la tasa fija de un número de Coexistencia, y recuerda que una respuesta en TikTok es un comentario público.
¿Cómo toma una persona el control del agente?
A través del propio canal. Con Coexistencia, el equipo de tu cliente sigue usando la app de WhatsApp Business en el mismo número, y cada mensaje que envía llega a tu webhook como smb_message_echoes. Trata un eco como un traspaso: pausa el agente en esa conversación, pasa la respuesta del equipo al modelo como contexto y reanúdalo tras un periodo de calma o cuando el equipo lo devuelva desde tu producto. Instagram también devuelve como ecos los DM de la propia cuenta, así que la misma regla evita que el agente se responda a sí mismo.
¿Debe el agente también publicar, además de responder?
Puede, con la misma clave. El agente redacta publicaciones y tu backend las encola con POST /channels/:id/posts en Instagram, Facebook, TikTok y LinkedIn, con una antelación de entre 1 minuto y 90 días, y post.published y post.failed informan de vuelta al almacén de conversaciones. Las publicaciones de LinkedIn solo salen después de que una persona apruebe cada una en tu producto, ya que los Términos de la API de LinkedIn restringen la publicación automatizada.
¿Cómo reacciona el producto cuando se cae una conexión?
Mediante un estado en la fila del canal. Un evento de estado lo cambia a disconnected, removed o suspended, el agente deja de enviar por ese canal y tu interfaz pide al tenant que se vuelva a conectar mediante una nueva sesión de conexión. Un evento connection.token_missing deja un número que recibe pero no puede enviar, así que el agente redacta respuestas para que el equipo las revise. connection.connected o channel.connected devuelve la fila a active, y el worker obtiene credenciales nuevas antes de su siguiente respuesta.
¿Qué datos guardas y cuáles conserva easyCoexistence?
Tu producto guarda las conversaciones. Los mensajes de un número de WhatsApp van de Meta directamente a tu webhook, y los eventos sociales reenviados pasan por easyCoexistence sin copia. easyCoexistence conserva lo que necesita para dar servicio a la conexión: el registro de la cuenta, sus tokens, su historial de estado y las publicaciones que realiza. Si tu cuenta también activa las automatizaciones propias de easyCoexistence, el texto de sus mensajes se conserva durante 7 días y sus registros de ejecución durante 30.
Errores comunes
- Usar como clave las conversaciones solo por el número de teléfono de la persona. La misma persona puede escribir a dos de tus tenants, así que identifica cada hilo por el canal y el ID de la persona juntos.
- Dejar que dos workers respondan a una misma conversación. Los workers en paralelo pueden enviar respuestas desordenadas o duplicadas, así que bloquea cada hilo mientras el agente trabaja en él.
- Mantener el agente activo después de que el equipo responda desde la app de WhatsApp Business. El eco indica que una persona ha tomado el hilo, así que pausa el agente allí hasta que tu regla de traspaso lo devuelva.
- Publicar los borradores de LinkedIn del agente con un temporizador. Una persona aprueba cada publicación de LinkedIn, así que envía esos borradores a un paso de revisión antes de que lleguen a la cola.
easyCoexistence es la capa de conexión para tu producto de agentes: los números de WhatsApp de tus clientes y sus cuentas de Instagram, Facebook, TikTok, YouTube y LinkedIn, y más canales, conectados mediante enlaces alojados, con credenciales actualizadas, webhooks, una cola de publicación y eventos de estado firmados, con cada conexión supervisada 24/7. De US$ 9 a US$ 0.75 por conexión al mes, con una tarifa que baja a medida que añades conexiones, y los primeros 3 días gratis.
Preguntas frecuentes
¿Tienen que instalar algo los clientes de mis clientes?
No. Escriben a la empresa como ya lo hacen, por WhatsApp, en los DM de Instagram o en Messenger, o en los comentarios, y tu agente responde por el mismo canal.
¿Pueden seguir respondiendo a mano los empleados de mis clientes?
Sí. Con Coexistencia, la app de WhatsApp Business sigue funcionando en el mismo número, y cada mensaje que envía el equipo llega a tu webhook como eco, de modo que el agente puede apartarse.
¿easyCoexistence ejecuta el modelo?
No. El modelo, sus prompts y su memoria se ejecutan en tu backend. easyCoexistence conecta las cuentas, entrega sus eventos y mantiene activo su acceso.
¿Cuánto cobra easyCoexistence por cliente de un SaaS de agentes?
Cada número o cuenta conectada cuesta de US$ 9 a US$ 0.75 al mes, con una tarifa que baja a medida que crece tu total, así que un cliente con WhatsApp e Instagram cuenta dos veces. Los primeros 3 días son gratis.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el