---
title: "Editar una línea de WhatsApp: su alias y el flujo que atiende lo que entra por ella"
method: PATCH
path: "/channels/{channelId}/whatsapp/lines/{lineId}"
tags: ["Channels"]
---

# Editar una línea de WhatsApp: su alias y el flujo que atiende lo que entra por ella

`PATCH /channels/{channelId}/whatsapp/lines/{lineId}`

## Request

- Base URL: `https://api.met.meteor.com.co/api/v1`
- URL: `https://api.met.meteor.com.co/api/v1/channels/{channelId}/whatsapp/lines/{lineId}`
- Auth: one of:
  - `bearer` (a scheme the document does not define)
  - HTTP bearer

Cambia el `alias` y/o el flujo de entrada (`flow_id`) de UNA línea. Los campos que no mandes no cambian.

**Qué flujo atiende un mensaje entrante**: el de la línea; si la línea no tiene, el de su cuenta de WhatsApp (WABA); si tampoco, el flujo principal del canal. `flow_id: null` quita el de la línea y la deja heredando. La respuesta trae `effective_flow_id` y `effective_flow_source` con el resultado de esa regla, igual que `GET /channels/{channelId}/config`. Las reglas de enrutamiento por palabra clave del canal, cuando coinciden, ganan sobre esto.

**A quién le aplica**: el flujo arranca para un contacto que todavía no tiene un Met asignado. Un contacto que ya conversa con un Met lo conserva, salvo que escriba por una línea cuyo flujo propio todavía no lo atendió: ahí se le reasigna una sola vez, y nunca si a ese Met lo asignó una persona desde el chat.

**El Met de una línea no se elige aquí**: lo decide el nodo Met del flujo vinculado. Para que una línea responda con otro Met, vincúlale un flujo que lo asigne. `primary_met_id` e `is_active` no se aceptan en este endpoint (responden `400`).

El flujo tiene que ser de tu workspace (`flow_not_found`), estar publicado (`flow_not_published`) y no estar archivado (`flow_archived`).

## Path parameters

- `channelId` string, required
- `lineId` string, required

## Request body

- UpdateWhatsappLineBindingDto
  - `alias` string, nullable: Nombre interno de la línea (lo ven tu equipo y la API, no el cliente final). `null` lo borra.
  - `flow_id` string, uuid, nullable: Flujo que atiende lo que entra por esta línea. Tiene que ser un flujo de tu workspace, publicado y no archivado. `null` quita el flujo propio: la línea vuelve a heredar, primero el flujo de su cuenta de WhatsApp (WABA) si la cuenta tiene uno y, si no, el flujo principal del canal. Omitirlo no cambia nada.

## Response `200`

- object: Sobre en el que viaja toda respuesta correcta de la API. El recurso está en `data`. Los SDKs oficiales lo desenvuelven por ti; un cliente hecho a mano tiene que leer `.data`.
  - `success` true, required: Siempre `true` en una respuesta 2xx.
  - `data` WhatsappLineBindingResponseDto, required
    - `alias` string, nullable, required
    - `effective_flow_id` string, nullable, required: El flujo que arranca un mensaje que entra por esta línea, con la misma regla que aplica el webhook: línea → cuenta → canal. `null` si la línea está apagada o si no hay flujo en ningún nivel.
    - `effective_flow_source` 'line' | 'account' | 'channel' | 'inactive', required: De dónde sale `effective_flow_id`. `inactive` = la línea está apagada.
    - `flow_id` string, nullable, required: Flujo PROPIO de la línea. `null` = hereda (ver `effective_flow_source`).
    - `is_active` boolean, required: Encendida en Meteor. Una línea apagada no atiende lo que entra por ella.
    - `sender_line_id` string, required: El `phone_number_id` de Meta: el mismo `sender_line_id` de `GET .../whatsapp/lines`.

## Other responses

- `400`: La request no es válida: un campo no pasa validación, falta un parámetro requerido o el recurso no admite la transición solicitada.
- `401`: API key ausente, inválida, revocada o expirada — o el workspace está bloqueado.
- `403`: La key está autenticada pero no puede ejecutar esta operación: scope faltante, capacidad deshabilitada, modo test restringido o recurso fuera de su cartera.
- `404`: El recurso no existe o no está disponible dentro del alcance de la key. No revela la existencia de recursos de otros tenants.
- `409`: La operación entra en conflicto con el estado actual o con un Idempotency-Key en uso. No reintentes con el mismo key y un body distinto.
- `429`: Se superó el límite por minuto de la key o la cuota del plan. Respeta `Retry-After`; el SDK ya reintenta solo.
- `500`: Error del servidor o del Met que ejecutaba. El SDK reintenta los 5xx con backoff.

---

[API](https://skmtc.dev/meteor/apis/met-public-api.md) · [All operations](https://skmtc.dev/meteor/apis/met-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meteor/apis/met-public-api/revisions/5d9ca294295c?raw)