Zinn® Campaigns API y MCP: guía para desarrolladores

Todo lo que puede hacer en Zinn® Campaigns desde el panel de control también puede hacerlo a través de la API, y la mayor parte de ello desde un asistente de IA conectado a su cuenta mediante MCP. Esta guía cubre el inicio de sesión, los permisos, un ejemplo práctico para ambos métodos, los límites, los errores y cada una de las 89 operaciones de Campaigns. La lista de operaciones que figura a continuación se genera a partir de nuestra especificación de la API, por lo que siempre coincide con lo que la API hace. Cada campo de cada operación se encuentra en la referencia de la API en zinndigital.com/developers/api/zinn-campaigns.

Inicio de sesión

• Claves de API. Cree una clave en el panel de control en Configuración → Claves de API y envíela como Authorization: Bearer zdk_live_… (una clave zdk_test_… funciona en modo sandbox). Otorgue a la clave únicamente los permisos de Campañas que necesite y nada más.
• Asistentes de IA (MCP). Conecte Claude, ChatGPT, Cursor o cualquier cliente de MCP a https://api.zinndigital.com/v1/mcp, ya sea iniciando sesión desde la aplicación o con un token de conexión (zmcp_live_…). Consulte Conectar Claude, Cursor o ChatGPT a su cuenta. En la pantalla de consentimiento, marque los permisos de Zinn® Campaigns.
• Permisos. email_marketing.view lee campañas, listas, contactos, formularios, remitentes, ajustes de SMS e informes; email_marketing.manage los crea y los modifica. Las campañas que envía a través de su propio servicio de correo electrónico utilizan campaigns.view y campaigns.manage.
• Distribuidores. Pase org_id para actuar en una de las organizaciones de sus clientes. Omítalo cuando su clave o conexión acceda a una sola organización.

Ejemplo: crear un borrador de campaña con la API

curl -X POST https://api.zinndigital.com/v1/email-marketing/campaigns \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring sale",
  "subject": "Our spring sale starts today",
  "list_id": "<list id>",
  "sender_id": "<sender id>",
  "template": "basic"
}'

La respuesta es 201 con el borrador. Pruébelo con POST /v1/email-marketing/campaigns/{campaign_id}/test, revíselo con GET /v1/email-marketing/campaigns/{campaign_id}/lint y envíelo con POST /v1/email-marketing/campaigns/{campaign_id}/send.

Ejemplo: el mismo borrador desde un asistente de IA

Pídale a su asistente en palabras sencillas, por ejemplo: «crea un borrador de correo en Zinn® Campaigns llamado Rebajas de primavera con el asunto 'Nuestras rebajas de primavera comienzan hoy'». En segundo plano, encuentra la operación con api_operations_search, lee sus parámetros con api_operation_get y la ejecuta con api_operation_call:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "api_operation_call",
    "arguments": {
      "operation_id": "createEmailMarketingCampaign",
      "confirm": true,
      "body": {
        "name": "Spring sale",
        "subject": "Our spring sale starts today"
      }
    }
  }
}

Lo que un asistente no hará. Todo aquello que envíe mensajes a sus destinatarios o consuma dinero o cuota (enviar una campaña, enviar mensajes de SMS o WhatsApp, redactar con créditos de IA, registrarse para mensajería en US) se deniega al asistente, de modo que una instrucción malinterpretada nunca pueda llegar a sus clientes. El asistente prepara el borrador; usted pulsa Enviar en el panel de control o llama a la API por su cuenta. Los datos confidenciales, como una contraseña de SMTP, tampoco se pasan jamás a través de un asistente: introdúzcalos en el panel de control.

Límites

• 1.200 solicitudes por minuto para cada persona o clave de API, y 6.000 solicitudes por minuto para cada organización. Se aplica el límite más restrictivo de los dos.
• 600 solicitudes por minuto para cada conexión MCP.
• Si se supera un límite, la respuesta es 429 con una cabecera Retry-After: espere esa cantidad de segundos.
• Añadir miembros a una lista admite un máximo de 1.000 direcciones por solicitud; las cuotas de contactos y correo electrónico de su plan se aplican a todo lo que realice a través de la API.

Errores

Todos los errores tienen la misma estructura:

{"error": {"code": "UNPROCESSABLE_ENTITY", "message": "…", "details": [{"field": "subject", "code": "REQUIRED", "message": "…"}], "request_id": "…"}}

code nunca cambia para el mismo problema, así que evalúe este en lugar de message. Indique request_id cuando se comunique con el soporte técnico. Las respuestas que encontrará: 401 UNAUTHORIZED, 403 FORBIDDEN, 404 NOT_FOUND, 409 CONFLICT, 422 UNPROCESSABLE_ENTITY, 429 TOO_MANY_REQUESTS. Un 403 significa que la clave o la conexión carece de un permiso indicado en la lista siguiente; un 404 también cubre un elemento de una organización que usted no puede ver; un 422 enumera cada campo incorrecto en details; después de un 429, espere el número de segundos indicado en el encabezado Retry-After.

Webhooks

Los resultados de entrega llegan hacia Zinn® Campaigns desde el proveedor que envía su correo electrónico:

• Con su propio proveedor (por ejemplo, Resend), almacene su secreto de firma de webhook en la conexión de envío dentro del panel (Campañas → Envío). Obtendrá una webhook_url; apunte hacia ella los eventos de entrega, rebote y queja del proveedor. Un rebote o una queja por spam elimina la dirección de futuros envíos de inmediato.
• Con el envío de Zinn®, no hay nada que configurar.

Consulte los resultados con las operaciones de informe (getEmailMarketingCampaignReport, getSmsMarketingCampaignReport).

Cada operación de Campaigns

Resumen

• GET /v1/email-marketing — Resumen de Zinn® Campaigns para una organización. Operación getEmailMarketingOverview. Permisos verificados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.

Campañas de correo electrónico

• GET /v1/email-marketing/campaigns — Campañas de correo electrónico, las más recientes primero, una página keyset. Operación listEmailMarketingCampaigns. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/campaigns — Crear un borrador de campaña de correo electrónico. Operación createEmailMarketingCampaign. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/email-marketing/campaigns/{campaign_id} — Una campaña de correo electrónico. Operación getEmailMarketingCampaign. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• PATCH /v1/email-marketing/campaigns/{campaign_id} — Editar un borrador (o una campaña rechazada, que vuelve a borrador). Operación updateEmailMarketingCampaign. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/email-marketing/campaigns/{campaign_id}/lint — Comprobar el texto de una campaña en busca de problemas de entregabilidad antes de enviarla. Operación lintEmailMarketingCampaign. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/email-marketing/campaigns/{campaign_id}/report — Cifras de una campaña. Operación getEmailMarketingCampaignReport. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/campaigns/{campaign_id}/send — Iniciar el envío de una campaña a su lista. Operación sendEmailMarketingCampaign. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: Solo API y panel de control: consume dinero o cuota, por lo que debe pulsarlo una persona (envía a destinatarios reales y consume cuota).
• POST /v1/email-marketing/campaigns/{campaign_id}/test — Enviar una copia de prueba ahora a un miembro de la organización. Operación testEmailMarketingCampaign. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: Sí, a través del MCP.
• POST /v1/email-marketing/campaigns/{campaign_id}/translate — Traducir una campaña a cada idioma de contacto que falte o esté desactualizado. Operación translateEmailMarketingCampaign. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: Sí, a través del MCP.
• GET /v1/email-marketing/campaigns/{campaign_id}/translations — Cada idioma de contacto de la lista de una campaña y si su traducción está actualizada. Operación listEmailMarketingCampaignTranslations. Permisos comprobados: email_marketing.view. Desde un asistente de IA: Sí, a través del MCP.

Redacción con IA

• POST /v1/email-marketing/ai/write — Redacte un borrador de correo electrónico de campaña a partir de un breve resumen con Zinn® AI. Operación writeEmailMarketingCampaignWithAi. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: solo API y panel de control: gasta dinero o saldo, por lo que debe pulsarlo una persona (la redacción con IA gasta créditos de IA).

Kit de marca

• GET /v1/email-marketing/brand-kit — El kit de marca de la organización (nombre, logotipo, colores, fuente, tono de voz). Operación getEmailMarketingBrandKit. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• PUT /v1/email-marketing/brand-kit — Edite el kit de marca. Operación updateEmailMarketingBrandKit. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/brand-kit/read — Lea el kit de marca desde el sitio web de la organización. Operación readEmailMarketingBrandKit. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.

Contactos y mensajes puntuales

• GET /v1/email-marketing/contacts — Los contactos de la organización, una página keyset a la vez. Operación listEmailMarketingContacts. Permisos verificados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/contacts/{contact_id}/messages — Envíe un SMS a un contacto, pagado con el saldo de crédito de Zinn®. Operación sendEmailMarketingMessage. Permisos verificados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: solo API y panel de control: gasta dinero o saldo disponible, por lo que una persona debe pulsar (un mensaje puntual a un contacto gasta saldo disponible).
• GET /v1/email-marketing/messages — Mensajes de SMS y WhatsApp enviados por la organización, los más recientes primero, una página keyset. Operación listEmailMarketingMessages. Permisos verificados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.

Listas

• GET /v1/email-marketing/lists — Las listas de correo de la organización con el recuento de suscritos y cancelados. Operación listEmailMarketingLists. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/lists — Crea una lista de correo (o devuelve la que tiene ese nombre). Operación createEmailMarketingList. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/lists/{list_id}/members — Añade contactos a una lista por dirección de correo electrónico (un máximo de 1000 por solicitud). Operación addEmailMarketingListMembers. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.

Importaciones

• GET /v1/email-marketing/imports — Importaciones de contactos anteriores, las más recientes primero, una página de keyset a la vez. Operación listEmailMarketingImports. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/imports — Importa un lote de contactos con su certificación de consentimiento. Operación createEmailMarketingImport. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.

Formularios de registro

• GET /v1/email-marketing/forms — Formularios de registro (doble suscripción), los más recientes primero, una página de keyset. Operación listEmailMarketingForms. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/forms — Cree un formulario de registro que añada personas confirmadas a una lista. Operación createEmailMarketingForm. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• DELETE /v1/email-marketing/forms/{form_id} — Elimine un formulario de registro (las personas ya confirmadas permanecen en la lista). Operación deleteEmailMarketingForm. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• PATCH /v1/email-marketing/forms/{form_id} — Modifique un formulario de registro (redacción, lista, redirección, activado o desactivado). Operación updateEmailMarketingForm. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.

Conexiones de envío

• GET /v1/email-marketing/senders — Las conexiones de envío de la organización. Operación listEmailMarketingSenders. Permisos verificados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/senders — Conectar un remitente de campaña (envío Zinn® o el propio servidor SMTP del cliente). Operación createEmailMarketingSender. Permisos verificados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: solo API y panel de control: contiene un secreto que nunca debe llegar a un modelo de IA (el cuerpo es la contraseña SMTP).
• DELETE /v1/email-marketing/senders/{sender_id} — Eliminar una conexión de envío y su contraseña almacenada. Operación deleteEmailMarketingSender. Permisos verificados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/senders/{sender_id}/verify — Demostrar que una conexión de envío funciona, sin enviar nada. Operación verifyEmailMarketingSender. Permisos verificados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• PUT /v1/email-marketing/senders/{sender_id}/webhook — Almacenar el secreto de firma de webhook de su proveedor de correo electrónico para esta conexión. Operación setEmailMarketingSenderWebhook. Permisos verificados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: llamado por otro sistema (un proveedor o un visitante), no por usted (almacena el secreto de webhook de un proveedor).

SMS y WhatsApp

• GET /v1/email-marketing/sms — Lo que necesita la pantalla de SMS — ¿abierto?, ¿en pausa?, saldo de crédito y precios. Operación getEmailMarketingSms. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/email-marketing/sms/campaigns — Campañas de SMS masivos, las más recientes primero, una página de keyset. Operación listSmsMarketingCampaigns. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/sms/campaigns — Crear un borrador de SMS para una lista. Operación createSmsMarketingCampaign. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/email-marketing/sms/campaigns/{campaign_id} — Una campaña de SMS masivos. Operación getSmsMarketingCampaign. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• PATCH /v1/email-marketing/sms/campaigns/{campaign_id} — Editar un borrador (o una campaña rechazada, que vuelve a ser borrador). Operación updateSmsMarketingCampaign. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/email-marketing/sms/campaigns/{campaign_id}/report — Las cifras de una campaña de SMS masivos. Operación getSmsMarketingCampaignReport. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/sms/campaigns/{campaign_id}/send — Iniciar el envío de un SMS a todas las personas de su lista que hayan aceptado recibir SMS — o reanudar uno pausado por falta de saldo. Operación sendSmsMarketingCampaign. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: Solo API y panel de control: gasta dinero o saldo, por lo que debe pulsarlo una persona (envía mensajes de SMS/WhatsApp de pago).
• GET /v1/email-marketing/sms/registrations/us — El registro US 10DLC de esta organización y su coste. Operación getEmailMarketingUsRegistration. Permisos comprobados: email_marketing.view. Desde un asistente de IA: Sí, a través del MCP.
• POST /v1/email-marketing/sms/registrations/us — Enviar la marca y la campaña de esta organización para US 10DLC (se cobra al enviarlo). Operación submitEmailMarketingUsRegistration. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: Solo API y panel de control: gasta dinero o saldo, por lo que debe pulsarlo una persona (el registro US 10DLC conlleva cargos de los operadores).

Campañas a través de su propio servicio de correo electrónico (plantillas, segmentos, exclusiones)

• GET /v1/campaigns — Las campañas de la organización. Operación listCampaigns. Desde un asistente de IA: Sí, a través del MCP.
• POST /v1/campaigns — Crear una campaña a partir de una plantilla y una audiencia. Operación createCampaign. Desde un asistente de IA: Sí, a través del MCP.
• DELETE /v1/campaigns/esp — Desconecte la cuenta del proveedor y elimine su clave guardada. Operación disconnectEsp. Desde un asistente de IA: Solo API y panel de control: incluye un secreto que nunca debe llegar a un modelo de IA (destruye la clave de ESP guardada).
• GET /v1/campaigns/esp — La cuenta propia del proveedor de correo electrónico de la organización. Operación getEspConnection. Desde un asistente de IA: Sí, a través del MCP.
• POST /v1/campaigns/esp — Conecte una cuenta de proveedor de correo electrónico. Operación connectEsp. Desde un asistente de IA: Solo API y panel de control: incluye un secreto que nunca debe llegar a un modelo de IA (el cuerpo del mensaje es la clave de API de ESP).
• POST /v1/campaigns/esp/verify — Compruebe que la cuenta del proveedor funcione y lea sus dominios verificados. Operación verifyEspConnection. Desde un asistente de IA: Solo API y panel de control: incluye un secreto que nunca debe llegar a un modelo de IA (vuelve a comprobar una clave de ESP guardada).
• POST /v1/campaigns/preview — Render una plantilla con valores de ejemplo. Operación previewCampaignTemplate. Desde un asistente de IA: Sí, a través del MCP.
• GET /v1/campaigns/segments — Sus segmentos de audiencia guardados. Operación listCampaignSegments. Permisos comprobados: campaigns.view. Desde un asistente de IA: Sí, a través del MCP.
• POST /v1/campaigns/segments — Guarde un nuevo segmento de audiencia. Operación createCampaignSegment. Permisos comprobados: campaigns.manage. Desde un asistente de IA: Sí, a través del MCP.
• GET /v1/campaigns/segments/fields — El vocabulario de filtros, sus listas de valores y las etiquetas mágicas. Operación getCampaignSegmentFields. Permisos verificados: campaigns.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/campaigns/segments/preview — A cuántas personas llega esto, quiénes son y a quiénes excluye. Operación previewCampaignSegment. Permisos verificados: campaigns.view. Desde un asistente de IA: sí, a través del MCP.
• DELETE /v1/campaigns/segments/{segmentId} — Archivar un segmento. Operación archiveCampaignSegment. Permisos verificados: campaigns.manage. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/campaigns/segments/{segmentId} — Un segmento guardado. Operación getCampaignSegment. Permisos verificados: campaigns.view. Desde un asistente de IA: sí, a través del MCP.
• PATCH /v1/campaigns/segments/{segmentId} — Cambiar el nombre de un segmento o modificar sus filtros. Operación updateCampaignSegment. Permisos verificados: campaigns.manage. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/campaigns/suppressions — Direcciones que no deben recibir marketing. Operación listCampaignSuppressions. Permisos verificados: campaigns.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/campaigns/suppressions — Añadir una dirección a la lista de supresión. Operación createCampaignSuppression. Permisos verificados: campaigns.manage. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/campaigns/tags — La paleta de etiquetas mágicas (magic tags) que ofrece un editor de campañas. Operación listCampaignTags. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/campaigns/templates — Las plantillas de campaña de la organización. Operación listCampaignTemplates. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/campaigns/templates — Crear una plantilla de campaña. Operación createCampaignTemplate. Desde un asistente de IA: sí, a través del MCP.
• DELETE /v1/campaigns/templates/{templateId} — Archivar una plantilla y retirar sus fuentes de traducción. Operación archiveCampaignTemplate. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/campaigns/templates/{templateId} — Una sola plantilla de campaña. Operación getCampaignTemplate. Desde un asistente de IA: sí, a través del MCP.
• PUT /v1/campaigns/templates/{templateId} — Editar una plantilla de campaña. Operación updateCampaignTemplate. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/campaigns/unsubscribe — Darse de baja de una lista de marketing. No se requiere cuenta. Operación unsubscribeFromCampaigns. Desde un asistente de IA: solo API y panel de control: contiene un secreto que nunca debe llegar a un modelo de IA (admite un token firmado de cancelación de suscripción del destinatario).
• DELETE /v1/campaigns/{campaignId} — Eliminar una campaña y retirar sus filas de entrega. Operación deleteCampaign. Desde un asistente de IA: solo API y panel de control: requiere un permiso que no se ofrece a las conexiones de IA (eliminar una campaña de ESP requiere campaigns.send).
• GET /v1/campaigns/{campaignId} — Una campaña y su informe de entrega. Operación getCampaign. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/campaigns/{campaignId}/control — Pausar, reanudar o cancelar un envío en curso. Operación controlCampaign. Desde un asistente de IA: solo API y panel de control: gasta dinero o cuota, por lo que debe pulsarlo una persona (pausa/reanuda un envío en vivo).
• POST /v1/campaigns/{campaignId}/send — Iniciar el envío duradero. Operación sendCampaign. Desde un asistente de IA: solo API y panel de control: gasta dinero o cuota, por lo que debe pulsarlo una persona (envía una campaña de ESP a destinatarios reales).
• POST /v1/campaigns/{campaignId}/test — Enviar un mensaje real por el canal que utilizará efectivamente la campaña. Operación testSendCampaign. Desde un asistente de IA: solo API y panel de control: requiere un permiso que no se ofrece a las conexiones de IA (un envío de prueba de ESP requiere campaigns.send).

Páginas públicas y webhooks entrantes

• GET /v1/public/email-marketing/c/{token} — El contador de clics. Registra un clic por destinatario y redirige al enlace original. Operación emailMarketingClick. Desde un asistente de IA: una página que sus destinatarios abren desde un correo electrónico (la redirección de seguimiento de clics).
• GET /v1/public/email-marketing/f/{public_id} — La página alojada de un formulario de registro (sin inicio de sesión). Operación emailMarketingFormPage. Desde un asistente de IA: una página que sus destinatarios abren desde un correo electrónico (la página pública del formulario de registro).
• POST /v1/public/email-marketing/f/{public_id} — Enviar un formulario de registro (página alojada, incrustación o JSON). Operación emailMarketingFormSubmit. De un asistente de IA: llamado por otro sistema (un proveedor o un visitante), no por usted (un visitante envía un formulario de registro).
• GET /v1/public/email-marketing/fc — La página de confirmación de doble inclusión (double opt-in) (sin inicio de sesión). Operación emailMarketingFormConfirmPage. De un asistente de IA: una página que sus destinatarios abren desde un correo electrónico (la página de confirmación de doble inclusión).
• POST /v1/public/email-marketing/fc — Confirmar un registro (añade a la persona a la lista con un registro de consentimiento). Operación emailMarketingFormConfirm. De un asistente de IA: llamado por otro sistema (un proveedor o un visitante), no por usted (un visitante confirma una doble inclusión).
• GET /v1/public/email-marketing/o/{token} — La imagen de seguimiento de apertura (un GIF de 1x1). Cuenta una apertura por destinatario. Operación emailMarketingOpenPixel. De un asistente de IA: una página que sus destinatarios abren desde un correo electrónico (el píxel de seguimiento de apertura).
• GET /v1/public/email-marketing/u/{token} — El enlace de cancelación de suscripción del pie de página (sin inicio de sesión). Operación emailMarketingUnsubscribePage. De un asistente de IA: una página que sus destinatarios abren desde un correo electrónico (la página de cancelación de suscripción).
• POST /v1/public/email-marketing/u/{token} — Cancelación de suscripción en un clic según RFC 8058 (y el botón de la página «detener todo»). Operación emailMarketingUnsubscribeOneClick. De un asistente de IA: llamado por otro sistema (un proveedor o un visitante), no por usted (cancelación de suscripción en un clic según RFC 8058).
• GET /v1/public/email-marketing/warmup-u/{token} — El enlace de cancelación de suscripción del correo de precalentamiento del grupo de marketing (sin inicio de sesión). Operación emailMarketingWarmupUnsubscribePage. De un asistente de IA: una página que sus destinatarios abren desde un correo electrónico (la página de cancelación de suscripción de precalentamiento).
• POST /v1/public/email-marketing/warmup-u/{token} — Cancelación de suscripción en un clic según RFC 8058 del correo de precalentamiento. Operación emailMarketingWarmupUnsubscribeOneClick. De un asistente de IA: llamado por otro sistema (un proveedor o un visitante), no por usted (cancelación de suscripción de precalentamiento en un clic).
• POST /v1/webhooks/campaign-events — Ingerir un evento de entrega firmado del proveedor de correo electrónico. Operación receiveCampaignDeliveryWebhook. De un asistente de IA: llamado por otro sistema (un proveedor o un visitante), no por usted (webhook de entrega de ESP firmado).
• POST /v1/webhooks/campaigns/telnyx — Respuestas de SMS entrantes (STOP / START) de nuestro proveedor de SMS. Operación receiveCampaignsTelnyxInbound. De un asistente de IA: llamado por otro sistema (un proveedor o un visitante), no por usted (webhook entrante de Telnyx firmado).
• POST /v1/webhooks/email-marketing/{connection_id} — Eventos de entrega del propio proveedor de correo electrónico de un cliente para una conexión de envío. Operación receiveEmailMarketingProviderWebhook. Desde un asistente de IA: llamado por otro sistema (un proveedor o un visitante), no por usted (webhook firmado del proveedor emisor).

Flujos

• GET /v1/email-marketing/flows — Flujos de correo electrónico (bienvenida, por goteo, una fecha anual), una página de keyset. Operación listEmailMarketingFlows. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/flows — Crear un flujo (comienza como borrador). Operación createEmailMarketingFlow. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• DELETE /v1/email-marketing/flows/{flow_id} — Eliminar un flujo y sus inscripciones (sus ejecuciones enviadas permanecen como campañas). Operación deleteEmailMarketingFlow. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• GET /v1/email-marketing/flows/{flow_id} — Un flujo con sus pasos y su informe (inscritos, en curso, ejecuciones y destinatarios por paso). Operación getEmailMarketingFlow. Permisos comprobados: email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• PATCH /v1/email-marketing/flows/{flow_id} — Cambiar un flujo; steps, cuando se proporciona, sustituye toda la secuencia. Operación updateEmailMarketingFlow. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/flows/{flow_id}/activate — Activar un flujo; solo se inscriben las personas que se unan a la lista a partir de ahora. Operación activateEmailMarketingFlow. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.
• POST /v1/email-marketing/flows/{flow_id}/pause — Pausar un flujo; los pasos pendientes esperan y no se envía correo a nadie nuevo hasta que se vuelva a activar. Operación pauseEmailMarketingFlow. Permisos comprobados: email_marketing.manage, email_marketing.view. Desde un asistente de IA: sí, a través del MCP.