---
title: "Actualizar canal parcialmente"
method: PATCH
path: "/v1/channels/{channelId}"
tags: ["Channels"]
---

# Actualizar canal parcialmente

`PATCH /v1/channels/{channelId}`

Actualiza propiedades del canal (label/title, etc.). Los campos
protegidos (`_id`, `companyId`, `creationDate`) son ignorados
silenciosamente.

## Path parameters

- `channelId` string, required

## Request body

- object
  - `label` string
  - `title` string

## Response `200`

Canal parcialmente actualizado

- ChannelSite — Vista de un canal (sitio/integración) en el modelo omnichannel. El campo `id` es el identificador del canal (compatible con el `channelId` legacy = websiteId). Reemplazó a la respuesta legacy `{ id, title, url, company, enabled, integrations }` del backend anterior. El chatbot asociado se incluye embebido — usar su `id` para operar contra `/v1/chatbots/{chatbotId}`.
  - `id` string — ID del canal (== websiteId histórico).
  - `type` 'WEBSITE' | 'WHATSAPP_API' | 'WHATSAPP_BUSINESS' | 'FACEBOOK' | 'INSTAGRAM' — Tipo del canal/sitio. Ojo con el casing frente a `Channel` (el canal de una conversación): acá WhatsApp se distingue como `WHATSAPP_API` (WhatsApp Business API) o `WHATSAPP_BUSINESS`, mientras que `Channel` usa el valor genérico `WHATSAPP`.
  - `label` string — Nombre legible (título del sitio, número de WhatsApp, page de FB, etc.).
  - `connected` boolean — Indica si el canal está conectado y recibiendo mensajes.
  - `testChannelUrl` string, uri — URL para probar el chatbot en este canal.
  - `chatbot` ChatbotSummary — Resumen del chatbot devuelto cuando se incluye dentro de un canal.
    - `id` string — ID del chatbot.
    - `chatbotWithAi` boolean — True si alguna pregunta del flujo o el `globalFulfillment` apunta a un endpoint de IA (zordon).
    - `isMuted` boolean — True si el chatbot está silenciado (no responde mensajes).
    - `title` string — Título visible del chatbot.
    - `name` string — Nombre interno del chatbot.
    - `connectedChannels` integer — Cantidad de canales conectados a este chatbot.
  - `whatsappForm` boolean — Solo aplica a canales WhatsApp — indica si el formulario de configuración está activo.
  - `disconnectionRequested` boolean — Solo WhatsApp API — indica que se está procesando la desconexión.

---

[API](https://skmtc.net/cliengo/apis/cliengo-public-api.md) · [All operations](https://skmtc.net/cliengo/apis/cliengo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cliengo/cliengo-public-api/versions/94c7ba7d6a11/schema)