Skip to main content
Alcances para la API v1 (clave API): automatizaciones, asistentes, bases de conocimiento, MCP, HTTP tools, pipelines, sending pools y AI Web Widget admin.
Cada alcance desbloquea un tipo de operación en Automatizaciones. Use solo lo que su integración necesita.

​
Cómo enviar la clave

Recomendado
Alternativo
Cada clave API pertenece a un espacio de trabajo. No puede acceder a otro espacio de trabajo con la misma clave.

​
Combinaciones comunes

Solo enviar eventos

events:read, events:write

Solo lectura

events:read, automations:read

Construir flujos vía API

events:*, automations:*

Integración completa

events:read, events:write, automations:read, automations:write, assistants:read, assistants:write, assistants:invoke, knowledge_bases:read, knowledge_bases:write, mcp_connections:read, mcp_connections:write, http_tools:read, http_tools:write
Lista de alcances vacía al crear = acceso ADMIN (todo). En producción, restrinja siempre.

​
Eventos (events:*)

Listar y recuperar definiciones de eventos.
Crear, actualizar y eliminar eventos. Enviar evento para iniciar ejecuciones.

​
Automatizaciones (automations:*)

Listar automatizaciones, obtener detalles y listar ejecuciones.
Crear, actualizar, eliminar automatizaciones y detener una automatización en ejecución.

​
Asistentes (assistants:*)

Listar y obtener asistentes; listar bindings MCP y HTTP tool.
Crear, actualizar y eliminar asistentes; vincular/desvincular MCP y HTTP tools.
Invocar asistente en modo prueba (POST /v1/assistants/{id}/invoke) y leer historial del thread.

​
Bases de conocimiento (knowledge_bases:*)

Listar bases y documentos; obtener detalle con sourceText.
CRUD de bases y documentos (reindexación automática al cambiar texto).

​
MCP (mcp_connections:*)

Listar y obtener conexiones MCP del espacio de trabajo.
Crear, actualizar y eliminar conexiones; POST /v1/mcp-connections/{id}/refresh-manifest para CUSTOM_URL.OAuth Google/Microsoft para conectores curados sigue solo en el panel; vía API use CUSTOM_URL + bearerToken.

​
HTTP tools (http_tools:*)

Listar y obtener herramientas REST allowlist.
Crear, actualizar y eliminar HTTP tools.

​
Pipelines (pipelines:*)

Boards, overview, cards por contacto.
CRUD de boards, columnas, cards y movimientos.

​
Sending pools (sending_pools:*)

Listar pools, detalle y stats.
CRUD de pools y miembros (instancias WhatsApp).

​
AI Web Widget admin (ai_widgets:*)

Listar widgets y mensajes del add-on.
CRUD de widgets, rotate key/HMAC, duplicar.

​
Envíos dentro del flujo

Los pasos que envían WhatsApp, correo, SMS, etc. usan el mismo motor de envío que los canales. La clave necesita los alcances de envío correspondientes (whatsapp:send, email:send, sms:send, telegram:send, etc.).

​
Errores comunes

Detalles en Respuestas de error y la especificación Automatizaciones y eventos en el menú.

​
Próximos pasos