Cómo crear un producto de agente de IA en el WhatsApp, Instagram y TikTok de tus clientes
Un producto de agente de IA en los canales de los clientes se apoya en tres piezas: un enlace de conexión alojado para el número de WhatsApp o la cuenta social de cada cliente; webhooks que llevan sus mensajes y comentarios a tu backend, donde tu propio modelo redacta las respuestas que se envían por la API oficial de cada red con el token del cliente; y eventos de estado para las conexiones que se interrumpen. El agente respeta las reglas de cada red, como la ventana de 24 horas de WhatsApp.
easyCoexistence da a los agentes de IA de tu producto una voz en los números de WhatsApp de tus clientes y en sus cuentas de Instagram, Facebook, TikTok, YouTube y LinkedIn, y más canales: enlaces de conexión alojados, credenciales renovadas, webhooks y eventos de estado firmados sobre la API oficial de cada red, con cada conexión vigilada las 24 horas.
Ventana de atención al cliente de WhatsApp tras un mensaje o llamada del usuario; cada nuevo mensaje la reinicia.
Lo que un negocio de WhatsApp puede enviar una vez cerrada la ventana de atención al cliente: plantillas de mensaje preaprobadas.
Las condiciones de Meta impiden a los proveedores de IA usar WhatsApp para ofrecer la IA como funcionalidad principal, y no incidental.
Ventana para la única respuesta privada de una cuenta de Instagram a un comentario, contada desde el momento en que se hizo el comentario.
Throughput fijo de un número usado tanto con la app de WhatsApp Business como con la Cloud API.
¿Qué necesita un producto de agente de IA del canal de cada cliente?
Cuatro cosas: una forma de que el cliente lo conecte, que sus mensajes lleguen a tu backend, un token para responder y aviso cuando la conexión deje de funcionar. La Partner API cubre cada una de ellas, mientras que el modelo, los prompts y la lógica de conversación siguen siendo tuyos. easyCoexistence conecta la cuenta, mantiene renovado su acceso y la vigila, y tus respuestas van desde tu backend directamente a la API de la red.
¿Cómo se conecta cada cliente?
Tu backend crea una sesión de conexión con POST /connect-sessions, indicando el canal, un redirect_url y un external_ref para tu cliente, y para un número su webhook_url y su webhook_verify_token. El cliente abre el enlace alojado, inicia sesión con Meta, TikTok, Google o LinkedIn y vuelve a tu app con connection_id o channel_id. No necesita cuenta, correo ni tarjeta de easyCoexistence, y cada conexión hecha con tu clave pertenece a tu cuenta.
¿Cómo llegan los mensajes y comentarios a tu modelo?
Por webhook, en las redes que los envían. Meta entrega los mensajes de un número directamente a su webhook_url, y lo que el personal del negocio envía desde la app de WhatsApp Business llega allí como smb_message_echoes. Los comentarios, menciones y DMs de Instagram y Facebook, y los comentarios de TikTok, se reenvían al destino de cada canal, firmados con el secreto de cada canal. YouTube y LinkedIn no envían eventos de comentarios, así que el agente lee los comentarios nuevos a través de sus API según un calendario. Responde a cada entrega con 2xx de inmediato y deja que un worker llame al modelo.
¿Cómo responde el agente?
A través de la API propia de la red, con las credenciales que tu backend obtuvo. Una respuesta de WhatsApp es un POST al send_endpoint del número con el token del cliente; un DM de Instagram o Facebook va al edge messages de la cuenta; una respuesta de TikTok va bajo el comentario mediante business/comment/reply/create/. El esquema siguiente responde mensajes de WhatsApp: comprueba el secreto en la ruta de la URL, pone en cola cada mensaje entrante y responde con lo que devuelva tu modelo.
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()¿Qué usa el agente: servidor MCP o Partner API?
La Partner API, cuando el agente es tu producto y tus clientes aportan los canales: tu backend guarda la clave, recibe los eventos y ejecuta el modelo que elijas. El servidor MCP en https://easycoexistence.com/api/mcp sirve a un asistente como Claude o ChatGPT que actúa sobre tu propia cuenta de easyCoexistence, mediante herramientas que llama bajo petición tras un inicio de sesión OAuth. Los números y canales conectados con tu clave también están en esa cuenta, así que una sesión MCP puede acceder a ellos para el trabajo de tu propio equipo.
| 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 |
¿Cómo gestionan las agencias agentes para muchos clientes?
En una sola cuenta, con cada cliente etiquetado. Pasa el ID del cliente como external_ref en cada sesión de conexión, muestra el nombre de tu agencia en la página alojada con partner_name, y lista las conexiones de un cliente con GET /connections?external_ref= y GET /channels?external_ref=. Cada conexión se factura a la agencia de US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que se añaden conexiones, mientras que Meta factura los cargos de conversación de WhatsApp a la cuenta de WhatsApp Business del propio cliente. Con Coexistencia, el personal del cliente sigue respondiendo en la app de WhatsApp Business junto al agente.
¿Qué reglas debe cumplir el agente?
Las de las propias redes, que tu código debería comprobar antes de que salga la respuesta del modelo. Las plataformas las mantienen en nombre de sus clientes, ya que la aplicación de Meta recae sobre la cuenta del cliente:
- WhatsApp: respuestas de texto libre solo dentro de las 24 horas posteriores al último mensaje del cliente; después, una plantilla aprobada, enviada por la API, porque la app de WhatsApp Business no puede enviar plantillas en Coexistencia.
- WhatsApp: las condiciones de Meta prohíben ofrecer la IA como funcionalidad principal, lo que la referencia de la Partner API traduce como sin bots de IA de uso general, y permiten el ajuste fino con datos de WhatsApp solo para el uso exclusivo del negocio.
- Instagram y Facebook: DMs dentro de las 24 horas posteriores al último mensaje de la persona, y una respuesta privada por comentario dentro de los 7 días siguientes a este.
- TikTok: las respuestas a comentarios son públicas, ya que una conexión de TikTok no tiene DMs.
- Volumen: 20 mensajes por segundo por número de Coexistencia, y las plantillas de marketing requieren un método de pago en la cuenta de WhatsApp Business del cliente.
¿Cómo sabe el agente que un canal dejó de funcionar?
Por los eventos de estado. connection.disconnected o channel.disconnected significa que las respuestas fallan hasta que el cliente se vuelve a conectar, así que pausa el agente de ese cliente, avísale y envíale un enlace de conexión nuevo; connection.token_missing significa que el número puede recibir pero aún no enviar. Cuando llega de nuevo connection.connected o channel.connected, obtén credenciales nuevas y reanuda. Cada evento va firmado con X-EC-Signature y se reintenta durante unas 33 horas.
Errores comunes
- Dejar que el modelo responda con texto libre a un mensaje de WhatsApp de más de 24 horas. La ventana ya se cerró, así que revisa la hora del último mensaje entrante del cliente y cambia a una plantilla aprobada.
- Entrenar un modelo compartido con las conversaciones de WhatsApp de los clientes. Las condiciones de Meta permiten el ajuste fino con datos de WhatsApp Business Platform solo para el uso exclusivo del negocio, nunca para mejorar otros modelos.
- Tratar smb_message_echoes como mensajes de cliente. Son lo que el personal del negocio envió desde la app, así que pásaselos al modelo como contexto, no como mensajes a los que responder.
- Responder a las propias respuestas de la cuenta. Los DMs de Instagram que envía vuelven como echoes y las respuestas de TikTok como eventos de comentario, así que omite todo lo que escribió la propia cuenta, o el agente se responderá a sí mismo.
De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Puedo usar mi propio modelo de IA?
Sí. Tu backend recibe los mensajes, llama al modelo que elijas y responde a través de la API de la red con el token del cliente. Los mensajes de un número de WhatsApp van de Meta directamente a tu webhook, nunca pasando por easyCoexistence.
¿Qué significa la política de IA de Meta para un agente de WhatsApp?
Las condiciones de Meta impiden a los proveedores de IA usar la WhatsApp Business Platform para ofrecer tecnología de IA como funcionalidad principal, y no accesoria o complementaria, según determine Meta. Cúmplelas en nombre de tus clientes, junto con la ventana de 24 horas y las plantillas aprobadas.
¿Puede el agente enviar DMs en TikTok, YouTube o LinkedIn?
No. En esas redes el agente trabaja en los comentarios: las respuestas de TikTok son públicas, y los comentarios de YouTube y LinkedIn se leen y responden a través de sus API.
¿Cuánto cuesta easyCoexistence para un producto de agente de IA?
Por conexión, igual en todas las redes: de US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis. Meta factura los cargos de conversación de WhatsApp a la cuenta de WhatsApp Business de cada cliente.
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