TrainerStudioDocs
GuiasEscalar

Automatiza con la API

Si usas un CRM, una web de captacion o cualquier otra herramienta externa, puedes conectarla con TrainerStudio a traves de la API. Esto te permite crear y gestionar clientes sin entrar en la aplicacion.

Crea una clave API

  1. Ve a Ajustes > Developers.
  2. Pulsa Crear clave API.
  3. Dale un nombre descriptivo (por ejemplo, "Mi CRM" o "Zapier").
  4. Copia la clave generada y guardala en un lugar seguro.

La clave API da acceso completo a tu cuenta. Tratala como una contrasena: no la compartas y revocala si sospechas que se ha comprometido.

Ejemplo completo: crear y archivar un cliente

El siguiente ejemplo muestra el flujo completo: crear un cliente nuevo y archivarlo cuando deje de entrenar contigo. Incluye la cabecera X-API-Key para autenticarte.

1. Crear un cliente
curl -X POST https://api.trainerstudio.io/coach/customers \
  -H "X-API-Key: ts_ak_tu_clave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Laura",
    "surname": "Garcia",
    "email": "laura@ejemplo.com"
  }'

# Respuesta:
# {
#   "_id": "663f1a2b4c...",
#   "name": "Laura",
#   "surname": "Garcia",
#   "email": "laura@ejemplo.com",
#   "role": "CUSTOMER",
#   "customerRoleData": {
#     "isArchived": false,
#     "customerType": "REAL"
#   },
#   "firstAccessToken": "3f09812a-..."
# }
#
# Guarda el _id para gestionar este cliente despues.
2. Archivar el cliente
# Usa el _id devuelto en el paso anterior.
# El cliente dejara de aparecer en tu lista activa pero no se elimina.

curl -X PUT https://api.trainerstudio.io/coach/customers/archive \
  -H "X-API-Key: ts_ak_tu_clave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "663f1a2b4c..."
  }'

Revoca una clave

Si ya no necesitas una clave o crees que se ha filtrado:

  1. Ve a Ajustes > Developers.
  2. Pulsa el icono de papelera junto a la clave.
  3. Confirma la revocacion.

Las integraciones que usen esa clave dejaran de funcionar inmediatamente.

Casos de uso

  • CRM: Crea clientes automaticamente cuando un lead se convierte en tu CRM.
  • Formulario web: Conecta tu formulario de alta con TrainerStudio via Zapier o Make.
  • Baja automatica: Archiva clientes cuando cancelen su suscripcion en tu pasarela de pago.

On this page