Configuraciones de la cuenta

Tokens de acceso personal

Por qué es importante

Los tokens de acceso personal permiten que sus scripts, integraciones y herramientas se autentiquen en la API sin usar su contraseña. Cada token solo lleva los permisos (ámbitos) que le otorgue y puede revocarse en cualquier momento.

Como un token es limitado y revocable, es más seguro que compartir su contraseña: usted decide exactamente qué puede hacer cada integración y puede cortar el acceso al instante sin cambiar sus propias credenciales.

Función en beta

Los tokens de acceso personal están actualmente en beta. Las pantallas y las opciones pueden cambiar.

Para qué sirve un token

Un token de acceso personal es lo que permite que algo distinto de la aplicación web actúe sobre su cuenta a través de la API. Usos habituales:

Conectar su propia aplicación o sitio web - sincronizar los nuevos registros en una lista de contactos, o activar un correo electrónico cuando alguien completa una acción.
Automatizar tareas rutinarias - ejecutar un script programado que importe contactos, actualice segmentos o exporte informes.
Enviar correos electrónicos transaccionales a través de la API - usar la Email API desde su back end para recibos, restablecimientos de contraseña y notificaciones.
Conectar herramientas no-code y de integración - autenticar un flujo de trabajo en una herramienta que pide un token de API.
Crear y probar integraciones - los desarrolladores usan un token limitado durante el desarrollo y luego uno más restringido en producción.

En resumen: siempre que una herramienta le pida un token o una clave de API para conectarse a su cuenta, un token de acceso personal es lo que usted crea y pega — en lugar de entregar su contraseña.

Abrir los tokens de acceso personal

En el menú de la izquierda, abra Ajustes.
Bajo el encabezado Developer, haga clic en Tokens de acceso personal.

La página lista sus tokens e indica cuántos ha creado con respecto a su límite (por ejemplo, 1 / 25 tokens).

Crear un token

Haga clic en Crear token en la parte superior derecha.
Escriba un Nombre del token que describa dónde se usará el token (por ejemplo, Mi Integración). Un nombre claro facilita distinguir los tokens más adelante.
Elija un Vencimiento: Nunca, 30 días, 60 días, 1 año o Personalizado.
Conceda los permisos. Elija un preajuste en Empezar desde una plantilla — Solo lectura (todo), Acceso completo, Gestor de campañas, Gestor de contactos o Desarrollador — o despliegue los grupos de ámbitos (Audiencia, Supresiones, Campañas, Plantillas, Email API, Formularios, Entregabilidad, Webhooks, Análisis, Cuenta) y marque exactamente lo que el token necesita.
Haga clic en Crear.

La ventana Crear token con el campo Nombre del token, las opciones de Vencimiento, las plantillas y los grupos de ámbitos

Copie su token de inmediato

Copie el token en cuanto se cree y guárdelo en un lugar seguro — trátelo como una contraseña. Nunca lo suba a un control de versiones ni lo comparta en texto plano. Si un token queda expuesto, revóquelo y cree uno nuevo.

Entender los ámbitos

Los ámbitos definen lo que un token puede hacer. Conceda solo los ámbitos que una integración realmente necesita — así limita el daño si el token se filtra (principio de mínimo privilegio).

Los ámbitos se agrupan por área, y la fila de cada token resume a qué puede acceder (por ejemplo, Audience · 20, Suppressions · 3, Campaigns · 7). Los preajustes Empezar desde una plantilla aplican rápidamente un conjunto de ámbitos habitual:

Solo lectura (todo) - solo lectura en todas las áreas, sin hacer cambios.
Acceso completo - todos los ámbitos; úselo con moderación.
Gestor de campañas - centrado en el trabajo de campañas.
Gestor de contactos - centrado en audiencias y contactos.
Desarrollador - un conjunto orientado a desarrolladores para crear integraciones.

Gestionar sus tokens

La lista de tokens muestra para cada uno su Nombre, sus Ámbitos, su Estado, la fecha de creación (Creado) y la fecha de vencimiento (Vence). Use las pestañas para filtrar por estado: Activo, Revocado, Expirado o Todos.

Cada fila ofrece acciones para:

Ver los detalles y los ámbitos del token.
Editar el token (por ejemplo, renombrarlo o ajustar sus ámbitos).
Eliminar / revocar el token, lo que lo invalida de inmediato.

Rote y depure con regularidad

Asigne un token distinto a cada integración, revise la lista de vez en cuando y revoque cualquier token que ya no reconozca o no use. Un token por integración le permite revocar uno solo sin romper los demás.