Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Dale a un agente de OpenAI Agents SDK herramientas para Instagram, TikTok y WhatsApp

Un agente de OpenAI Agents SDK recibe Instagram, TikTok, WhatsApp y más canales como herramientas mediante MCPServerStreamableHttp apuntado a https://easycoexistence.com/api/mcp, con OAuthClientProvider del SDK de Python de MCP como manejador de autenticación. Un filtro de herramientas reduce las más de 35 herramientas a la tarea, require_approval retiene la publicación hasta que una persona la aprueba, y cada llamada llega a la red a través de su API oficial.

httpx2.Auth

Lo que MCPServerStreamableHttp recibe en params["auth"] con el SDK de Python de MCP v2; con v1 recibe un httpx.Auth.

mcp>=1.19.0,<3

El rango del paquete mcp del que depende el Agents SDK, que cubre ambas versiones principales del SDK de Python de MCP.

interruptions

Dónde una ejecución pausada lista las llamadas a herramientas pendientes de aprobación, que un RunState aprueba o rechaza antes de que Runner.run reanude.

Per request

Cada cuánto debe enviarse el token OAuth en authorization a la herramienta MCP de la Responses API; OpenAI no guarda el valor.

40 a minute

Las llamadas que TikTok permite por cuenta autorizada en cada endpoint de la Accounts API, incluidas las respuestas a comentarios.

¿Cómo se conecta un agente de Agents SDK a easyCoexistence?

Mediante MCPServerStreamableHttp, con OAuthClientProvider del SDK de Python de MCP en params["auth"]. El Agents SDK pasa ese manejador al cliente HTTP que construye, de modo que el proveedor descubre el servidor de autorización de easyCoexistence, registra tu agente como cliente público, realiza un único inicio de sesión en el navegador con PKCE y renueva con el token de actualización los tokens de acceso, que duran una hora. El ejemplo usa el SDK de Python de MCP v2, donde el manejador debe ser un httpx2.Auth, y el proveedor cumple esa condición. Un objeto de almacenamiento guarda el registro y los tokens entre ejecuciones; el archivo siguiente hace las veces de un almacén de secretos. create_static_tool_filter enumera las herramientas que el agente puede ver, y require_approval nombra las que esperan a una persona.

The MCP server, signed in over OAuth, with a filter and approvals
import json, webbrowser
from pathlib import Path
from urllib.parse import parse_qs, urlparse

from pydantic import AnyUrl
from mcp.client.auth import AuthorizationCodeResult, OAuthClientProvider
from mcp.shared.auth import OAuthClientInformationFull, OAuthClientMetadata, OAuthToken
from agents.mcp import MCPServerStreamableHttp, create_static_tool_filter

URL = "https://easycoexistence.com/api/mcp"
SAVED = Path("easycoexistence-oauth.json")  # a secret store in production

class SavedSignIn:  # the MCP SDK's TokenStorage: registration and tokens survive restarts
    def _read(self) -> dict:
        return json.loads(SAVED.read_text()) if SAVED.exists() else {}
    def _write(self, key: str, model) -> None:
        data = self._read()
        data[key] = model.model_dump(mode="json")
        SAVED.write_text(json.dumps(data))
    async def get_tokens(self):
        t = self._read().get("tokens")
        return OAuthToken(**t) if t else None
    async def set_tokens(self, tokens): self._write("tokens", tokens)
    async def get_client_info(self):
        c = self._read().get("client")
        return OAuthClientInformationFull(**c) if c else None
    async def set_client_info(self, info): self._write("client", info)

async def open_sign_in(url: str) -> None:
    webbrowser.open(url)

async def code_from_redirect() -> AuthorizationCodeResult:
    q = parse_qs(urlparse(input("Address after sign-in: ")).query)
    return AuthorizationCodeResult(code=q["code"][0], state=q["state"][0])

oauth = OAuthClientProvider(
    server_url=URL,
    client_metadata=OAuthClientMetadata(
        client_name="Social desk agent",  # shown on easyCoexistence's consent screen
        redirect_uris=[AnyUrl("http://localhost:3030/callback")],
        scope="mcp",
    ),
    storage=SavedSignIn(),
    redirect_handler=open_sign_in,
    callback_handler=code_from_redirect,
)

PUBLISH = ["publish_instagram_post", "publish_tiktok_post", "publish_facebook_post"]

def easycoexistence() -> MCPServerStreamableHttp:
    return MCPServerStreamableHttp(
        name="easyCoexistence",
        params={"url": URL, "auth": oauth, "timeout": 60},
        client_session_timeout_seconds=60,  # publishing waits on the network's API
        cache_tools_list=True,
        tool_filter=create_static_tool_filter(allowed_tool_names=[
            "list_social_accounts", "list_social_posts", "list_social_comments",
            "reply_to_comment", "list_scheduled_posts", *PUBLISH,
        ]),
        require_approval={"always": {"tool_names": PUBLISH}},
    )

¿Cómo se mantiene la publicación detrás de la aprobación de una persona?

Con require_approval en el servidor, que pausa la ejecución antes de que se ejecute una herramienta nombrada. La ejecución vuelve entonces con interrupciones en lugar de una respuesta final: convierte el resultado en un RunState, aprueba o rechaza cada llamada pendiente y vuelve a llamar a Runner.run con el mismo agente y el estado. Con always_approve en False, cada sí cubre una sola llamada, de modo que el agente no puede reutilizar una aprobación para una segunda publicación. El servidor permanece abierto durante la pausa porque el bucle se ejecuta dentro de su bloque async with. Para una revisión que tarda horas, el SDK puede guardar el estado como JSON y cargarlo más tarde con RunState.from_json.

Run the agent and resume it after each decision
from agents import Agent, Runner

RULES = "You run Acme's social accounts. Schedule posts with scheduled_at; TikTok replies are public."

async def run(task: str) -> str:
    async with easycoexistence() as server:
        agent = Agent(name="Social desk", instructions=RULES, mcp_servers=[server])
        result = await Runner.run(agent, task)
        while result.interruptions:  # a publish tool is waiting for a decision
            state = result.to_state()
            for item in result.interruptions:
                if await ask_a_person(item):  # your review screen, chat message or queue
                    state.approve(item, always_approve=False)
                else:
                    state.reject(item)
            result = await Runner.run(agent, state)
        return result.final_output

¿Cómo inicia una ejecución un comentario de TikTok o un DM de Instagram?

A través de tu propia ruta HTTPS, ya que el agente solo escucha lo que pide al servidor MCP. set_social_webhook_destination apunta los comentarios, menciones y DMs de una cuenta a la ruta y devuelve un secreto de firma una sola vez; las cuentas de TikTok reenvían comentarios. La ruta verifica X-EC-Signature, un HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo sin procesar, responde dentro del límite de 8 segundos de easyCoexistence y pone el evento en cola. Un proceso en segundo plano llama entonces a Runner.run con el evento como entrada. Para los DMs, una sesión identificada por la cuenta y el remitente mantiene la conversación; un comentario de TikTok necesita solo el comentario y su video, así que puede ejecutarse sin uno.

¿Qué debe decir el prompt del agente sobre cada red?

Las reglas que la API de cada red aplica a la cuenta, escritas donde las lee el modelo:

  • TikTok: reply_to_comment publica en público y necesita el ID del video como post_id; send_social_dm rechaza las cuentas de TikTok.
  • Volumen en TikTok: hasta 40 llamadas por minuto por cuenta en el endpoint de respuesta, y muchas respuestas casi idénticas en poco tiempo pueden ocultarse como spam.
  • DMs de Instagram: solo se responde a personas que escribieron en las últimas 24 horas, con un máximo de 1,000 bytes de texto UTF-8.
  • WhatsApp: send_message dentro de las 24 horas posteriores al último mensaje del cliente, y send_template con una plantilla aprobada en caso contrario.
  • Tiempo: scheduled_at acepta ISO 8601 con zona horaria, de 1 minuto a 90 días de antelación, y list_scheduled_posts muestra la cola.

¿Puede el agente usar HostedMCPTool o funcionar sin inicio de sesión?

Ambas cosas, con compromisos. HostedMCPTool entrega el servidor a la Responses API, cuya herramienta MCP recibe un token de acceso OAuth en authorization y lo necesita en cada petición, ya que OpenAI no lo guarda; un token de acceso de easyCoexistence dura una hora, así que tu código renueva uno antes de cada ejecución. Para una tarea sin nadie que inicie sesión, prescinde de MCP: las herramientas de función que llaman a la Partner API con una clave ec_live_ pueden poner publicaciones en cola mediante POST /api/v1/channels/:id/posts y obtener tokens actualizados de TikTok, YouTube y LinkedIn desde GET /api/v1/channels/:id?credentials=1, mientras que las reglas de comentarios y las automatizaciones responden en easyCoexistence sin que ningún agente esté en ejecución.

Errores comunes

  • Mantener el client_session_timeout_seconds de 5 segundos para publicar. Una publicación espera a la API de la red, así que una llamada lenta puede agotar el tiempo en el agente después de que easyCoexistence haya enviado la publicación a la red; deja un minuto y revisa list_scheduled_posts antes de volver a intentarlo.
  • Pasar external_id como account_id. Las herramientas reciben account_id, el ID de easyCoexistence de la cuenta; external_id es el ID propio de la cuenta en Instagram, TikTok o Facebook.
  • Aprobar interrupciones en un bucle sin ninguna persona. require_approval solo protege la publicación cuando una persona, o una regla en la que confíes, decide sobre cada llamada pendiente.
  • Dar al agente la actividad propia de la cuenta. Instagram devuelve los DMs de la cuenta como ecos con is_echo en true y sus respuestas públicas como comentarios nuevos; filtra ambos antes de Runner.run.
Hacerlo con EasyCoexistence

easyCoexistence da a tus agentes de OpenAI Agents SDK llegada a clientes en WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn y más canales, cada uno a través de su API oficial: un servidor MCP que inicia sesión con OAuth, eventos firmados para comentarios y DMs, y una Partner API para tareas que se ejecutan sin supervisión, con cada conexión monitorizada 24/7. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, y los primeros 3 días son gratis.

Preguntas frecuentes

¿El agente necesita una clave de API de easyCoexistence?

No para MCP. El inicio de sesión OAuth emite al agente sus propios tokens; una clave ec_live_ del panel solo sirve para el código que llama a la Partner API en lugar del servidor MCP.

¿Puede el mismo agente responder a mensajes de WhatsApp?

Sí, con las herramientas del número: list_numbers para obtener el connection_id, send_message dentro de las 24 horas posteriores al último mensaje del cliente y send_template fuera de ese plazo. La guía de OpenAI Agents SDK para WhatsApp cubre la recepción de los mensajes.

¿Qué modelo usa el agente?

El que le asignes en Agent. Las herramientas MCP funcionan igual con cualquier modelo que ejecute el SDK, su uso lo factura su proveedor y easyCoexistence cobra por conexión.

¿Cuánto cuesta easyCoexistence para un agente de OpenAI Agents SDK?

De US$ 9 a US$ 0.75 por conexión al mes, que baja a medida que añades conexiones, igual en cada red. El servidor MCP, los eventos reenviados y la Partner API están incluidos, y 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