# Activar los envíos paso a paso

Esta guía te lleva desde cero hasta que tu agente pueda **enviar un elemento por email o por WhatsApp** durante una conversación. El orden importa: primero preparas lo que se envía, después se lo habilitas al agente.

## Resumen del recorrido

1. Requisitos previos (buzón de email y/o número de WhatsApp).
2. Crear la plantilla de WhatsApp aprobada (solo si vas a enviar por WhatsApp).
3. Crear el catálogo.
4. Cargar los elementos.
5. Asociar el catálogo al agente.
6. Activar la función en el agente.
7. Probar el envío.

***

## Paso 1 · Requisitos previos

Según el canal que quieras usar:

* **Para enviar por email:** necesitas un **buzón de correo** conectado (Gmail, SMTP o webhook de Make). Se configura en **Agentes de Email → Conectar Gmail** (o el buzón que corresponda).
* **Para enviar por WhatsApp:** necesitas un **agente de WhatsApp con un número conectado** (una WABA activa). El envío sale desde ese número.

Puedes tener los dos canales o solo uno.

***

## Paso 2 · Crear la plantilla de WhatsApp (solo canal WhatsApp)

WhatsApp no permite enviar un mensaje "en frío" con texto libre: hay que usar una **plantilla aprobada por Meta**. Si vas a mandar un documento (por ejemplo un PDF de presupuesto), la plantilla debe estar preparada para ello.

1. Ve a **Agentes de WhatsApp → Plantillas → Nueva plantilla**.
2. Elige el **tipo de header** según lo que envíes:
   * **📄 Documento (PDF)** si vas a adjuntar un archivo.
   * **Texto** o **sin header** si es solo un mensaje.
3. Escribe el **cuerpo** del mensaje. Si necesitas personalizarlo, usa variables numeradas `{{1}}`, `{{2}}`, etc. (por ejemplo: _"Hola \{{1\}}, te enviamos el presupuesto que solicitaste."_). Esas variables las completa el agente al momento de enviar.
4. Envía la plantilla a aprobación. **Meta puede tardar** desde minutos hasta unas horas en aprobarla.

> ⚠️ Solo puedes usar plantillas en estado **Aprobada**. Hasta que Meta la apruebe, no estará disponible para enviar.

Puedes ver más detalles en la sección [Plantillas](../agentes-de-whatsapp/plantillas.md).

***

## Paso 3 · Crear el catálogo

1. En el menú lateral, abre **Catálogos**.
2. Haz clic en **Nuevo catálogo** y ponle un nombre descriptivo (por ejemplo _"Presupuestos"_ o _"Propiedades"_).
3. Guárdalo. Vas a entrar al detalle del catálogo, donde cargas sus elementos.

***

## Paso 4 · Cargar los elementos

Dentro del catálogo, agrega un **elemento** por cada cosa que el agente pueda enviar. Para cada uno defines:

* **Nombre** y **descripción.** La descripción es importante: le dice al agente **cuándo enviar este elemento**. Sé claro (por ejemplo: _"Presupuesto estándar de instalación, se envía cuando el cliente pide precios"_).
* **Canal(es).** Puedes preparar el mismo elemento para email, para WhatsApp o para ambos.

**Si el elemento se envía por email:**

* **Asunto** y **cuerpo** del correo.
* Puedes usar variables entre llaves, por ejemplo `{nombre}`, `{precio}`. El agente las completa según la conversación.
* Opcional: **adjuntar un documento** (subes el archivo o indicas una URL).

**Si el elemento se envía por WhatsApp:**

* **Selecciona la plantilla aprobada** desde la lista (la que creaste en el Paso 2). Al elegirla, verás una **vista previa del texto real** que se enviará.
* Si la plantilla lleva un documento, **sube el PDF** (o indica su URL).
* Si la plantilla tiene variables (`{{1}}`, `{{2}}`…), **indica qué dato va en cada una** (por ejemplo, la variable 1 = `nombre`). El agente los completa al enviar.

> 💡 Las variables son la forma de personalizar el envío. Le dices al agente _qué_ datos necesita cada elemento, y el agente los toma de la conversación (el nombre del cliente, el monto acordado, etc.).

Guarda el elemento. Puedes cargar tantos como quieras.

***

## Paso 5 · Asociar el catálogo al agente

Todavía dentro del catálogo, en la sección de **agentes asociados**, marca los agentes que podrán usar este catálogo. Guarda.

Solo los agentes marcados podrán consultar y enviar los elementos de este catálogo.

***

## Paso 6 · Activar la función en el agente

Ahora le das al agente la capacidad de enviar.

1. Abre la **ficha del agente de voz** que asociaste.
2. Ve a la sección de **Funciones** y busca la tarjeta **📤 Enviar catálogo** (categoría _Enviar_).
3. Marca lo que quieras habilitar:
   * **Consultar catálogo** — para que el agente pueda ver qué elementos hay disponibles (se recomienda dejarla siempre activa).
   * **Enviar por email** — y elige el **buzón** desde el que saldrá el correo.
   * **Enviar por WhatsApp** — y elige el **agente/número de WhatsApp** emisor.
4. Agrégalas y guarda. Las funciones seleccionadas se activan **juntas**.

Con esto, el agente ya sabe consultar el catálogo y enviar por los canales que habilitaste.

***

## Paso 7 · Probar el envío

Haz una llamada de prueba y pídele al agente algo como _"envíame el presupuesto a mi correo"_ o _"mándame la ficha por WhatsApp"_. El agente debería:

1. Consultar el catálogo y ubicar el elemento correcto.
2. Pedir o confirmar el destinatario (email o teléfono).
3. Completar las variables con los datos de la conversación.
4. Enviar y confirmar.

Verifica que el mensaje llegue con las variables **reemplazadas** (por ejemplo, que diga _"Hola Ana"_ y no _"Hola {nombre}"_).

***

## Preguntas frecuentes

**Edité un precio / cambié el PDF. ¿Tengo que reconfigurar el agente?** No. La consulta es **en vivo**: los cambios en los elementos se reflejan al instante. Solo necesitas volver a la ficha del agente si cambias **qué canales** están habilitados.

**El WhatsApp llega pero el agente lo marca como error.** Asegúrate de tener la última versión. Si el mensaje llega, el envío fue exitoso.

**El correo llega pero con `{nombre}` sin reemplazar.** Significa que el agente no completó esa variable. Revisa que la **descripción del elemento** deje claro qué datos necesita, y que la función esté activada en su versión más reciente.

**¿Puedo enviar en frío por WhatsApp sin plantilla?** No. Por la regla de las 24 horas de Meta, todo envío que inicia una conversación debe usar una plantilla aprobada.
