El catálogo/Mailchimp
Mailchimp
app.mailchimp
Mailchimp email marketing — manage audiences, campaigns, subscribers, templates, and automations.
Versión2.0.0
Categoríamarketing
AutenticaciónClave de API
Herramientas18
Transportestdio
LicenciaMIT
02
Herramientas
18 herramientas que el agente puede llamar.
Todas se declaran con parámetros tipados y devuelven resultados estructurados, así que el anfitrión puede renderizarlas en vez de narrarlas.
- add-subscriberAdd a subscriber to a Mailchimp audience (POST /lists/{listId}/members). Returns the created subscriber. Params: listId (required), email_address (required), status? ("subscribed"|"unsubscribed"|"cleaned"|"pending"|"transactional", default "subscribed"), merge_fields? ({ FNAME?, LNAME?, ... }).
- create-campaignCreate a campaign in Mailchimp (POST /campaigns). Returns the created campaign. Params: type (required, "regular"|"plaintext"|"absplit"|"rss"|"variate"), recipients? ({ list_id }), settings? ({ subject_line?, from_name?, reply_to?, ... }).
- create-segmentCreate a segment in a Mailchimp audience (POST /lists/{listId}/segments). Returns the created segment. Params: listId (required), name (required), static_segment? (array of emails for static segment), conditions? ({ match: "any"|"all", conditions: [...] } for dynamic segment).
- delete-subscriberPermanently delete a subscriber from a Mailchimp audience (DELETE /lists/{listId}/members/{subscriberHash}). Returns { deleted: true }. Params: listId (required), subscriberHash (required, MD5 hash of lowercase email).
- get-audienceGet one audience (list) by id from Mailchimp (GET /lists/{listId}). Returns audience details including stats and member count. Params: listId (required, string).
- get-campaignGet one campaign by id from Mailchimp (GET /campaigns/{campaignId}). Returns campaign details. Params: campaignId (required, string).
- get-campaign-reportGet a campaign report from Mailchimp (GET /reports/{campaignId}). Returns performance data including opens, clicks, bounces, unsubscribes. Params: campaignId (required, string).
- get-templateGet one template by id from Mailchimp (GET /templates/{templateId}). Returns template details. Params: templateId (required, number).
- list-audiencesList audiences (lists) from Mailchimp (GET /lists). Returns { audiences, total_items, count }. Params: count? (1-1000, default 10).
- list-automationsList automations from Mailchimp (GET /automations). Returns { automations, total_items, count }. Params: count? (1-1000, default 10).
- list-campaignsList campaigns from Mailchimp (GET /campaigns). Returns { campaigns, total_items, count }. Params: count? (1-1000, default 10).
- list-merge-fieldsList merge fields for a Mailchimp audience (GET /lists/{listId}/merge-fields). Returns { merge_fields, total_items, count }. Params: listId (required), count? (1-1000, default 10).
- list-segmentsList segments for a Mailchimp audience (GET /lists/{listId}/segments). Returns { segments, total_items, count }. Params: listId (required), count? (1-1000, default 10).
- list-subscribersList subscribers (members) of an audience from Mailchimp (GET /lists/{listId}/members). Returns { subscribers, total_items, count }. Params: listId (required), count? (1-1000, default 10).
- list-tagsSearch tags for a Mailchimp audience by name prefix (GET /lists/{listId}/tag-search). Returns { tags, total_items }. Params: listId (required), name? (prefix to filter, default "").
- list-templatesList templates from Mailchimp (GET /templates). Returns { templates, total_items, count }. Params: count? (1-1000, default 10).
- send-campaignSend a campaign in Mailchimp (POST /campaigns/{campaignId}/actions/send). The campaign must be ready to send. Returns { sent: true }. Params: campaignId (required, string).
- update-subscriberUpdate a subscriber in a Mailchimp audience (PATCH /lists/{listId}/members/{subscriberHash}). Returns the updated subscriber. Params: listId (required), subscriberHash (required, MD5 hash of lowercase email), email_address? (new email), status? ("subscribed"|"unsubscribed"|"cleaned"|"pending"|"transactional"), merge_fields? ({ FNAME?, LNAME?, ... }).
03
Autenticación y permisos
Qué pide.
Declarado en el manifiesto y por adelantado. La aplicación no puede alcanzar nada que no haya pedido aquí.
Secretos de usuario
API_KEY
Seguir leyendo
El manifiesto y el código de Mailchimp están en el monorepo, junto al resto de aplicaciones.