# Registro de cambios

> Novedades de la plataforma para desarrolladores de watsi — la API REST de acciones, el servidor MCP, OAuth, los webhooks y esta documentación.

Source: https://docs.watsi.ai/changelog

## 2026-11-19 — Agendar desde el panel con los horarios disponibles

La ventana para crear una cita en **Calendarios** y en los chats muestra ahora los horarios libres del tipo de cita, como tu página de reservas, y deja **Personalizado** para agendar a cualquier hora aunque choque. El colaborador se elige antes de la hora, entre el equipo del tipo de cita, y **Cualquiera del equipo** asigna la cita a un miembro libre. Ver [Disponibilidad del equipo](/scheduling/team-availability).

## 2026-11-19 — `appointment_booking_failures`

`appointment_booking_failures` (`analytics:read`, `GET /v1/actions/analytics/booking-failures`) devuelve las citas que el agente no pudo agendar a un prospecto por la configuración del espacio de trabajo, agrupadas por un motivo estable: `no_appointment_types` (no hay tipos de cita), `type_not_found` (el tipo pedido no existe o está deshabilitado), `no_availability` (una semana o más sin horarios), `no_members` (ningún asesor disponible en el tipo) y `api_error`. Responde `{ from, to, total, by_reason: [{ reason, count, last_at, example_conversation_id }], recent: [...], truncated }`. Sin `from` cubre los últimos 7 días; `limit` (1–100, 20 por omisión) acota `recent`. Las negativas de las que el agente se recupera solo (pedir el nombre, elegir un tipo, un horario recién ocupado) no cuentan como fallas. Es de sólo lectura.

## 2026-11-19 — `ads_pipeline_funnel` y `mark_appointment_sale`

`ads_pipeline_funnel` (`analytics:read`, `GET /v1/actions/analytics/ads-pipeline-funnel`) devuelve el embudo de anuncios de un periodo en nueve pasos: impresiones y clics de Meta, chats iniciados desde un anuncio de Meta, chats donde el prospecto respondió después de la primera respuesta del agente, perfilado completo, chats donde el agente ofreció horarios, citas agendadas, asistencias y ventas. Cada paso trae `value`, `source` (`meta`, `auto` o `client_answer`) y, cuando no se puede calcular, `value: null` con `missing_reason` en vez de un cero; `attendance` y `sale` separan sí, no y sin contestar. Las impresiones y los clics salen de la copia diaria de Meta, que existe para ventanas de 7, 30, 90 y 365 días que terminan el día de la sincronización. Sin `from`/`to` cubre los últimos 30 días.

`mark_appointment_sale` (`scheduling:write`, `POST /v1/actions/appointments/sale`) guarda si una cita que ya terminó acabó en venta: `sold: true`, `false`, o `null` para borrar la respuesta. No envía nada ni mueve etapas del embudo.

## 2026-11-19 — Carpetas de flujo, orden y procedencia en los anuncios de un cliente

La sección Ads del ciclo de vida de un cliente tiene ahora tres carpetas fijas, **Borradores**, **Aprobados** y **Publicados**, y un anuncio subido sin carpeta cae en Borradores. Cuatro acciones nuevas, sólo con llave de API y `lifecycle:write`: `lifecycle_ads_move` (p. ej. los aprobados de Borradores a Aprobados), `lifecycle_ads_copy`, `lifecycle_ads_reorder` y `lifecycle_ads_update_item`. Cada anuncio guarda `sourceSkill`, `sourceSkillVersion`, `parentAdId` y `notes`, que `lifecycle_ads_create_upload` y `lifecycle_ads_import_url` aceptan al subir y `lifecycle_ads_list` devuelve junto con `position` y el `kind` de cada carpeta. Las cinco acciones anteriores pasan a la versión 1.1.0: todo lo nuevo es opcional. Ninguna envía nada al cliente.

## 2026-11-18 — Facturación y envío de cotizaciones, sólo con clave de API en MCP

Una conexión por OAuth (Claude, ChatGPT) ya no lista ni puede llamar `workspace_billing_status`, `workspace_credit_usage`, `workspace_payment_history`, `send_quote`, `confirm_quote_send`, `prepare_quote_contract_send`, `update_quote_payment_method` ni `prepare_phone_number_request`, y los alcances `billing:read` y `quote_sends:write` salen de la pantalla de consentimiento. Con una clave de API todo sigue igual, por MCP y por REST. Además, las vistas previas de las acciones en dos pasos se anuncian ahora con `readOnlyHint: true`, y `refresh_leads`, `set_stage_google_ads_conversion`, `set_meeting_assistant` y `update_meeting_assistant_settings` con `openWorldHint: true`. Ver [MCP](/mcp).

## 2026-11-17 — El video de las llamadas se guarda 24 meses

Con `saveVideo: true`, el video de cada llamada se guarda ahora 24 meses, lo mismo que su transcripción, en vez de 90 días. Pasados los 90 días se mueve a un almacenamiento más barato y se sigue viendo igual en Videollamadas. Borrar un contacto o el espacio de trabajo borra sus videos al momento, como antes. Ver [Videollamadas por API y MCP](/guides/meetings-api).

## 2026-11-17 — Transcripciones, más compacta

La página de videollamadas del panel se llama **Transcripciones** en el menú lateral y se ordena como Contactos: pestañas arriba, una búsqueda y un solo botón de filtros, donde ahora también está **Anteriores / Próximas**. Invitar al asistente y sus ajustes están juntos en **Configurar asistente**, y cada llamada ocupa una fila. Ver [Videollamadas](/scheduling/video-calls).

## 2026-11-16 — watsi está en el directorio de conectores de Claude

En Claude (web, escritorio y móvil) ya no hace falta agregar watsi por URL: búscalo como «watsi» en el directorio de conectores y conéctalo con tu cuenta de watsi. En ChatGPT se sigue agregando como conector personalizado. Hay una guía con capturas para cada una: [Conecta con Claude](/mcp/claude) y [Conecta con ChatGPT](/mcp/chatgpt).

## 2026-11-17 — `saveVideo` en los ajustes del asistente de reuniones

`get_meeting_assistant_settings` y `update_meeting_assistant_settings` (versión 1.1.0) traen `saveVideo`: si el espacio de trabajo guarda el video de cada llamada, además de su transcripción, durante 90 días. En la actualización el campo es opcional y, si no lo mandas, el ajuste se queda como está. Ver [Videollamadas por API y MCP](/guides/meetings-api).

## 2026-11-15 — Un día habilitado sin horarios de inicio responde `VALIDATION_ERROR`

`set_appointment_type_weekly_rules` respondía «el servicio de agenda no está disponible — reintenta» a una regla con `enabled: true` y `slotStarts` vacío, y reintentar nunca servía. Ahora responde `VALIDATION_ERROR` (400) sin escribir nada: un día habilitado necesita al menos un horario de inicio en `slotStarts`, y un día sin horarios va con `enabled: false`. Ver [MCP](/mcp).

## 2026-11-15 — `funnel_conversion` y `mark_appointment_attendance` por MCP y REST

Dos acciones que sólo tenía el Asistente se pueden usar ahora por MCP y por la API REST. `funnel_conversion` (`GET /v1/actions/analytics/funnel-conversion`, `analytics:read`) da el embudo de conversión de un periodo con los mismos números que la página Embudo. `mark_appointment_attendance` (`POST /v1/actions/appointments/attendance`, `scheduling:write`) marca si el cliente asistió a una cita que ya terminó, con los mismos efectos que marcarla en la tarjeta del chat. Las dos necesitan una credencial con un miembro detrás (`MEMBER_REQUIRED` sin él) y siguen lo que ese miembro puede ver. Ver [MCP](/mcp).

## 2026-11-14 — El Cotizador sin activar responde `QUOTING_NOT_ENABLED`

Las acciones del Cotizador (`list_quotes`, `list_quotable_properties`, `get_quoting_setup`, `list_contract_templates` y todas las demás `quotes/*`) responden ahora `QUOTING_NOT_ENABLED` (403), en vez de `FORBIDDEN`, cuando el espacio de trabajo no tiene el Cotizador activado. `FORBIDDEN` queda para una persona sin el permiso. Ver [Cotizaciones por API y MCP](/guides/quotes-api).

## 2026-11-13 — Toda cita agendada por MCP y REST tiene asesor

Una cita agendada con `book_appointment` por un miembro con «cambiar cualquier cita» quedaba sin asesor, en el calendario de nadie. Ahora recibe al asesor que el equipo de su tipo de cita asigna a esa hora (el mismo reparto que las citas del agente), y la vista previa lo dice en `advisor`; sin tipo de cita, la cita es de quien la agenda. La confirmación agenda para ese asesor (`ADVISOR_UNAVAILABLE` si ya no puede), y nadie disponible en el equipo responde `NO_MEMBER_AVAILABLE`. `book_appointment` y `reschedule_appointment` rechazan en la vista previa una hora que el tipo de cita no ofrece (`SCHEDULE_VIOLATION`), en vez de hacerlo al confirmar. Además: un descanso o un horario que se encima con otro responde `OVERLAPPING_WINDOW` (409) en vez de «servicio no disponible», y `set_member_schedules` con alguien que no es miembro responde `MEMBER_NOT_FOUND` (404) con su id. Ver [MCP](/mcp).

## 2026-11-13 — Las lecturas de analítica rechazan un periodo imposible y reportan bien los cambios

Las herramientas de analítica con `from`/`to` (`workspace_overview`, `escalation_breakdown`, `agent_performance_overview`, `appointment_stats`, `profiling_report`, `lead_attribution` y `conversations_report`) responden `VALIDATION_ERROR` (400) cuando `to` es anterior a `from` (`details.reason: "PERIOD_REVERSED"`) o cuando una fecha no existe, como `2026-13-01` o `2026-02-30` (`details.reason: "INVALID_DATE"`); antes la primera devolvía un error de base de datos y la segunda se recorría en silencio a otra fecha. `meta_ads_performance` hace lo mismo con `dateStart`/`dateStop`. Además:

- Un conteo de conversaciones que sube desde un periodo sin ninguna se reporta como `{ change: 683, unit: "count", direction: "improved" }`, no como `0` % sin cambio (`workspace_overview` 5.0.0, `agent_performance_overview` 3.0.0).
- `escalation_breakdown` (2.0.0) da `escalationRate` con dos decimales, igual que `workspace_overview`, y su serie `daily` cuenta cada conversación escalada el día en que empezó: cubre exactamente los días del periodo y suma `totalEscalated`.
- `meta_ads_performance` (2.0.0) atribuye prospectos en espacios de trabajo con muchos contactos (antes la atribución fallaba y cada anuncio leía 0); `attributionAvailable` es `null` cuando no se pidió `includeProspects`, y `attributionUnavailableReason` dice por qué cuando es `false`.
- `advisor_at_risk_conversations` documenta lo que ya hacía la app: sin reasignación por SLA (`slaEngineEnabled: false`) la lista se calcula igual contra el SLA de referencia, no viene vacía.

Ver [MCP](/mcp).

## 2026-11-13 — `profiling_report` nombra los campos que existen, y códigos más claros al importar un enlace

`profiling_report` con un campo de perfilado que ningún agente tiene configurado responde ahora `PROFILING_FIELD_NOT_FOUND` (400), cuyo mensaje lista los campos configurados, en vez de `NOT_FOUND` (404). `attachment_import_url` responde `ATTACHMENT_URL_NOT_ALLOWED` en vez de `ATTACHMENT_URL_URL_NOT_ALLOWED`, y con el mismo código y el mismo mensaje un enlace que no es `https://`, una dirección privada o un servidor que no se pudo alcanzar; los demás códigos son `ATTACHMENT_URL_INVALID`, `ATTACHMENT_URL_TOO_MANY_REDIRECTS`, `ATTACHMENT_URL_HTTP_ERROR`, `ATTACHMENT_URL_TIMEOUT` y `ATTACHMENT_TOO_LARGE`. La descripción de `get_agent_config` aclara que `channelBindings` lista todos los canales del espacio de trabajo, y que los que tienen `ownedByThisAgent: true` son los de ese agente. Ver [MCP](/mcp).

## 2026-11-13 — `find_conversations`: los estados reales, el cursor que llega a todas y sin chats de prueba

El filtro `status` de `find_conversations` (`conversations/list`) acepta ahora los estados que una conversación tiene de verdad: `active`, `escalated`, `resolved` y `cancelled`. `closed` sigue aceptándose como sinónimo de `resolved`; `pending` responde `400`, porque ninguna conversación lo tuvo nunca (siempre devolvía 0): para las que esperan respuesta del equipo usa `awaitingReply=true`. La lista ya va de verdad de la actividad más reciente a la más vieja, con las conversaciones sin ningún mensaje al final, y cada página trae `nextCursor` para pedir la siguiente con `cursor` — el único cursor que llega a esas últimas. Las conversaciones de prueba del agente (playground) ya no salen en la lista, en `total` ni en `get_conversation`, igual que en los reportes. Pedir `unassigned` junto con `assignedTo` responde `VALIDATION_ERROR`, y `conversations_report` rechaza con `400` un `from`/`to` que no sea una fecha `AAAA-MM-DD` o un instante ISO. Ver [Paginación](/guides/pagination).

## 2026-11-13 — Una plantilla se busca en el número de la conversación

`conversation_send_template` y `start_conversation` comprueban ahora la plantilla en el número de WhatsApp que envía (el de la conversación, o el que abriría la nueva), no en todo el espacio de trabajo. Una plantilla dada de alta en varios números ya no se rechaza como «aprobada en varios idiomas» cuando pasas `languageCode`, y una aprobada sólo en otro número responde `TEMPLATE_NOT_FOUND` diciéndolo, en vez de dar una vista previa que Meta rechazaría. `quick_reply_set_hidden` acepta sólo una acción rápida integrada (`email`, `phone`) o una de tus respuestas rápidas; otro id responde `QUICK_REPLY_NOT_FOUND` (404). `conversation_edit_note` devuelve el autor de la nota, como la lista. Ver [Acciones en dos pasos](/guides/two-step-actions).

## 2026-11-13 — `conversation_set_active_agent` cambia el agente de una conversación que ya tenía uno

`conversation_set_active_agent` fallaba en toda conversación que ya tenía agente. Ahora hace que el agente elegido le conteste a ese cliente desde su siguiente mensaje, como un traspaso de etapa del embudo: lee la conversación desde ese momento, con un resumen de lo anterior, y la elección dura hasta que la conversación cambie de etapa. `null` devuelve la conversación al agente de su etapa. Las dos acciones del agente de una conversación responden además `ownerAgentId` (el agente al que pertenece la conversación, que no cambia), y `agentId` es el que contesta. Si la conversación cambió mientras se aplicaba, responde `CHAT_UPDATE_REFUSED` (409) sin cambiar nada. Ver [MCP](/mcp).

## 2026-11-13 — Pedir un número sin llamadas habilitadas responde `PHONE_CALLING_NOT_ENABLED`

`prepare_phone_number_request` y su confirmación responden ahora `PHONE_CALLING_NOT_ENABLED` (403), en vez de `FORBIDDEN`, cuando el espacio de trabajo no tiene las llamadas telefónicas habilitadas. `FORBIDDEN` queda para una persona sin el permiso de configurar el agente. Ver [Acciones en dos pasos](/guides/two-step-actions).

## 2026-11-13 — Preguntas frecuentes de una propiedad y conversiones de Google Ads por etapa

`generate_product_faqs` genera las preguntas frecuentes de una propiedad (se publican en su página pública y el agente las usa) y devuelve las que guardó. `list_google_ads_conversion_actions` y `set_stage_google_ads_conversion` muestran y eligen qué conversión de Google Ads reporta cada etapa del embudo; si Google Ads no está autorizado, conectado o configurado responden con un código, no con una lista vacía. Ver [MCP](/mcp).

## 2026-11-13 — Las acciones sobre una conversación respetan la bandeja de cada miembro

Asignar, resolver, reabrir, escalar, pausar el agente, marcar leída, cambiar observadores, el estado y la etapa del embudo de una conversación, y agendar una cita desde ella, siguen ahora la bandeja de la persona detrás de la llamada: si su rol sólo ve sus contactos, una conversación de otro responde `CONVERSATION_NOT_FOUND` (404), igual que una que no existe; si los permisos no se pueden leer, `SERVICE_UNAVAILABLE` (503). `create_ticket` exige además que `chatId` sea una conversación de ese mismo contacto. Ver [MCP](/mcp).

## 2026-11-13 — Prender, apagar y cambiar el agente de una conversación

`conversation_set_agent_enabled` prende o apaga el agente de IA en una conversación de forma permanente (no es la pausa de `conversation_set_agent`), y `conversation_set_active_agent` elige qué agente le contesta a ese cliente. Los dos piden `conversations:write` y `chat:reply`, y hacen exactamente lo que el chat de la app. Ver [MCP](/mcp).

## 2026-11-13 — Las respuestas aprendidas por MCP y REST

`list_learned_answers` y `find_similar_learned_answer` (`agents:read`) leen las respuestas que un agente aprende de tu equipo en los chats, y `save_learned_answer`, `create_learned_answer`, `edit_learned_answer`, `delete_learned_answer` y `dismiss_learned_answer` (`knowledge:write`) las guardan, enseñan, corrigen, borran o descartan, con los mismos permisos que la app y sólo sobre chats que el miembro puede ver. Ver [MCP](/mcp).

## 2026-11-13 — `add_agent_knowledge` ya no devuelve el documento de otro agente

Si el contenido que agregas ya existe en el espacio de trabajo, `add_agent_knowledge` devuelve el documento solo cuando es del mismo agente (`alreadyExisted: true`); si es de otro agente o de todo el espacio de trabajo, ese documento sale fallido con `KNOWLEDGE_ALREADY_EXISTS` y el nombre de quién lo tiene. Ver [MCP](/mcp).

## 2026-11-13 — El conocimiento del agente por MCP y REST

`crawl_agent_website`, `import_agent_qa_pairs` y `retrain_agent_knowledge` (`knowledge:write`) agregan una página web pública o pares de pregunta y respuesta a la base de conocimiento de un agente, y vuelven a procesar sus documentos. Importar preguntas y respuestas crea un documento que el agente consulta; no cambia las preguntas y respuestas configuradas. Ver [MCP](/mcp).

## 2026-11-13 — Exportar las tablas del tablero a CSV por MCP y REST

`prepare_analytics_export` (`analytics:read`) responde un enlace de 15 minutos para descargar en CSV las conversaciones, las publicaciones de Instagram y Facebook o los anuncios de Meta: el mismo archivo que exporta el tablero, nunca las filas en la respuesta. Sólo lo abre el miembro que lo pidió, y al abrirlo se vuelven a comprobar su acceso y sus permisos; cada descarga queda registrada sin su contenido. Un archivo tiene hasta 5 000 filas, y si se cortó lo dicen su nombre (`max5000`) y la cabecera `X-Export-Truncated`. Las conversaciones son un archivo de contactos (nombre, teléfono y resumen de IA), así que piden además `contacts:read`. La bandeja de leads no se exporta. Ver [MCP](/mcp).

## 2026-11-13 — La bandeja de leads por MCP y REST

`list_leads` lee los formularios de leads del espacio de trabajo (Meta, TikTok, Google y sus formularios web) y las personas que captaron, con su teléfono, correo y respuestas, sin llamar a Meta. `refresh_leads` le pide antes a Meta los leads que todavía no llegaban y puede sumar leads nuevos a la bandeja; corre una vez por minuto por espacio de trabajo, y dentro de ese minuto responde lo guardado con `refreshed: false` y `refreshSkipped: "throttled"`. Las dos piden `leads:read`, un alcance nuevo que se concede sólo si se marca (en una clave de API nueva y al conectar por OAuth es una casilla desmarcada) y que `leads:write` no incluye. Ya están en el asistente para dueños y administradores; por MCP y REST se publican cuando el servidor tenga configurada la llave interna de la webapp. Ver [MCP](/mcp).

## 2026-11-13 — La configuración del cotizador por MCP y REST

`create_quote_scheme` y `update_quote_scheme` (`quotes:write`) crean y cambian los esquemas de venta, y `update_quote_payment_method` la etiqueta de un método de pago o si se ofrece; cambian lo que ofrece cada cotización nueva, sin enviarle nada a nadie. Cambiar el precio o el estado de una unidad sí llega a los clientes (el agente cotiza el precio nuevo desde su siguiente respuesta, la página pública de la unidad la muestra o la oculta, y marcarla disponible libera el apartado), así que va en dos pasos: `prepare_inventory_unit_update` responde una vista previa y un `confirmToken`, y `confirm_action` (por REST, la ruta `…/confirm`) lo aplica una sola vez. Piden un miembro con el permiso de administrar el cotizador (o los métodos de pago). Los datos bancarios, crear o borrar métodos de pago y unidades, borrar un esquema y editar los links de pago siguen en Cotizador → Configuración. Ver [MCP](/mcp).

## 2026-11-13 — Anuncios, contenido y conversaciones en riesgo por MCP y REST

`meta_ads_performance` lee el panel de anuncios de Meta: gasto, impresiones, clics, CTR y resultados por anuncio en una ventana de fechas y, con `includeProspects`, los prospectos, ingresos y ROI que trajo cada uno. `content_performance` lee las publicaciones de Instagram y Facebook (vistas, alcance, interacción) y suma las de la cuenta en el periodo y en el anterior; `content_audience`, quién sigue la cuenta y los mejores horarios para publicar. `advisor_at_risk_conversations` lista las conversaciones asignadas que están agotando su tiempo de respuesta ahora mismo. Las cuatro piden `analytics:read`, se leen de lo que la sincronización diaria guarda (sin llamar a Meta) y siguen los permisos del miembro detrás de la credencial: los anuncios y el contenido piden su permiso y la función de Meta marketing del espacio de trabajo, y un miembro que sólo ve sus conversaciones recibe sólo las suyas. Ya están en el asistente; por MCP y REST se publican cuando el servidor tenga configurada la llave interna de la webapp. Ver [MCP](/mcp).

## 2026-11-13 — Los canales de un contacto y los posibles duplicados por MCP y REST

`contact_list_channels` (`contacts:read`) lista los canales y fuentes con que se conoce a un contacto. `contact_add_channel` agrega uno, y rechaza un canal que ya es de otro contacto (`CHANNEL_TAKEN`) en vez de moverlo; `contact_remove_channel` quita uno. `pending_merge_list` (`contacts:read`) lista las sugerencias de «Posibles duplicados», y `pending_merge_reject` rechaza una para que los dos contactos sigan separados. Las escrituras piden `contacts:write`, van en un paso y, como las demás escrituras del CRM, están apagadas hasta que se activan para tu espacio de trabajo. Aceptar una fusión borra uno de los dos contactos, así que sigue siendo desde la app. Ver [MCP](/mcp).

## 2026-11-13 — Borradores y pausa de campañas

`create_campaign_draft` y `update_campaign_draft` guardan y editan un borrador de campaña de WhatsApp: la plantilla aprobada y sus variables, el número que envía, la regla de audiencia (listas, un filtro del CRM o quienes no respondieron a otra campaña; nunca ids de contactos), el horario, el tope diario y la hora de inicio. Un borrador no le envía nada a nadie. `pause_campaign` detiene una campaña en curso; reanudarla se hace en la app. Piden `broadcast:write` y el permiso de enviar campañas; una clave o conexión que ya tiene `broadcast:write` gana estas tres herramientas sin cambiar nada. Igual que las lecturas, ya están en el Asistente (pausar es una tarjeta que aplicas) y llegan a MCP y REST cuando el servidor tenga configurada la llave interna de la webapp. Ver [MCP](/mcp).

## 2026-11-13 — Lecturas de campañas (Asistente ahora; MCP y REST con la llave interna)

`list_campaigns`, `get_campaign` y `list_campaign_recipients` leen las campañas de WhatsApp del espacio de trabajo con sus números (inscritos, enviados, entregados, leídos, respondidos, fallidos), su costo estimado y a quién llegó cada envío, como los muestra la página Campañas. Piden `campaigns:read`, un alcance de lectura nuevo que se concede sólo si se marca (en una clave de API nueva y al conectar por OAuth es una casilla desmarcada, como una escritura), y una credencial con un miembro detrás: un miembro que sólo ve sus contactos recibe sólo esos destinatarios. Ya están en el Asistente; por MCP y REST se publican cuando el servidor tenga configurada la llave interna de la webapp (antes de eso no aparecen en la lista de herramientas). Una clave de API o una conexión OAuth existente no lo tiene: hay que crear una clave nueva que lo marque, o volver a conectar marcándolo. Para saber si un envío se entregó, `broadcast_status` separa lo aceptado de lo entregado. Ver [MCP](/mcp).

## 2026-11-13 — Probar un agente

`test_agent` (`agents:write`) corre un turno de un agente en una conversación de prueba y devuelve su respuesta, como el Playground de la app. El turno sólo tiene las herramientas de lectura del agente, así que no agenda, no deriva, no avisa a nadie ni manda nada; devuelve el `conversationId` para seguir la prueba. Un espacio de trabajo corre como máximo 60 turnos de prueba por hora. Ya está en el asistente de la app y llega a MCP y REST cuando se habilite en esos servidores. Ver [MCP](/mcp).

## 2026-11-13 — Qué puedes hacer por MCP y con el Asistente

Una página nueva muestra, área por área (conversaciones, CRM, agenda, cotizaciones, tickets, campañas, automatizaciones, agentes, videollamadas, llamadas, reportes y espacio de trabajo), qué puede hacer tu IA por MCP y qué hace el Asistente dentro de la app, y qué acciones van en dos pasos por MCP o con tarjeta de aprobación en el Asistente. Se genera de las mismas acciones que usan los dos, así que se mantiene al día sola. Ver [Qué puedes hacer](/mcp/capabilities).

## 2026-11-13 — Mover tickets y editar sus tipos

`prepare_ticket_update` cambia el estado, la prioridad, el título, el motivo, la resolución, quién atiende un ticket o los campos de su tipo. Va en dos pasos, porque marcar un ticket resuelto le avisa al cliente: la vista previa dice qué cambia y si se le avisará, y el `confirmToken` se canjea con `confirm_action` (por REST, `POST /v1/actions/tickets/update/confirm`). `create_ticket_type` y `update_ticket_type` agregan y cambian los tipos de ticket en un paso. Las tres piden `tickets:write`. Ya funcionan en el asistente, que las propone como una tarjeta; llegan a MCP y REST en cuanto se habiliten en esos servidores. Ver [MCP](/mcp).

## 2026-11-13 — Zona horaria e invitaciones por MCP y REST

Cambiar la zona horaria del espacio va en dos pasos: `prepare_set_workspace_timezone` (`workspace:write`) muestra la zona actual y la nueva, y cuántos tipos de cita, reglas de horario, descansos y bloqueos tienen zona propia; luego `confirm_action` (por REST, la ruta `…/confirm`) hace el cambio, una sola vez. Todos los horarios que se ofrecen a tus clientes pasan a la zona nueva, y esas filas también. Acepta un nombre IANA estricto como `America/Mexico_City` (`INVALID_TIMEZONE` si no). `revoke_member_invite` (`members:write`) cancela una invitación pendiente sin mandarle correo a nadie. `workspace:write` es nuevo y llega desmarcado al conectar; poner el logo del espacio con él llega a MCP y REST en una entrega posterior. Ver [MCP](/mcp).

## 2026-11-13 — Editar notas y tareas por MCP y REST

`crm_edit_note` cambia el texto de una nota del perfil de un contacto (si la nota se publicó en una conversación, cambia ahí también). `crm_update_task` edita, completa, reabre o reasigna una de tus tareas de seguimiento: sólo quien la creó o quien la tiene asignada puede cambiarla. Las dos piden `crm:write`, van en un paso y, como las demás escrituras del CRM, están apagadas hasta que se activan para tu espacio de trabajo. Borrar una nota o una tarea sigue siendo desde la app. Ver [MCP](/mcp).

## 2026-11-13 — Espacios y sus bloqueos por MCP y REST

`list_spaces` y `list_space_blocks` (`scheduling:read`) leen los espacios donde se agendan citas y el tiempo en que no se pueden agendar; `create_space`, `update_space`, `create_space_block`, `update_space_block` y `delete_space_block` (`scheduling:write`) los cambian, con las mismas reglas que la página de Calendario. Un espacio se sigue eliminando en esa página. No le avisan a nadie, así que van en un paso. Ver [MCP](/mcp).

## 2026-11-13 — Campañas por MCP y REST

`list_campaigns`, `get_campaign` y `list_campaign_recipients` leen las campañas de WhatsApp del espacio de trabajo con sus números (inscritos, enviados, entregados, leídos, respondidos, fallidos), su costo estimado y a quién llegó cada envío, como los muestra la página Campañas. Piden `campaigns:read`, un alcance de lectura nuevo que se concede sólo si se marca (en una clave de API nueva y al conectar por OAuth es una casilla desmarcada, como una escritura), y una credencial con un miembro detrás: un miembro que sólo ve sus contactos recibe sólo esos destinatarios. Ya están en el Asistente; por MCP y REST se publican cuando el servidor tenga configurada la llave interna de la webapp (antes de eso no aparecen en la lista de herramientas). Una clave de API o una conexión OAuth existente no lo tiene: hay que crear una clave nueva que lo marque, o volver a conectar marcándolo. Para saber si un envío se entregó, `broadcast_status` separa lo aceptado de lo entregado. Ver [MCP](/mcp).

## 2026-11-13 — Editar contactos por MCP y REST

`contact_update` cambia el nombre, el teléfono, el correo, la relación (sólo de un contacto sin conversación), la calidad del lead (`none`, `qualified`, `discarded`), el estado del lead (activo, inactivo temporal o definitivo, con su motivo) y los observadores de un contacto. `contact_assign_advisor` le pone o le quita el asesor, y al asesor nuevo se le avisa. Las dos piden `contacts:write`, van en un paso y, como las demás escrituras del CRM, están apagadas hasta que se activan para tu espacio de trabajo. Marcar a un lead con ⭐ sigue siendo desde la app, porque envía la conversión a tus cuentas de anuncios. Ver [MCP](/mcp).

## 2026-11-13 — La matriz de notificaciones por MCP y REST

`update_notification_matrix` (`notifications:write`) cambia qué avisos reciben los administradores y los miembros, por correo y push, y cuánto antes de una cita sale su recordatorio; es la página Configuración → Notificaciones, alertas del embudo incluidas. `notifications:write` es nuevo y llega desmarcado al conectar. Las herramientas de los comandos del menú ⌘K del propio miembro (`*_operator_command`, con el nuevo `commands:write`) ya están en el asistente de la app y llegan a MCP y REST en una entrega posterior. Ver [MCP](/mcp).

## 2026-11-13 — Las versiones de un agente por MCP y REST

`list_agent_versions` (`agents:read`) lee las versiones guardadas de un agente y cuál sirve cada canal. `rename_agent_version`, `restore_agent_version` y `publish_agent_version` (`agents:write`) cambian el título de una, regresan el borrador a una y publican una en un canal donde el agente ya está. No le escriben a nadie, así que van en un paso; publicar nunca conecta un canal. Ver [MCP](/mcp).

## 2026-11-13 — Crear y cambiar tipos de cita

`create_appointment_type` y `update_appointment_type`, con `scheduling:write`, corren la misma escritura que la página de Calendario; `isEnabled: false` deja de ofrecer un tipo, y eliminarlo se sigue haciendo en la página de Calendario. No le avisan a nadie, así que van en un paso. Ya están en el asistente de la app; en MCP y REST todavía no aparecen, y llegan en cuanto la plataforma termine de habilitarlas. Ver [MCP](/mcp).

## 2026-11-13 — Contratos de cotización por MCP y REST

`list_contract_templates` y `get_quote_contract` (`quotes:read`) leen las plantillas de contrato y el contrato de una cotización; `create_quote_contract` y `update_quote_contract` (`quotes:write`) lo crean en borrador y llenan sus variables, sin enviarle nada a nadie. Enviarlo le llega al cliente, así que va en dos pasos: `prepare_quote_contract_send` (`quote_sends:write`) responde una vista previa y un `confirmToken`, y `confirm_action` (por REST, la ruta `…/confirm`) lo envía una sola vez. Todo es sólo para el asesor de la cotización y pide un miembro detrás de la credencial. El envío llega a MCP y REST cuando se habilite en esos servidores; hasta entonces no aparece en `tools/list` ni en `/openapi.json`. Ver [MCP](/mcp).

## 2026-11-13 — Duplicar una cotización por MCP y REST

`duplicate_quote` (`quotes:write`) copia una cotización que puedes ver como un borrador nuevo tuyo, igual que «Duplicar» en la lista: mismas líneas, descuento, plan de pagos, contacto y moneda, con folio nuevo; la unidad se conserva mientras se pueda cotizar, y `unitDropped` dice cuándo no. `get_quote_pdf_link` (`quotes:read`), un link de 15 minutos al PDF de la cotización (el mismo documento que «Descargar PDF», borradores incluidos), ya está en el asistente y llega a MCP y REST cuando se habilite en esos servidores; hasta entonces no aparece en `tools/list` ni en `/openapi.json`. Las dos piden un miembro detrás de la credencial. Ver [MCP](/mcp).

## 2026-11-13 — Tickets en el asistente, y después por MCP y REST

Seis herramientas nuevas llegan a la mesa de soporte. Ya funcionan en el asistente y llegan a MCP y REST en cuanto se habiliten en esos servidores; mientras tanto no aparecen en `tools/list` ni en `/openapi.json`. `list_tickets`, `get_ticket` y `list_ticket_types` leen con `tickets:read`; `create_ticket`, `claim_ticket` y `add_ticket_note` escriben con `tickets:write`. Los dos son alcances nuevos que OAuth ofrece como casillas desmarcadas, y una llave de API nueva sólo lleva `tickets:read` si se pide por nombre. Aplican las reglas de la mesa de la app: qué ve cada miembro, los permisos de crear y asignar, los campos obligatorios del tipo y un solo ticket vivo por contacto y tipo. Ver [MCP](/mcp).

## 2026-11-13 — Tipos de cita por MCP y REST

`list_appointment_types` y `get_appointment_type_schedule` (`scheduling:read`) leen el equipo, los descansos y el horario semanal de un tipo de cita; seis escrituras con `scheduling:write` los cambian. No le avisan a nadie, así que van en un paso. Ver [MCP](/mcp).

## 2026-11-12 — Automatizaciones de comentarios por MCP y REST

Siete herramientas nuevas leen y cambian las reglas que contestan los comentarios de Instagram y Facebook. `list_comment_automations` y `list_comment_automation_activity` leen con `integrations:read`; `create_comment_automation`, `update_comment_automation`, `pause_comment_automation` y `duplicate_comment_automation` escriben con `automations:write`, un alcance nuevo que se concede por OAuth como casilla desmarcada. Una regla nace como borrador, y activarla va en dos pasos: `prepare_comment_automation_activation` y luego `confirm_action` (por REST, la ruta `…/confirm`). Ver [MCP](/mcp).

## 2026-11-12 — Reaccionar, reenviar y abrir conversaciones por MCP y REST

Tres acciones nuevas, en dos pasos: `conversation_react` reacciona a un mensaje con un emoji (o quita la reacción), `conversation_forward` reenvía un mensaje a hasta 10 conversaciones (`messages:write` las dos), y `start_conversation` le escribe con una plantilla aprobada a un número o a un contacto que quizá nunca te escribió (`broadcast:write`). Cada una responde una vista previa y un `confirmToken`, que se canjea con `confirm_action` en MCP o en la ruta `…/confirm` en REST. Ver [Abrir una conversación con un número nuevo](/guides/two-step-actions#abrir-una-conversación-con-un-número-nuevo).

## 2026-11-12 — Responder a un cliente por MCP y REST

Dos acciones nuevas, en dos pasos como las demás que llegan a alguien: `conversation_reply` responde con texto libre al cliente de una conversación, dentro de la ventana del canal (24 h en WhatsApp, 7 días en Instagram y Messenger), y `conversation_send_template` le envía una plantilla aprobada de WhatsApp. Las dos responden una vista previa y un `confirmToken`, que se canjea con `confirm_action` en MCP o en la ruta `…/confirm` en REST. Piden el alcance nuevo `messages:write`, una casilla desmarcada al conectar. Ver [Responder a un cliente en una conversación](/guides/two-step-actions#responder-a-un-cliente-en-una-conversación).

## 2026-11-12 — Bloqueos de calendario por MCP y REST

`list_calendar_blocks` (`scheduling:read`) y `create_calendar_block`, `update_calendar_block`, `delete_calendar_block` (`scheduling:write`) leen y cambian el tiempo en que un asesor, un tipo de cita o todo el espacio de trabajo no se agenda. No le avisan a nadie, así que van en un paso. Ver [MCP](/mcp).

## 2026-11-12 — Plantillas, difusiones, invitaciones y números por MCP y REST

Cuatro acciones nuevas, todas en dos pasos (vista previa y `confirmToken`, que se canjea con `confirm_action` en MCP o en la ruta `…/confirm` en REST): enviar una plantilla de WhatsApp a revisión de Meta (`prepare_message_template_submission`, `templates:write`), mandar una plantilla aprobada a hasta 1,000 contactos elegidos con un filtro (`prepare_template_broadcast`, `broadcast:write`) y detener ese envío (`cancel_template_broadcast`), invitar a un compañero (`prepare_member_invite`, `members:write`) y pedir un número de teléfono (`prepare_phone_number_request`, `agents:write`). `list_voice_catalog`, las voces que acepta `update_voice_calling_config`, ya está en MCP y REST. `templates:write`, `broadcast:write` y `members:write` ahora se pueden conceder por OAuth, como casillas desmarcadas. Ver [Plantillas, difusiones, invitaciones y números en dos pasos](/guides/two-step-actions).

## 2026-11-12 — Confirmar o rechazar una solicitud de cita

`accept_appointment_request` y `decline_appointment_request`, con `scheduling:write`, responden una cita que espera la aprobación del equipo. No le mandan nada al cliente, pero disparan el webhook `appointment.updated` a tus integraciones y un rechazo no se puede deshacer, así que van en dos pasos: vista previa y `confirmToken`, y `confirm_action` (por REST, la ruta `…/confirm`) hace el cambio. Ver [MCP](/mcp).

## 2026-11-12 — Citas por MCP y REST

Cuatro herramientas nuevas, con `scheduling:write`, agendan, mueven, cancelan y editan citas: `book_appointment`, `reschedule_appointment`, `cancel_appointment` y `update_appointment`. Cada una le avisa al cliente, así que van en dos pasos: responden una vista previa y un `confirmToken`, y `confirm_action` hace el cambio (por REST, la ruta `…/confirm` de cada una). Por eso `confirm_action` ya no pide un alcance fijo: pide el de la acción del token, y sólo la ve una conexión con `quote_sends:write` o `scheduling:write`. Ver [MCP](/mcp).

## 2026-11-12 — Estados de conversación y bloquear contactos, por MCP y por la API

`chat_status_create`, `chat_status_update` y `chat_status_reorder` crean, editan y ordenan los estados propios de tus conversaciones (pide el permiso de ajustes del espacio de trabajo, igual que en la app; los estados de fábrica no se editan). `contact_set_blocked` bloquea o desbloquea a un contacto: el agente deja de contestarle y sale de Chats, sin enviarle nada. Necesitan `conversations:write`. Ver [MCP](/mcp).

## 2026-11-12 — Notas internas y mensajes rápidos, por MCP y por la API

Siete herramientas nuevas: `conversation_list_notes`, `conversation_add_note`, `conversation_edit_note` y `conversation_delete_note` para las notas internas de una conversación (sólo las ve el equipo, nunca el cliente), y `list_quick_replies`, `quick_reply_create` y `quick_reply_set_hidden` para tus mensajes rápidos. Las notas siguen las mismas reglas que la bandeja: un miembro sin «ver todas las conversaciones» sólo llega a las de sus contactos, y borrar una nota pide `note:delete`. Los mensajes rápidos son de quien llama, no del espacio de trabajo. Ver [MCP](/mcp).

## 2026-11-12 — Las acciones de la bandeja, por MCP y por la API

Ocho herramientas nuevas hacen desde MCP o la API REST lo que hace la bandeja con una conversación: `conversation_assign` (a un miembro, por nombre, correo o id) y `conversation_unassign`, `conversation_resolve`, `conversation_reopen`, `conversation_escalate`, `conversation_set_agent` (pausar el agente de IA por unos minutos o reanudarlo), `conversation_mark_read` (leída o no leída) y `conversation_set_observers`. Dejan el mismo rastro que la bandeja: la línea de tiempo del contacto, la actividad y los webhooks `conversation.*`. Necesitan el permiso `conversations:write`, que se marca aparte al conectar, y una persona del equipo detrás de la llamada. Pausar el agente pide además `chat:reply` y cambiar observadores `contact:collaborator_manage`, igual que en la app. Ver [MCP](/mcp).

## 2026-11-12 — CRM, cotizaciones y reportes por MCP

El servidor MCP suma once herramientas que antes sólo tenían el asistente de la app o la API REST:

- **Contactos y CRM:** `create_contact` (`contacts:write`) y `crm_tag_customer`, `crm_untag_customer`, `crm_create_note`, `crm_create_task` y `crm_update_funnel_stage` (`crm:write`). OAuth ya ofrece los dos alcances, como casillas opcionales. Las cinco de CRM vienen apagadas en cada espacio de trabajo y todavía no se encienden desde la app (escríbele al soporte de watsi); mientras tanto responden `403 CRM_WRITE_DISABLED`.
- **Cotizaciones:** `set_quote_status`, que cancela un borrador o una cotización enviada.
- **Reportes:** `conversations_report`, `broadcast_status`, `activation_progress` y `notification_settings`.

En la API REST, `POST /v1/actions/crm/notes` y `POST /v1/actions/crm/tasks` ya están montadas, detrás del mismo interruptor por espacio de trabajo. Ver [MCP](/mcp).

## 2026-11-12 — `confirm_action`: una sola herramienta para confirmar

La herramienta MCP nueva `confirm_action` canjea el `confirmToken` de cualquier acción que se hace en dos pasos y ejecuta lo que preparó. Hoy es el envío de cotizaciones: `send_quote` → `confirm_action` hace lo mismo que `send_quote` → `confirm_quote_send`, que sigue funcionando. Las próximas acciones que lleguen a un cliente se confirmarán con esta misma herramienta. Ver [MCP](/mcp).

## 2026-11-12 — Un prompt para configurar el MCP desde ChatGPT o Claude

Arriba de la página de [MCP](/mcp) hay un prompt para copiar y pegar en ChatGPT o Claude: el asistente agrega watsi como conector (él mismo en Claude Code, Cursor o Codex) y se abre tu navegador para que inicies sesión en watsi, sin clave de API. Al final comprueba la conexión. Además, **Cursor ya se conecta por OAuth**: antes el registro de su conector se rechazaba.

## 2026-11-12 — `workspace_overview`: el total del espacio de trabajo ya no se filtra por miembro

`workspaceTotalConversations` es ahora siempre el total histórico del espacio de trabajo **completo**, también cuando mandas `assignedTo`. El total histórico de ese miembro viene en el campo nuevo `assignedTotalConversations` (`null` sin `assignedTo`). Antes, con `assignedTo`, `workspaceTotalConversations` traía sólo las conversaciones del miembro: si tu integración leía ahí el total del miembro, léelo ahora de `assignedTotalConversations`. Las cifras del periodo (`current`, `previous`, `deltas`) siguen filtradas por el miembro igual que antes.

## 2026-11-11 — `get_conversation` acepta el id de un contacto

`get_conversation` (y su ruta REST) acepta ahora el id del **contacto** además del de la conversación, y abre su conversación más reciente: la misma que abre `/chats/<id_del_contacto>` en la bandeja. Un id de conversación se lee igual que antes.

## 2026-11-11 — `crm/tags` ya no pide `companyId`

`POST /v1/actions/crm/tags` y `crm/tags/remove` aceptan el cuerpo sin `companyId`. El campo sigue siendo válido y se sigue ignorando: el espacio de trabajo es siempre el de la clave, así que una integración que ya lo manda no cambia. Ver [Autenticación](/guides/authentication).

## 2026-11-11 — El push del teléfono queda para cuatro avisos

Por omisión, la app sólo manda push de **Tus tareas**, **Recordatorios de citas**, **Cita agendada** y el aviso nuevo **El agente necesita ayuda**, que llega cuando el agente pasa una conversación a una persona. Los demás avisos, como **Nuevo prospecto asignado**, siguen en la campana y en el correo. Un administrador puede volver a encender el push de cualquiera. Ver [Notificaciones](/team/notifications).

## 2026-11-10 — Las escrituras de configuración del agente ya se piden desde tu propia pantalla de claves

`agents:write`, `knowledge:write` y `scheduling:write` son casillas opcionales en **Configuración › Desarrollador**: ya no hace falta pedirle una clave al equipo de watsi para que tu integración cree agentes, actualice su configuración, agregue documentos de conocimiento o defina los horarios del equipo por MCP y REST. Siguen apagadas por omisión, y la pantalla de consentimiento de OAuth ya las ofrecía. `lifecycle:write` sigue siendo el único alcance que sólo emite watsi. Ver [Autenticación](/guides/authentication) y [MCP](/mcp).

## 2026-11-07 — El plan de una cotización se sigue pago por pago

En el link y el PDF, cada pago dice cuánto queda por pagar, y un apartado que el esquema le resta al enganche sale dentro del enganche. Un esquema sin mensualidades ya suma exactamente el precio de venta. Ver [Cotizaciones](/quotes/overview).

## 2026-11-06 — Anuncios de un cliente por MCP y REST

Cinco acciones nuevas, sólo con llave de API y los scopes `lifecycle:read` y `lifecycle:write`, suben imágenes y videos a la sección Ads del ciclo de vida de un cliente: `lifecycle_ads_list`, `lifecycle_ads_create_folder`, `lifecycle_ads_create_upload`, `lifecycle_ads_finalize_upload` y `lifecycle_ads_import_url`. Sólo suben: ninguna envía nada al cliente.

## 2026-11-05 — Las guías del producto ya describen lo que watsi hace hoy

Comparamos estas guías con el producto en producción y corregimos lo que no coincidía. El producto no cambió por esto.

- **Asistente:** no agrega etiquetas ni mueve contactos de etapa, y no cancela tu plan de watsi. En la app móvil está en la pestaña **Asistente**. Ver [Asistente](/insights/assistant).
- **Roles:** no hay un paso de alcance de datos; lo que ve cada rol lo decide la casilla **Ver todas las conversaciones**. Ver [Miembros y roles](/team/members-and-roles).
- **Observadores y avisos:** un observador sí recibe **Nuevo mensaje en chat manual**, y **Tu agenda de la mañana** y **¿Cómo te fue en la cita?** están en piloto. Ver [Asignar y observadores](/chats/assign-and-observers) y [Notificaciones](/team/notifications).
- **Pausa del agente:** contestar desde watsi no pausa al agente por defecto, y la pausa por contestar desde tu teléfono en Coexistencia no termina antes de tiempo salvo que el chat ya esté clasificado como de un cliente. Ver [Pausar al agente](/chats/pause-agent).
- **Idioma y espera:** por defecto el agente responde en un solo idioma, y agrupar los mensajes seguidos en una sola respuesta depende de una función por espacio de trabajo. Ver [Personalidad e idioma](/agent/personality-and-language).
- **Cómo empezar:** hay dos caminos según cómo te registraste: la configuración guiada o los tres pasos con el equipo de watsi. Ver [Activa tu cuenta](/getting-started/activate-account).
- **Agenda:** el permiso de Meet abre las salas, no crea los enlaces, y el horario personal de un miembro no limita sus citas. Ver [Google Calendar y Meet](/scheduling/google-calendar-meet) y [Disponibilidad del equipo](/scheduling/team-availability).
- **Uso y saldo:** **Uso** está en el menú de tu cuenta, y al agotar tu saldo o tu plan el agente puede dejar de responder. Ver [Uso y recargas](/billing/usage-and-top-ups).
- **Coexistencia:** desconectar el número desde tu celular y volver a conectarlo repite la importación de historial. Ver [Importar tu historial](/whatsapp/import-history).
- **App móvil:** en **Anuncios** deslizas entre **Anuncios** y **Propiedades**. Ver [App móvil](/getting-started/mobile-app).
- **Este registro:** dos fechas pasan al día en que la función llegó a producción: OAuth para conectores web (decía 2026-10-12) y cotizaciones por API y MCP (decía 2026-10-31).

## 2026-11-05 — `workspace_settings` lista los estados y `get_quote` devuelve el enlace

- `workspace_settings` agrega `conversationStatuses`: los estados que acepta `conversation_set_status`, con su id y su nombre.
- `get_quote` por MCP y REST ahora devuelve `publicUrl` en una cotización ya enviada. Antes respondía `null` aunque el enlace existiera.

## 2026-11-05 — `conversation_set_status` ya aplica un estado por nombre

- Al pasar sólo `statusName`, la acción quitaba el estado de la conversación y respondía `cleared: true`, sin importar el nombre. Ahora aplica ese estado, y un nombre que no existe responde `STATUS_NOT_FOUND` sin tocar la conversación.
- Pasar `statusId: null`, u omitir los dos campos, sigue quitando el estado.

## 2026-11-05 — El asistente de reuniones se activa en todos los espacios de trabajo

- El asistente de reuniones ahora entra por defecto a las videollamadas de Google Meet de todos los espacios de trabajo. Lo apagas, o lo limitas a ciertas reuniones, desde el engrane de **Videollamadas**.
- Las herramientas de reuniones y la página **Videollamadas** están disponibles en todos los espacios de trabajo.

## 2026-11-04 — Las cotizaciones por API y MCP respetan tus roles

- `list_quotes` y `get_quote` (`quotes/list`, `quotes/get`) ahora siguen la matriz de roles de tu espacio de trabajo. Antes usaban los permisos por defecto del rol: un admin al que le quitaste administrar cotizaciones seguía leyéndolas todas, y un miembro al que se lo diste recibía `NOT_FOUND`.
- Quien pierde ese permiso ahora ve sólo sus propias cotizaciones por API y MCP. Si no has cambiado la matriz, nada cambia.

## 2026-11-04 — Los enlaces de factura ya abren

- `workspace_payment_history` (`billing/payment-history`) devuelve en `pdfUrl` y `xmlUrl` un enlace de descarga de watsi. Antes apuntaba a una URL del proveedor de facturación que respondía 401.
- El enlace abre para una persona con sesión en watsi y permiso de facturación en ese espacio de trabajo. No es una URL pública: si la pasas a otra persona, tendrá que iniciar sesión y tener ese permiso.
- `pdfUrl` y `xmlUrl` siguen siendo `null` cuando la factura no tiene documento.

## 2026-11-04 — Videollamadas: las llamadas de todo el espacio de trabajo

- Nueva página **Videollamadas** en el panel, para los espacios de trabajo que tienen el asistente de reuniones: cada llamada con su cliente, sus filtros, su resumen, su transcripción y un enlace al chat, más las citas próximas con un interruptor para decidir si entra el asistente. Ver [Videollamadas](/scheduling/video-calls).

## 2026-11-04 — Videollamadas por API y MCP

- Nuevas herramientas MCP y rutas REST para las videollamadas: `search_meetings`, `get_meeting`, `get_meeting_summary`, `get_meeting_transcript`, `list_upcoming_meetings`, `get_meeting_assistant_settings`, `set_meeting_assistant` y `update_meeting_assistant_settings`. Guía: [Videollamadas por API y MCP](/guides/meetings-api).
- Nuevos alcances `meetings:read` y `meetings:write`. Toda conexión OAuth los pide, y una conexión existente tiene que volver a conectarse. Las herramientas sólo aparecen en un espacio de trabajo con el asistente de reuniones activado.
- Una clave de API nueva lleva `meetings:read` por defecto. Sólo responde en un espacio de trabajo con el asistente de reuniones activado.

## 2026-11-04 — Las herramientas de escritura funcionan desde Claude y ChatGPT

- Las conexiones de Claude y ChatGPT ya pueden activar herramientas de escritura: la pantalla de consentimiento muestra `agents:write`, `knowledge:write`, `scheduling:write`, `conversations:write`, `quotes:write` y `quote_sends:write` como casillas sin marcar, y la conexión sigue siendo de sólo lectura si no marcas ninguna. Una conexión existente conserva lo que tiene hasta que vuelvas a conectar.
- OAuth deja de ofrecer los alcances que ninguna herramienta MCP usa: `shopify:read`, `plans:read`, `leads:write`, `contacts:write`, `crm:write`, `shopify:write`, `plans:write`, `templates:write`, `broadcast:write` y `members:write`. Las claves de API no cambian.
- Las lecturas de citas `list_appointments` y `appointment_stats` ya aparecen en esta documentación.

## 2026-11-04 — Las herramientas lifecycle son solo para claves de API

- Las herramientas `lifecycle_*` y los alcances `lifecycle:read` / `lifecycle:write` dejan de aparecer por OAuth: las conexiones de Claude y ChatGPT ni los piden ni listan estas herramientas. Las claves de API no cambian. Un cliente que aún pida estos alcances sigue conectándose con los demás.

## 2026-11-04 — Cotizaciones por API y MCP

- Nuevas herramientas MCP y rutas REST para el Cotizador: `list_quotes`, `get_quote`, `list_quotable_properties`, `get_quoting_setup`, `create_quote_draft` y `update_quote_draft`, más `quotes/status` (sólo REST) para cancelar una cotización.
- Enviar al cliente es en dos pasos: `send_quote` responde una vista previa y un `confirmToken` sin enviar nada, y `confirm_quote_send` envía cuando la persona confirmó. Guía: [Cotizaciones por API y MCP](/guides/quotes-api).
- Nuevos alcances `quotes:read`, `quotes:write` y `quote_sends:write`.

## 2026-11-02 — Calendarios personales de los asesores

- Cada asesor puede conectar sus otros calendarios de Google desde su disponibilidad, y sus horas ocupadas dejan de ofrecerse para agendar. Ver [Disponibilidad del equipo](/scheduling/team-availability).

## 2026-10-31 — Configuración del cotizador

- La configuración del cotizador se mudó de los ajustes del espacio de trabajo a [Cotizador → Configuración](/quotes/overview), con dos secciones nuevas: Cobranza y Alertas de crédito. Los enlaces anteriores redirigen ahí.

## 2026-10-31 — Correcciones en las lecturas de citas, consumo y perfilado

- `appointments/list` y `list_appointments`: `total` cuenta todas las citas que coinciden y no sólo la página, y una fecha `YYYY-MM-DD` en `startDate`/`endDate` se lee como día del calendario del espacio de trabajo (antes era medianoche UTC). Versión 1.2.1
- `billing/credit-usage` y `workspace_credit_usage`: la ventana son los N días completos que terminan hoy en la zona horaria del espacio de trabajo, y la serie diaria agrupa por ese mismo calendario, igual que los demás reportes. Versión 1.1.1
- `analytics/profiling-report` y `profiling_report` cuentan los valores que el agente captura, que se guardan con el nombre del campo; antes devolvían 0 para todos los campos

## 2026-10-31 — Correcciones en la API REST

- `resources/list` y `resources/get` ya responden: su esquema ahora describe los campos reales de un recurso (versión 2.0.0)
- `analytics/profiling-report` ya responde con los campos de perfilado del agente, y un campo que no existe devuelve un 404 con su código en vez de un error 500
- `appointments/list` y `appointments/stats` dejan de anunciarse en `/openapi.json` mientras no estén disponibles, en lugar de responder con un error 500
- `/openapi.json` anuncia `https://api.watsi.ai` como servidor

## 2026-10-30 — Nueva documentación

- Sitio nuevo, en español y en inglés, con una página en Markdown por guía (`<página>.md`) y `llms.txt` para asistentes de IA.
- La [lista de rutas](/api/overview#todas-las-rutas), los [alcances](/guides/authentication#alcances), la [paginación por ruta](/guides/pagination), las [herramientas MCP](/mcp#herramientas) y el [catálogo de eventos](/webhooks/events) se generan del código al construir el sitio, así que no pueden quedarse atrás.
- Correcciones en webhooks: la firma es `sha256=<hex>` (el ejemplo anterior rechazaba toda entrega real), el cuerpo es el evento sin sobre, son 4 intentos con esperas de ~1, ~2 y ~4 minutos, y los endpoints los registra el equipo de watsi.
- Nuevas páginas de [panorama](/api/overview) e [idempotencia](/api/idempotency).

## 2026-10-30 — Adjuntar archivos desde MCP y la API

- Nuevas herramientas MCP y rutas REST `attachment_create_upload`, `attachment_finalize` y `attachment_import_url` para subir archivos a Recursos, a las fotos, el plano y el brochure de una propiedad, y a la base de conocimiento.
- Desde un chat de IA basta un enlace público `https://`; desde un cliente que hace peticiones HTTP, una URL firmada de subida.
- `add_agent_knowledge` ahora sólo descarga enlaces públicos `https://` y rechaza las direcciones privadas o locales.

## 2026-10-29 — API REST de acciones en producción

- La API de acciones (`/v1/actions/<dominio>/<verbo>`) llega a producción y es la que recomendamos para integraciones nuevas. Es la misma superficie que el servidor MCP: cada acción es una ruta REST y una herramienta MCP con el mismo alcance.

## 2026-10-17 — OAuth en producción para Claude.ai y ChatGPT

- El inicio de sesión con OAuth 2.1 para conectores web funciona en producción.

## 2026-10-14 — Estado de una conversación

- `POST /v1/actions/conversations/status` y la herramienta MCP `conversation_set_status` ponen o quitan el estado propio de tu espacio de trabajo a una conversación. Nuevo alcance `conversations:write`.

## 2026-10-13 — Límite del servidor MCP por credencial

- El límite de tasa del servidor MCP se cuenta por credencial y ya no por IP, así que los clientes que comparten salida (como Claude.ai) no se agotan el cupo entre ellos.

## 2026-08-25 — Llamadas telefónicas

- Lecturas `voice/config`, `voice/calls` y `voice/diagnose` (herramientas `voice_calling_config`, `list_voice_calls`, `diagnose_phone_calling`) y la escritura `update_voice_calling_config`.

## 2026-08-23 — Etiquetas de contactos

- `POST /v1/actions/crm/tags` y `POST /v1/actions/crm/tags/remove` (alcance `crm:write`).

## 2026-08-05 — Lecturas del espacio de trabajo y analíticas

- Estado de facturación, consumo de créditos, ajustes e integraciones del espacio de trabajo.
- Desgloses de escalamientos, estadísticas de citas y rendimiento por agente.
- 2026-08-04: historial de pagos (`billing/payment-history`).

## 2026-07-30 — Plantillas y búsqueda de mensajes

- `templates/search` (`find_message_templates`): las plantillas de WhatsApp y su estado de aprobación. Nuevo alcance `templates:read`.
- `messages/search` (`search_messages`): búsqueda de texto completo en los mensajes.

## 2026-07-21 — Idempotencia y escrituras por OAuth

- `Idempotency-Key` en las escrituras: un reintento con la misma clave y el mismo cuerpo devuelve la respuesta original, aunque llegue a otra instancia del servidor. La misma clave con otro cuerpo responde `409 IDEMPOTENCY_KEY_REUSED`.
- Las conexiones OAuth pueden pedir alcances de escritura; cada uno aparece desmarcado en la pantalla de consentimiento.
- 2026-07-20: herramientas para configurar el agente (`create_agent`, `update_agent_config`, conocimiento, asignación y horarios), con alcances que sólo emite watsi.

## 2026-06-19 — OAuth 2.1 para el servidor MCP

- watsi.ai como servidor de autorización, con registro dinámico de clientes, para conectar clientes web sin pegar una clave.

## 2026-06-18 — Crear contactos por API

- `POST /v1/actions/contacts/create`: crea o actualiza un contacto por teléfono, `wa_id` o correo. Alcance `contacts:write`, que puedes darte desde la pantalla de claves.

## 2026-06 — Servidor MCP

- `https://mcp.watsi.ai/mcp`, por Streamable HTTP: contactos, conversaciones, citas, analíticas y la biblioteca de recursos, con la misma clave de API.

## 2026-05-01 — Webhooks de acciones del agente

- Eventos `action.succeeded` y `action.failed`, más variantes por herramienta para agendar, reagendar y cancelar.

## 2025 — API anterior (`/api/v1`)

> **Note**

Estas entradas describen la API anterior (`/api/v1`) y se conservan como historial. Para integraciones nuevas usa la API de acciones (`/v1/actions`).

### 2025-04-28 — Renovación del sitio de documentación pública

- Lanzamiento de un nuevo sitio de documentación con navegación lateral, guía de inicio rápido y guías.
- Nuevas guías de autenticación, paginación y filtros, e integración de calendario/reservas.
- Documentación de webhooks con catálogo de eventos, guía de firma y tutorial.

### 2025-04-15 — Especificación OpenAPI y validación de CI

- Se publicó la especificación OpenAPI 3.1 en `/spec.json`, con una referencia interactiva impulsada por Scalar.

### 2025-03-20 — API de etiquetas

- Endpoints para crear, listar y eliminar etiquetas del espacio de trabajo, y para asignarlas a contactos.

### 2025-03-05 — API de plantillas de WhatsApp

- Lista, lee y administra plantillas de mensajes de WhatsApp, filtradas por estado de aprobación.

### 2025-02-15 — API de clientes

- Endpoints para listar, leer, crear y actualizar contactos, con búsqueda por nombre o teléfono.

### 2025-01-30 — Lanzamiento inicial de la API pública

- API REST con autenticación mediante token Bearer: lista y filtra conversaciones, envía mensajes de texto dentro de la ventana de 24 horas y lista los miembros del equipo.
