Autenticación

Las integraciones se autentican con un Service Account: una credencial creada dentro de tu cuenta, con permisos y vigencia propios. Usa el flujo OAuth 2.0 client_credentials, y cada solicitud lleva un token Bearer.

1. Crea un Service Account

  1. En el CRM, abre Configuración › Service Accounts (solo administradores) y haz clic en Novo service account.
  2. Ponle un nombre, elige la vigencia (90 días, 6 meses, 1 año o sin vencimiento) y selecciona los permisos que podrá usar. Empieza por el mínimo que la integración necesita.
  3. Copia el Client ID y el Client Secret. El secret se muestra una sola vez; si lo pierdes, genera otro en la misma pantalla.

2. Solicita un token

Request
curl -X POST https://magnetcustomer.net/realms/platform/protocol/openid-connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"
Response
{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "expires_in": 900,
  "token_type": "Bearer"
}

El token dura 15 minutos. Lee expires_in (segundos) de la respuesta y solicita uno nuevo antes de que venza; este flujo no tiene refresh token.

3. Llama a la API

Cada cuenta tiene su dirección. Cambia tu-cuenta por el subdominio de tu cuenta, el mismo que usas para abrir el CRM.

Base URL
https://tu-cuenta.platform-api.magnetcustomer.com/api
cURL
curl "https://tu-cuenta.platform-api.magnetcustomer.com/api/contacts?page=1&limit=25" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Permisos

Un Service Account solo hace lo que sus permisos habilitan, recurso por recurso. Una solicitud fuera de ellos devuelve 403. Para cambiar lo que la integración puede hacer, edita el Service Account: no hay parámetro de alcance que enviar en la solicitud de token.

Vigencia y rotación

  • El CRM avisa a los administradores cuando una credencial está por vencer. Renuévala en la pantalla de Service Accounts antes de la fecha.
  • Generar un nuevo secret invalida el anterior. Actualiza la integración enseguida.
  • Usa un Service Account por integración, para poder revocar uno sin detener los demás.
  • Guarda el secret en el servidor. Nunca lo pongas en un navegador ni en una aplicación móvil.

¿Venías de Clientes OAuth?

La antigua pantalla de Clientes OAuth fue desactivada y sus credenciales se están cerrando. Crea un Service Account con los permisos que la integración necesita y cambia el Client ID y el Client Secret: la dirección del token y las de la API siguen siendo las mismas.