Email marketing
AWeber en tu producto y en tus agentes de IA, con una API
El toolkit de AWeber cubre las cuentas, listas, suscriptores y broadcasts de la cuenta AWeber de un cliente: leer y actualizar suscriptores, y crear, programar o cancelar broadcasts. Con Connect, tu producto o agente de IA llama a estas operaciones 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/aweber_create_subscriber/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"accountId": 1,
"listId": 1,
"email": "<email>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a AWeber.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de AWeber. 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 AWeber.
Sincronizar registros con la lista
Cuando un usuario se registra en tu SaaS, crea el suscriptor en la lista de AWeber del cliente, lo que inicia la serie de seguimiento de la lista.
Actualizar estado del suscriptor
Marca a un suscriptor como dado de baja o cambia etiquetas cuando algo cambia en tu producto, para que los correos sigan el estado real del contacto.
Broadcasts redactados por agente
Un agente de IA escribe un broadcast como borrador, una persona lo revisa, y tu producto lo programa para más adelante o lo cancela antes de enviarse.
Tools
12 tools de AWeber
- Listar cuentasGETDevuelve la cuenta de AWeber a la que llega la conexión, en entries, con su id, el accountId que piden todas las demás tools y el nombre de la empresa.
- Listar listasGETLista las listas de suscriptores de la cuenta, en entries, con id, nombre y los conteos de suscritos, sin confirmar y dados de baja. Solo vuelven los primeros 100; total_size trae el total.
- Listar suscriptoresGETLista los suscriptores de una lista, en entries, con id, email, nombre, estado, etiquetas, campos personalizados y fecha de suscripción. Solo vuelven los primeros 100, los más antiguos primero salvo que sort_order sea desc; total_size trae el total.
- Obtener suscriptorGETDevuelve un suscriptor de una lista con email, nombre, estado, etiquetas, campos personalizados, ubicación y los mensajes de seguimiento ya enviados.
- Crear suscriptorPOSTAgrega un suscriptor a una lista, lo que inicia la serie de seguimiento de la lista. Un email que ya está en la lista devuelve 400, salvo que update_existing sea true. Agrega personas de a una: agregar en masa por la API incumple los términos de AWeber.
- Actualizar suscriptorPATCHCambia el suscriptor de una lista que tiene el email indicado. Poner status en unsubscribed detiene los correos al suscriptor; las etiquetas aceptan una lista add y otra remove.
- Listar broadcastsGETLista los broadcasts de una lista en un estado, en entries: borradores creados por la API, programados por hora de envío o enviados por fecha de envío. Solo vuelven los primeros 100; total_size trae el total.
- Obtener broadcastGETDevuelve un broadcast con asunto, contenido, estado, programación, URL de archivo y, una vez enviado, sus estadísticas.
- Crear broadcastPOSTCrea un broadcast como borrador para la lista; no se envía nada hasta Schedule broadcast. La respuesta trae el broadcast_id.
- Actualizar broadcastPUTCambia un broadcast en borrador. Solo se pueden cambiar borradores creados por la API.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/aweber, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de AWeber
¿Necesito implementar la API de AWeber?
No. Connect ya trae 12 tools de AWeber 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 AWeber?
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.
