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

# Plantillas de WhatsApp

> Las plantillas definen el mensaje con el que tu cobro llega al cliente por WhatsApp.

Cuando creas un cobro con teléfono, OnePay lo envía por WhatsApp usando una **plantilla** aprobada previamente por Meta. Por defecto elegimos la plantilla adecuada según la configuración de tu canal, pero puedes fijar una explícitamente con el campo `template_id` al crear el cobro.

## Estados

Meta debe aprobar cada plantilla antes de que pueda enviarse.

| Estado     | Descripción                                               |
| ---------- | --------------------------------------------------------- |
| `DRAFT`    | Creada en OnePay, todavía no enviada a Meta.              |
| `PENDING`  | Enviada a Meta, esperando revisión.                       |
| `APPROVED` | Aprobada y lista para usarse.                             |
| `REJECTED` | Rechazada por Meta. Revisa el motivo y vuelve a enviarla. |

## Categorías

El campo `type` indica para qué sirve la plantilla.

| Categoría          | Descripción                                                             |
| ------------------ | ----------------------------------------------------------------------- |
| `PAYMENT`          | Solicita un pago. Son las únicas que puedes fijar en un cobro.          |
| `PAYMENT_APPROVED` | Confirma un pago ya realizado.                                          |
| `UTILITY`          | Notificaciones operativas (cuenta conectada, tarjeta verificada, etc.). |
| `MARKETING`        | Mensajes promocionales.                                                 |
| `AUTHENTICATION`   | Códigos de verificación.                                                |

## El campo `selectable`

Cada plantilla del listado trae un booleano `selectable`. Solo los `id` con `selectable: true` son válidos en el `template_id` de un cobro. Una plantilla es seleccionable cuando cumple **todo** lo siguiente:

* Pertenece a tu empresa, o es una de las plantillas genéricas compartidas contigo.
* Su estado es `APPROVED`.
* Su categoría es `PAYMENT`.
* Está registrada en un proveedor de WhatsApp donde tienes canal.

Si una plantilla tuya aparece con `selectable: false`, el resto de sus campos te dicen por qué: normalmente su `status` todavía no es `APPROVED`, su `type` no es `PAYMENT`, o su `provider` no corresponde a ninguno de tus canales.

<Note>
  Las variantes que OnePay genera automáticamente (Bre-B y sin documento) no aparecen en el listado. Se aplican solas sobre la plantilla que elijas cuando el cobro lo requiere.
</Note>

## Etapas de cobranza

Las plantillas con `stage` pertenecen al motor de cobranzas y su texto está escrito para ese momento del ciclo: `reminder`, `due_soon`, `due_today`, `overdue`, `pre_cut`, `cut`, `winback` y `custom`. Las plantillas de cobro directo tienen `stage: null`.

<CardGroup cols={1}>
  <Card title="Listar plantillas" icon="list" href="/client/templates/list">
    Consulta las plantillas disponibles para tu empresa y cuáles puedes fijar en un cobro.
  </Card>
</CardGroup>