Actualizar actividad de la campaña de email en Constant Contact, con una API

Actualiza la actividad primary_email de una campaña en estado DRAFT o DONE. Reemplaza las propiedades: envía el remitente, asunto, preheader y listas actuales, de Obtener actividad de la campaña de email, junto con los cambios, porque lo que se omita se borra. html_content y physical_address_in_footer se conservan cuando no se envían.

Identificador
constant_contact_update_email_campaign_activity

La llamada

POST https://connect.reportei.com/api/tools/constant_contact_update_email_campaign_activity/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "campaign_activity_id": "<campaign_activity_id>",
    "from_name": "<from_name>",
    "from_email": "<from_email>",
    "reply_to_email": "<reply_to_email>",
    "subject": "<subject>"
  }
}

Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.

Parámetros

Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.

ParámetroTipoObligatorioDescripción
campaign_activity_idstringSíId of the activity with role primary_email, from Get email campaign or Create email campaign.
contact_list_idsarrayNoIds of the lists that receive the email, from List contact lists. Required before scheduling, unless the activity uses a segment.
segment_idsarrayNoThe segment that receives the email, as returned by Get email campaign activity. Send it back to keep it. Never together with contact_list_ids.
from_namestringSíSender name shown to contacts.
from_emailstringSíSender address, a confirmed email address of the account.
reply_to_emailstringSíAddress that receives the replies, a confirmed email address of the account.
subjectstringSíSubject of the email.
preheaderstringNoShort summary shown after the subject in the inbox.
html_contentstringNoNew HTML body, only for format_type 5. Keep [[trackingImage]] inside the body element so opens and clicks are reported.
physical_address_in_footerobjectNoAddress of the sender shown in the footer. state_code is required when country_code is US.

Conexiones posibles

Tu cliente conecta su cuenta de Constant Contact una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.

OAuth con la app de tu producto

Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/constant_contact, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.

La respuesta

Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.

Lista para agentes de IA

El input de esta tool es un JSON Schema, disponible en GET /api/tools/constant_contact_update_email_campaign_activity. Se convierte en la definición de tool de tu agente sin conversión.

Otras tools de Constant Contact

Ver las 12 tools

Toolkits de la misma categoría

Ver los 100 toolkits

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.