---
title: "Listar canales con WhatsApp"
method: GET
path: "/v1/whatsapp"
tags: ["WhatsApp"]
---

# Listar canales con WhatsApp

`GET /v1/whatsapp`

Lista los canales vinculados al token que tienen capacidad WhatsApp HSM. Es el
endpoint de descubrimiento: el `id` de cada canal es el `channelId` que se usa en
el resto de operaciones `/v1/whatsapp/{channelId}/*`.

Cada canal viene enriquecido con:
- `provider`: proveedor HSM derivado del canal (`gupshup`, `meta_cloud`, o `null` si no tiene proveedor HSM).
- `hsmLineStatus`: estado de la línea — `active` (línea provisionada, lista para enviar), `null` (sin línea dada de alta), `error` (fallo transitorio al resolver ese canal). Solo enviar HSM cuando es `active`.

## Response `200`

Lista de canales con configuración WhatsApp

- WhatsAppChannel[]
  - `id` string — channelId a usar en `/v1/whatsapp/{channelId}/*`.
  - `title` string — Nombre del canal/sitio.
  - `type` string — Tipo de canal WhatsApp.
  - `whatsappNumber` string — Teléfono de la línea WhatsApp.
  - `isWhatsAppChat` boolean — Indica si el canal tiene chat de WhatsApp habilitado.
  - `provider` 'gupshup' | 'meta_cloud' | 'null', nullable — Proveedor HSM derivado del canal (`null` si no tiene proveedor HSM).
  - `hsmLineStatus` 'active' | 'error' | 'null', nullable — Estado de la línea: `active` (lista para enviar), `null` (sin línea dada de alta), `error` (fallo transitorio). Solo enviar HSM cuando es `active`.

---

[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/revisions/94c7ba7d6a11/schema)