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

# Plantillas y casos de uso

> WAITLIST, NEWSLETTER, CONTACT, SURVEY, and BLANK, when to use each and how they behave.

<Tip>
  La **plantilla** solo establece **valores predeterminados** (cola, suscripción voluntaria, campos). Todo se encuentra bajo **`/v1/forms`**, sin lista de espera separada ni API de boletín informativo.
</Tip>

## Templates at a glance

| Template       | Typical use      | Queue | Double opt-in default | Contact |
| -------------- | ---------------- | ----- | --------------------- | ------- |
| **WAITLIST**   | Pre-launch, beta | Yes   | No                    | Yes     |
| **NEWSLETTER** | Email list       | No    | Ignored on subscribe  | Yes     |
| **CONTACT**    | Contact us       | No    | No                    | Yes     |
| **SURVEY**     | Survey / NPS     | No    | No                    | No      |
| **BLANK**      | Custom layout    | No    | No                    | No      |

Adjust `features` in the API or dashboard (`queue`, `doubleOptIn`, `captureContact`).

***

## Caso de uso 1, lista de espera

**Escenario:** Producto aún no lanzado; El orden por orden de llegada importa.

1. Crea con `template: "WAITLIST"` y `features.queue: true`
2. Comparte `/w/forms/{id}` o suscríbete a través de API
3. Cada envío confirmado recibe **`queuePosition`**
4. `form.submitted` webhook alimenta CRM o automatización de bienvenida

***

## Caso de uso 2, Boletín

**Escenario:** Recopile correos electrónicos para actualizaciones recurrentes.

1. Crea con `template: "NEWSLETTER"`
2. Suscríbase a **upserts** por correo electrónico/teléfono; `preferences` reemplaza los valores anteriores
3. La respuesta incluye **`unsubscribeToken`**, tratar como secreto
4. Cancelar vía API `.../cancel` o `/w/forms/unsubscribe?token=`
5. **`form.unsubscribed`** webhook para limpieza de listas externas

<Note>
  El boletín **ignora** la doble suscripción, las suscripciones se activan inmediatamente. Para confirmación por correo electrónico, utilice **CONTACTO** o **BLANCO** con `doubleOptIn: true`.
</Note>

***

## Caso de uso 3, formulario de contacto

**Escenario:** “Contáctenos” en el sitio web.

1. `template: "CONTACT"`, nombre, correo electrónico, mensaje por defecto
2. `captureContact: true` crea o vincula un espacio de trabajo **contacto**
3. `form.submitted` abre un ticket o notifica al equipo

***

## Caso de uso 4, Encuesta (ENCUESTA)

**Escenario:** NPS posterior a la compra o comentarios del evento.

1. `template: "SURVEY"`, múltiples campos en `answers`
2. No hay captura automática de contactos de forma predeterminada; habilite `captureContact` si es necesario

***

## Página alojada e incrustada

| Resource         | URL                            |
| ---------------- | ------------------------------ |
| Public page      | `/w/forms/{id}`                |
| Embed            | `/w/embed/forms/{id}`          |
| Public subscribe | `POST /w/forms/{id}/subscribe` |
| Confirm opt-in   | `/w/forms/confirm?token=`      |

***

## Estado del formulario

| Status                        | Behavior                                                                      |
| ----------------------------- | ----------------------------------------------------------------------------- |
| `ACTIVE`                      | Accepts submissions                                                           |
| `PAUSED` / `CLOSED` / `ENDED` | Blocks public page; API returns `SKIPPED` (or **400** if inactive newsletter) |

***

## Próximos pasos

* [Inicio rápido](/es/marketing-addons-api/como-funciona/quick-start)
* [Eventos de webhook](/es/marketing-addons-api/como-funciona/eventos-do-webhooks)
* [Introducción](/es/marketing-addons-api/como-funciona/introducao)