Herramientas para desarrolladores
Make en tu producto y en tus agentes de IA, con una API
El toolkit de Make cubre organizaciones, equipos, escenarios, logs de ejecución y ejecuciones incompletas de una zona de Make. Tu cliente conecta una vez con una API key, y tu producto o agente de IA llama cada operación a través de Connect, que guarda la credencial y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/make_activate_scenario/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"scenarioId": 1
}
}Cómo funciona
Del cliente conectado a la primera llamada a Make.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Make. 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 Make.
Disparar automatizaciones desde tu producto
Ejecuta el escenario de un cliente cuando algo ocurre en tu SaaS y espera el estado y las salidas con responsive true.
Controlar escenarios desde una pantalla de ajustes
Muestra los escenarios de un cliente, renómbralos y enciéndelos o apágalos, para que el usuario gestione automatizaciones sin abrir Make.
Recuperar ejecuciones fallidas con un agente
Deja que un agente de IA liste los logs y las ejecuciones incompletas de un escenario, lea el error y el módulo que lo causó y reintente la ejecución.
Tools
12 tools de Make
- Listar organizacionesGETLista las organizaciones del usuario, cada una con id y name. El id es el organizationId que piden las demás herramientas.
- Listar equiposGETLista los equipos de una organización, cada uno con id y name. El id es el teamId de List scenarios.
- Listar escenariosGETLista los escenarios de un equipo o de una organización completa: envía teamId u organizationId, nunca ambos. Cada elemento trae el id y el name del escenario.
- Obtener escenarioGETDevuelve los detalles de un escenario, como nombre, equipo, programación y si está activo.
- Actualizar escenarioPATCHRenombra un escenario. El nombre no tiene que ser único.
- Activar escenarioPOSTActiva un escenario para que se ejecute según su programación. Un escenario programado a intervalos regulares también se ejecuta de inmediato.
- Desactivar escenarioPOSTDesactiva un escenario, lo que detiene su programación y la ejecución en curso, si la hay.
- Ejecutar escenarioPOSTEjecuta un escenario activo ahora, lo que consume operaciones de la organización. Devuelve el executionId; con responsive true espera hasta 40 segundos y devuelve también el estado y las salidas del escenario. Una organización o equipo en pausa responde 429 con el código IM310.
- Listar logs del escenarioGETLista los logs de ejecución de un escenario, del más nuevo al más antiguo, cada uno con el id de la ejecución, estado, duración, operaciones y transferencia.
- Obtener ejecución del escenarioGETDevuelve el estado de una ejecución de un escenario, con las salidas del escenario, o el error y el módulo que lo causó.
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.
Al conectar, tu cliente también indica {zone}: la dirección de su cuenta en la API de la app.
Preguntas sobre el toolkit de Make
¿Necesito implementar la API de Make?
No. Connect ya trae 12 tools de Make 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 Make?
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.
