**Con la API de Papo (https://papo.global/) usted automatiza la creación, el envío y el análisis de campañas de email marketing directamente desde su sistema, sin acceder manualmente al panel. Los endpoints de Email Marketing permiten gestionar campañas, plantillas, audiencias y métricas de rendimiento mediante llamadas REST, usando la misma autenticación por clave secreta que el resto de la API.**

## Resumen de las operaciones vía API

| Operación | Qué puede hacer programáticamente |
| :--- | :--- |
| **Listar campañas** | Obtener la lista de campañas con métricas (enviados, aperturas, clics) para alimentar paneles o informes. |
| **Crear campaña como borrador** | Crear una nueva campaña de correo electrónico en estado de borrador, definiendo audiencia, plantilla, remitente y programación. |
| **Lanzar campaña** | Lanzar (enviar) una campaña que ya está en borrador o pausada, iniciando los envíos reales. |
| **Enviar correo electrónico individual** | Enviar un único correo electrónico de inmediato, ideal para comunicaciones transaccionales o pruebas. |
| **Listar plantillas** | Recuperar las plantillas de correo electrónico guardadas en la cuenta para reutilizarlas en las campañas. |
| **Listar audiencias** | Obtener las listas de contactos (audiencias) disponibles, incluidas las dinámicas, para segmentación automática. |

Todas las operaciones siguen el estándar REST, con respuestas en JSON y autenticación mediante `Authorization: Bearer <secret_key>`. Como cualquier otro endpoint de Papo, necesita una clave secreta (`sk_live_…`) generada en el panel en **Developers**.

## Cómo funciona: automatizando el ciclo completo de una campaña

### 1. Autentíquese y explore los endpoints

Antes de cualquier llamada, obtenga su clave secreta en el panel de Papo (sección **Developers**). La URL base es la misma que la de la API general, y todas las solicitudes deben incluir el encabezado de autorización. Con la clave en mano, puede listar las audiencias y plantillas existentes para planificar la campaña.

### 2. Cree una campaña en modo borrador

Use el endpoint de creación de campaña de correo electrónico (modo borrador) para preparar el envío sin enviarlo inmediatamente. En la solicitud, indique:
- La credencial de envío (buzón de correo configurado).
- El ID de la plantilla (o el payload del contenido si la crea en línea).
- La audiencia (ID de la lista o un array de contactos).
- Configuraciones opcionales como fecha/hora de programación y ventanas de envío.

La respuesta devuelve el identificador único de la campaña, lo que le permite recuperarla posteriormente.

### 3. Lance la campaña o programe el envío

Con el ID de la campaña en mano, puede lanzarla con otra llamada. Si prefiere la programación automática, solo debe incluir los campos de fecha y hora en el momento de la creación; la campaña quedará en borrador programado y se enviará en el momento definido.

### 4. Monitoree el rendimiento

Utilice el endpoint de listado de campañas para consultar las métricas en cualquier momento. Recibirá datos como total de enviados, tasa de apertura y número de clics. Estos números se pueden extraer a paneles en su sistema (por ejemplo, Google Data Studio, Power BI u hojas de cálculo) usando llamadas periódicas o webhooks.

## Casos de uso típicos

- **Nutrición de leads orientada por eventos:** Un webhook de su ERP informa que un lead alcanzó determinada puntuación; su sistema lanza automáticamente una campaña de correo electrónico vía API, moviendo el lead a la siguiente etapa.
- **Informes corporativos unificados:** Su herramienta de BI consulta periódicamente las métricas de campañas y las combina con datos de ventas, todo de forma programada.
- **Automatizaciones en n8n o Zapier:** Cree flujos que, al recibir un nuevo contacto en el CRM, crean un borrador de campaña de bienvenida y la lanzan sin intervención manual.
- **Reventa white label:** Integre la creación y gestión de campañas en su propio portal de cliente, manteniendo la identidad visual de su marca mientras usa la infraestructura de Papo.

## Para quién es esta solución

- Desarrolladores y equipos de TI que deseen integrar el email marketing a sistemas internos.
- Agencias que necesitan generar campañas en lote para decenas de clientes sin acceder al panel de cada uno.
- Revendedores white label que quieren ofrecer envío de correo electrónico como parte de su portafolio, controlado vía API.
- Empresas que utilizan automatizaciones en n8n, Zapier o scripts personalizados.

## Preguntas frecuentes

### ¿Necesito una clave de API diferente para usar los endpoints de Email Marketing?
No. Las mismas claves (pública y secreta) que ya utiliza para los demás recursos de Papo funcionan en los endpoints de correo electrónico. La autenticación es la misma, mediante el encabezado `Authorization: Bearer`.

### ¿Puedo enviar un único correo electrónico, como una notificación transaccional?
Sí. La API permite envíos individuales e inmediatos, sin necesidad de crear una campaña. Solo debe indicar el destinatario, asunto, contenido y credencial de envío.

### ¿Cómo sé si la campaña se lanzó realmente?
Al llamar al endpoint de lanzamiento, la API devuelve el estado de la campaña. Después, puede consultar el listado de campañas para verificar si el estado pasó de "borrador" a "enviando" o "completada" y obtener las métricas de progreso.

### ¿Qué métricas devuelve la API?
Las respuestas incluyen al menos el total de correos electrónicos enviados, aperturas y clics. Los campos exactos disponibles están documentados en el endpoint de listado, que se puede explorar con herramientas como Postman o la propia interfaz de descubrimiento de la API.

### ¿Puedo crear plantillas de correo electrónico a través de la API?
La funcionalidad actual de listado de plantillas permite recuperar las plantillas ya existentes en la cuenta. La creación de nuevas plantillas se puede hacer desde el panel; verifique la documentación actualizada para confirmar si la ruta de creación está disponible vía API.

### ¿Es posible programar una campaña para una fecha específica?
Sí. Al crear el borrador, puede indicar la fecha y hora deseadas. La campaña permanecerá en ese estado y se enviará automáticamente en el momento programado, siempre que no se pause manualmente.

## Lea también

- [Cómo usar la API de Papo para gestionar Secuencias de follow-up](/hc/papo/articles/como-usar-api-papo-gestionar-secuencias-seguimiento)
- [Cómo usar la API de Papo para crear y actualizar contactos en masa](/hc/papo/articles/como-usar-la-api-de-papo-para-crear-y-actualizar-contactos-en-masa)

---

**[Comienza gratis →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=como-usar-la-api-de-papo-para-gestionar-campanas-de-email-marketing&utm_content=es)**

Centralice canales, automatice respuestas con IA y gestione campañas de correo electrónico — todo en un solo panel, sin costo inicial.