Email marketing
Constant Contact en tu producto y en tus agentes de IA, con una API
El toolkit de Constant Contact cubre contactos, listas de contactos y campañas de email con sus actividades, programación y estadísticas de envío. Con Connect, tu producto o agente de IA lo llama todo por un solo endpoint, mientras Connect guarda y renueva las credenciales OAuth y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/constant_contact_create_contact/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"create_source": "Account"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Constant Contact.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Constant Contact. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Constant Contact.
Añade suscriptores al registrarse
Un SaaS crea un contacto en la cuenta del cliente cuando alguien se registra y gestiona el 409 cuando el email ya existe.
Envía una campaña desde tu app
Un producto crea una campaña en borrador con HTML propio, define sus listas y programa el envío.
Informa de los resultados
Un agente de IA lee las estadísticas de una campaña enviada, como aperturas, clics y rebotes, y las resume para el dueño de la cuenta.
Tools
12 tools de Constant Contact
- Listar contactosGETLista los contactos de la cuenta, sin los eliminados por defecto, con filtro opcional por email, lista, estado o fecha. La respuesta trae contacts y, cuando hay más, _links.next.href con el cursor de la página siguiente.
- Crear contactoPOSTCrea un contacto y lo devuelve con su contact_id. Envía create_source y al menos email_address, first_name o last_name. Un email que ya existe en la cuenta responde 409.
- Actualizar contactoPUTActualiza un contacto reemplazando sus campos principales: email_address, nombres, job_title, company_name, birthday y anniversary omitidos quedan vacíos, así que envía también los valores actuales, obtenidos en Listar contactos. Los subrecursos omitidos se conservan, y el que se envía reemplaza al actual.
- Listar listas de contactosGETLista las listas de contactos con list_id, name y description. Una cuenta tiene hasta 1000 listas, y una página trae hasta 1000.
- Crear lista de contactosPOSTCrea una lista de contactos vacía y la devuelve con su list_id. Un nombre ya usado por otra lista responde 409.
- Listar campañas de emailGETLista las campañas de email, de la actualizada más recientemente a la más antigua, con campaign_id, name, type y current_status, incluidas las eliminadas (Removed). Hasta 500 por página; llega a las más antiguas con before_date y after_date. Los ids de las actividades vienen de Obtener campaña de email.
- Obtener campaña de emailGETDevuelve una campaña de email con name, current_status y campaign_activities. El campaign_activity_id con role primary_email es el que usan las herramientas de actividad.
- Crear campaña de emailPOSTCrea una campaña de email en borrador con contenido HTML propio y la devuelve con campaign_activities, donde está la actividad primary_email. Para enviarla, define las listas con Actualizar actividad de la campaña de email y usa Programar actividad de la campaña de email.
- Obtener actividad de la campaña de emailGETDevuelve una actividad de campaña de email: remitente, asunto, preheader, contact_list_ids o segment_ids, format_type y current_status. html_content y physical_address_in_footer solo vienen cuando se piden en include.
- Actualizar actividad de la campaña de emailPUTActualiza 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.
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.
Preguntas sobre el toolkit de Constant Contact
¿Necesito implementar la API de Constant Contact?
No. Connect ya trae 12 tools de Constant Contact descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Constant Contact?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
