Integraciones y API keys
Una integración identifica la aplicación que conectas con Sendiro. Sus claves de API permiten actuar dentro de un workspace con permisos definidos, sin usar la sesión personal de alguien del equipo.
Abre Configuración → Desarrolladores. Los permisos Ver integraciones y diagnóstico, Configurar integraciones y webhooks y Administrar claves API controlan el acceso a estas herramientas. El perfil Desarrollador incluye la configuración técnica, dominios y remitentes, estado de envío y consumo. El acceso directo a contactos, difusiones, automatizaciones, equipo y facturación se asigna por separado.
Crea primero la integración
En Crear integración, escribe un nombre reconocible y selecciona sus permisos. Por ejemplo, una sincronización que solo consulta contactos no necesita permiso para enviar correos ni eliminar contactos.
Los permisos de la integración definen el máximo que podrán tener sus claves. Quien puede configurar integraciones elige ese alcance entre los permisos disponibles para la API, aunque no tenga acceso a las mismas funciones en el dashboard. Así, un desarrollador puede configurar el envío transaccional de una aplicación sin acceder a los contactos desde las pantallas de Sendiro.
Administrar claves permite elegir permisos dentro del alcance de la integración, sin ampliarlo. Es un acceso sensible: permite obtener credenciales que la aplicación puede utilizar. Elige únicamente los permisos que necesita la conexión.
Emite y guarda la clave
- En Crear clave de API, elige la integración.
- Añade un nombre que te permita identificar al sistema que la usará.
- Selecciona los permisos necesarios dentro de los permitidos por la integración.
- Crea la clave y usa Copiar clave para guardarla en el almacén de secretos de tu aplicación.
El secreto se muestra en el resultado de creación y no vuelve a aparecer en el listado. Si lo pierdes, crea una clave de reemplazo. El listado conserva su nombre, prefijo, estado y permisos para ayudarte a reconocerla.
No incluyas la clave en código del navegador, repositorios, imágenes ni mensajes compartidos. Quien la tenga puede realizar las operaciones que autoricen sus permisos.
Sustituye o revoca una clave
Para rotarla, crea una nueva clave, actualiza la aplicación que la utiliza y comprueba su funcionamiento. Después revoca la anterior desde su detalle.
Revocar impide nuevas operaciones autorizadas con esa clave. No deshace operaciones ya completadas ni confirma la cancelación de un envío que ya haya comenzado.
Una integración y sus claves pertenecen al workspace. Suspender a su creador no las elimina ni cancela trabajo aceptado: revoca explícitamente la clave o deshabilita la integración cuando corresponda. Cada nueva operación vuelve a comprobar el estado de la clave, el techo vigente de su integración y los scopes permitidos para credenciales de máquina. Reducir ese techo bloquea futuras operaciones que lo excedan; no borra credenciales de forma implícita. Sus permisos no administran equipo o facturación ni sustituyen cuota, consentimiento o remitentes autorizados.
El diagnóstico técnico muestra metadatos acotados; no concede acceso a destinatarios, contenido o payloads sensibles. Recuperar un trabajo es otra capacidad, con posibles efectos sobre envíos y datos, y requiere también autorización para esos efectos.
Consulta eventos y conoce el alcance de la pantalla
La página muestra eventos de automatización cuando tienes permiso para ver actividad individual. El perfil Desarrollador no lo incluye. No confundas esos eventos externos con los eventos de entrega de un correo, que puedes consultar mediante la API durante la beta.
La sección Webhooks todavía no incluye un formulario de configuración. Su administración está disponible mediante la API con sesión de usuario; no es una operación que se configure desde esta pantalla ni una capacidad administrativa de las claves de integración.