Email marketing
Brevo en tu producto y en tus agentes de IA, con una API
El toolkit de Brevo cubre contactos, listas de contactos, campañas de email y emails transaccionales. Tu cliente conecta su cuenta de Brevo una vez con una API key, y tu producto o agente de IA llama a cada operación a través de Connect, que guarda las credenciales y registra cada ejecución, sin que construyas y mantengas la integración.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/brevo_create_contact/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"email": "<email>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Brevo.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Brevo. 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 Brevo.
Sincroniza contactos del CRM con Brevo
Crea o actualiza un contacto, con updateEnabled, y agrégalo a las listas correctas cuando un lead cambie en tu CRM.
Lanza campañas desde tu app
Crea un borrador de campaña de email a partir de HTML o de una plantilla, prográmalo con scheduledAt y envíalo sin salir de tu producto.
Agente envía emails de pedido
Un agente de IA envía un email transaccional con el id de una plantilla y lee el messageId para confirmar que el envío fue aceptado.
Tools
12 tools de Brevo
- Listar contactosGETLista los contactos, del más reciente al más antiguo por defecto, con filtro opcional por lista, fecha o atributo. La respuesta trae contacts y count; pagina con limit y offset.
- Obtener contactoGETDevuelve un contacto con sus atributos, listas y las estadísticas de campañas de los últimos 90 días.
- Crear contactoPOSTCrea un contacto. Envía email, o el atributo SMS, o ext_id. Con updateEnabled en true, un contacto existente con el mismo identificador se actualiza en lugar de fallar.
- Actualizar contactoPUTActualiza un contacto. Solo cambian los campos enviados: listIds agrega el contacto a listas y unlinkListIds lo quita de listas.
- Listar listas de contactosGETLista las listas de contactos con id, name, folderId y suscriptores únicos. La respuesta trae lists y count; pagina con limit y offset.
- Crear lista de contactosPOSTCrea una lista de contactos vacía en una carpeta y devuelve su id.
- Listar campañas de emailGETLista las campañas de email, de la más reciente a la más antigua por defecto. La respuesta trae campaigns y count; pagina con limit y offset. Las estadísticas solo vienen cuando se envía statistics.
- Obtener campaña de emailGETDevuelve una campaña de email con su configuración, destinatarios y estadísticas del informe.
- Crear campaña de emailPOSTCrea una campaña de email como borrador y devuelve su id. Envía el contenido en exactamente uno de htmlContent, htmlUrl o templateId. Definir scheduledAt programa el envío, y entonces recipients es obligatorio.
- Actualizar campaña de emailPUTActualiza una campaña de email en borrador o programada. Solo cambian los campos enviados. Definir scheduledAt programa el envío.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Brevo
¿Necesito implementar la API de Brevo?
No. Connect ya trae 12 tools de Brevo 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 Brevo?
Con el modo que acepta el toolkit: Clave de API. 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.
