> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plazbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK Updates

> Nuevas actualizaciones y Mejoras sobre el SDK

<Update label="2026-05-05" description="v2.2.0">
  ### **Streaming SSE en Agentes de IA**

  Los endpoints `/on-message` y `/on-message-portal` ahora soportan **Streaming SSE (Server-Sent Events)**. Envia `stream: true` en el body y recibe la respuesta del agente token por token en tiempo real.

  * Soporte para **OpenAI**, **Claude** y **Gemini**
  * Chunks de tipo `text`, `tool_call`, `tool_result`, `done` y `error`
  * Retrocompatible: clientes existentes no se ven afectados (default `stream: false`)
  * Portal y Widget ahora usan streaming por defecto para una experiencia mas fluida

  ### **Tool Calling activado por defecto**

  Los nuevos agentes ahora se crean con `useToolCalling: true` por defecto. Esto permite que los agentes utilicen el orquestador de Tool Calling para conversaciones mas naturales sin necesidad de activacion manual.

  [Documentacion de Streaming](https://docs.plazbot.com/sdk/agent)
</Update>

<Update label="2026-04-05" description="v2.1.3">
  ### **Plazbot React**

  Presentamos Plazbot React, que te ayuda a crear tu agente dentro de tu plataforma con componentes #React y totalmente flexible con tus colores y experiencia de usuario que necesitas.

  Solo debes de crear tu Agente de IA en Plazbot y referenciarlo por su ID.

  [Documentación completa](https://docs.plazbot.com/sdk/react/introduccion)

  <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/plazbot/FyknwqepOFWHrVg1/images/changelog/react-1.png?fit=max&auto=format&n=FyknwqepOFWHrVg1&q=85&s=bfeefe21b8d050e1d00ae564502c59c5" width="1270" height="760" data-path="images/changelog/react-1.png" />

  <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/plazbot/FyknwqepOFWHrVg1/images/changelog/react-2.png?fit=max&auto=format&n=FyknwqepOFWHrVg1&q=85&s=21b10418e6b95737bb5ed3ecaf76f42e" width="1270" height="760" data-path="images/changelog/react-2.png" />

  <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/plazbot/FyknwqepOFWHrVg1/images/changelog/react-3.png?fit=max&auto=format&n=FyknwqepOFWHrVg1&q=85&s=59a783f79be50fd5165e82115285edcb" width="1270" height="760" data-path="images/changelog/react-3.png" />
</Update>

<Update label="2025-09-01" description="v1.1.7">
  ### **Campo Theme en Portal IA**

  En esta sección técnica, hemos hecho una mejora al momento de crear el portal para el clientes desde el SDK.

  Se ha creado el nuevo campo **Theme** que puede ser **Ligth** o **Dark**, esto es para que el Portal ya se abra con la configuración predeterminada.

  <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/plazbot/sUu4_MV4wmub7lxv/images/changelog/portal-theme.png?fit=max&auto=format&n=sUu4_MV4wmub7lxv&q=85&s=f76ba098953edf149516267a83e96076" width="1714" height="832" data-path="images/changelog/portal-theme.png" />
</Update>

<Update label="2025-08-18" description="v1.0.9">
  ### **Envio de Archivo por SDK de Conversaciones**

  🤖 Con nuestra nueva funcionalidad, ahora puedes enviar archivos por la conversación de Whatsapp a tus usuarios desde tu propia plataforma y por nuestro SDK.

  <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/plazbot/PhaYSfgf_d2VWwHL/images/changelog/file-template.png?fit=max&auto=format&n=PhaYSfgf_d2VWwHL&q=85&s=d3444accb05e6a067c48cc249b2b722c" width="1050" height="796" data-path="images/changelog/file-template.png" />
</Update>

<Update label="2025-05-25" description="v1.0.8">
  ### **Enviar Archivo en el Mensaje**

  🧠 Con nuestra nueva funcionalidad, el Agente de IA podrá leer archivos de la empresa para poder responder dudas a los clientes. Aparte tambien se puede enviar archivos con nuestro metodo onMessage para que la IA por OCR pueda evaluar y poder contestar sin problemas.

  <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/plazbot/PhaYSfgf_d2VWwHL/images/changelog/file-agent-2.png?fit=max&auto=format&n=PhaYSfgf_d2VWwHL&q=85&s=0262f1e1c1e4818bb1bd96522cc3570f" width="1392" height="652" data-path="images/changelog/file-agent-2.png" />

  ### **Entrenamiento de Agentes con Archivos**

  Puedes entrenar al agente de IA con todos los archivos que necesites entrenar para que pueda evaluar y contestar cualquier pregunta o duda que tenga, extrayendo información de estos respositorios.

  <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/plazbot/PhaYSfgf_d2VWwHL/images/changelog/file-agent-3.png?fit=max&auto=format&n=PhaYSfgf_d2VWwHL&q=85&s=e1e0160a0077c440be98be5b2066edc9" width="1164" height="1012" data-path="images/changelog/file-agent-3.png" />

  <Card title="SDK Github" icon="github" href="https://github.com/plazbot/plazbot-sdk-examples">
    Revisa nuestro Repositorio de Github
  </Card>
</Update>

<Update label="2025-05-18" description="v1.0.7">
  ### Primera versión del SDK - Estable

  <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/plazbot/PhaYSfgf_d2VWwHL/images/changelog/sdk-1.png?fit=max&auto=format&n=PhaYSfgf_d2VWwHL&q=85&s=41badc68805f12cef741b4eb95b83fc4" width="1214" height="982" data-path="images/changelog/sdk-1.png" />

  Status: ✅ Stable Beta
  Codename: Genesis 🚀

  ### ✨ Novedades destacadas

  🎉 **Primer lanzamiento público del SDK de Plazbot**

  Crea y gestiona agentes de IA para WhatsApp, Widgets Web y Portales de Búsqueda IA con solo unas líneas de código.
  🧠 Gestión de Agentes

  * addAgent() — Crea agentes con nombre, prompt, color, tamaño del buffer y pregunta inicial
  * getAgents() — Recupera todos los agentes de tu workspace
  * getAgentById() — Obtiene un agente específico por su ID
  * updateAgent() — Modifica los parámetros de un agente
  * deleteAgent() — Elimina un agente y desvincula sus portales

  💬 **Funcionalidades de Mensajería**

  * onMessage() — Envía un mensaje a un agente y recibe una respuesta (compatible con streaming)
  * addExample() — Añade hasta 5 respuestas rápidas de ejemplo por agente
  * clearExamples() — Borra todos los ejemplos asociados a un agente

  🌐 **Integración con Portales IA**

  * addPortal() — Crea portales IA con logo, tipo de acceso y opciones visuales
  * getPortal() — Obtiene la configuración de un portal por ID
  * updatePortal() — Modifica propiedades de un portal
  * deletePortal() — Elimina un portal
  * addAgentToPortal() — Vincula un agente a un portal
  * addLinkToPortal() — Añade enlaces externos al portal
  * clearLinks() — Borra todos los enlaces de un portal

  📲 Envíos por WhatsApp

  * onWhatsappMessage() — Envía mensajes dinámicos de IA a usuarios por WhatsApp
  * onConversation() — Envía mensajes plantilla usando IDs predefinidos
  * registerWebhook() — Registra URLs para recibir mensajes entrantes
  * deleteWebhook() — Elimina el webhook asociado a un número

      <Card title="SDK Github" icon="github" href="https://github.com/plazbot/plazbot-sdk-examples">
        Revisa nuestro Repositorio de Github
      </Card>
</Update>