Table of Contents
📌 ¿Qué es este módulo?
Mailchimp es una plataforma de automatización de marketing que permite crear campañas de correo electrónico, gestionar listas de contactos y analizar el rendimiento de los envíos. Este módulo facilita la creación de campañas, obtención de campañas existentes y la gestión de suscriptores desde Saturn Studio.
📚 Descripción de los comandos
✉️ Create Campaign
Crear una nueva campaña en Mailchimp.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Mailchimp necesaria para crear una campaña. | credential |
| Título | Título de la campaña. | RocketCampaign |
| ID de lista (audiencia) | Lista de destinatarios (audiencia). | johndoe |
| Asunto del correo | Asunto que verán los destinatarios. | New Product Launch in Rocketbot |
| Nombre del remitente | Nombre que aparecerá como remitente. | Rocketbot |
| Email del remitente | Dirección de correo del remitente. | johndoe@example.com |
| Asignar variable | Variable donde se almacenará el resultado. Ejemplo: {“campaign”:{“id”:”348157430t”,”title”:”RocketCampaign”}} | {var} |
📥 Get Campaign
Obtener una campaña específica de Mailchimp.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Mailchimp necesaria para obtener la campaña. | credential |
| Campaña | Campaña que deseas consultar. | RocketCampaign |
| Asignar variable | Variable donde se almacenará el resultado. Ejemplo: {“campaign”:{“title”:”RocketCampaign”,”status”:”save”}} | {var} |
👤 Add/Update a Subscriber
Agregar o actualizar un suscriptor en una lista de Mailchimp.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Mailchimp necesaria para agregar o actualizar el suscriptor. | credential |
| ID de lista | Audiencia en la que se agregará o actualizará el contacto. | johndoe |
| Dirección de email | Email del suscriptor. | johndoe@example.com |
| Estado del contacto | Estado del suscriptor: Subscribed, Unsubscribed, Cleaned, Pending, etc. | Subscribed |
| VIP | Marca al suscriptor como VIP si está seleccionado. | true |
| Nombre | Nombre del suscriptor. | John |
| Apellido | Apellido del suscriptor. | Doe |
| Empresa | Empresa del suscriptor. | Rocketbot |
| Teléfono | Teléfono del suscriptor. | 313231335689 |
| Asignar variable | Variable donde se almacenará el resultado. Ejemplo: {“subscriber”:{“email_address”:”johndoe@example.com“,”full_name”:”John”}} | {var} |
🧪 Ejemplo de uso
- Create Campaign
Lanzar una nueva campaña con asunto, nombre del remitente y lista de destinatarios desde Saturn Studio. - Get Campaign
Consultar los detalles de una campaña previamente creada, incluyendo su estado, asunto y configuración. - Add/Update Subscriber
Agregar un nuevo contacto a una audiencia o actualizar uno existente, definiendo nombre, estado, empresa, VIP, etc.
🧩 Requisitos
- Contar con una credencial válida de Mailchimp configurada en Saturn Studio.
- Para campañas, es obligatorio contar con al menos una audiencia (lista) ya creada.
- Los suscriptores se deben agregar a una lista activa con un email válido y estado definido.
- El estado del suscriptor debe ser uno de los siguientes:
subscribed,unsubscribed,cleaned,pending,transactional.