> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido

> Realiza tu primera integración con la API de Yampi.ai en minutos

## Comienza en tres pasos

Integra Yampi.ai con tus sistemas y automatiza tus procesos inmobiliarios siguiendo estos pasos simples.

### Paso 1: Obtén tu token de acceso

Para autenticarte con la API de Yampi.ai, necesitas un token de acceso. Este token se encuentra en tu perfil de usuario.

<Steps>
  <Step title="Accede a tu perfil">
    1. Inicia sesión en [Yampi.ai](https://app.yampi.ai)
    2. Navega a tu perfil de usuario desde el menú lateral izquierdo (menú de usuario en la esquina inferior izquierda)
    3. Desplázate hasta la sección "Token de acceso API"
    4. Copia tu token de acceso

    <Warning>
      Mantén tu token de acceso seguro y nunca lo compartas públicamente. Si crees que tu token ha sido comprometido, regenera uno nuevo desde tu perfil.
    </Warning>
  </Step>

  <Step title="Guarda tu token de forma segura">
    Almacena tu token como variable de entorno o en un gestor de contraseñas:

    ```bash theme={null}
    export YAMPI_API_TOKEN="tu_token_aqui"
    ```

    <Tip>
      En producción, usa variables de entorno o un gestor de secretos. Nunca hardcodees tokens en tu código fuente.
    </Tip>
  </Step>
</Steps>

### Paso 2: Realiza tu primera llamada

Ahora que tienes tu token, puedes hacer tu primera llamada a la API. La URL base de la API es `https://app.yampi.ai/api/v1`.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://app.yampi.ai/api/v1/accounts/{account_id}' \
    -H 'api_access_token: tu_token_aqui'
  ```
</RequestExample>

<CodeGroup>
  ```javascript Node.js theme={null}
  const response = await fetch('https://app.yampi.ai/api/v1/accounts/{account_id}', {
    headers: {
      'api_access_token': process.env.YAMPI_API_TOKEN,
      'Content-Type': 'application/json'
    }
  });

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  headers = {
      'api_access_token': 'tu_token_aqui',
      'Content-Type': 'application/json'
  }

  response = requests.get(
      'https://app.yampi.ai/api/v1/accounts/{account_id}',
      headers=headers
  )

  print(response.json())
  ```

  ```php PHP theme={null}
  <?php
  $ch = curl_init();

  curl_setopt($ch, CURLOPT_URL, 'https://app.yampi.ai/api/v1/accounts/{account_id}');
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'api_access_token: tu_token_aqui',
      'Content-Type: application/json'
  ]);

  $response = curl_exec($ch);
  curl_close($ch);

  echo $response;
  ?>
  ```
</CodeGroup>

<Info>
  Reemplaza `{account_id}` con el ID de tu cuenta. Puedes encontrar este ID en la URL cuando estás navegando en la aplicación web de [Yampi.ai](http://Yampi.ai) o al final de la página de tu perfil de usuario.
</Info>

### Paso 3: Explora los endpoints disponibles

Una vez que hayas realizado tu primera llamada exitosa, puedes explorar todos los endpoints disponibles para integrar diferentes funcionalidades.

<ResponseExample>
  ```json Success theme={null}
  {
    "id": 1,
    "name": "Mi Inmobiliaria",
    "domain": "mi-inmobiliaria",
    "created_at": "2024-01-15T10:30:00Z"
  }
  ```
</ResponseExample>

<CardGroup cols={2}>
  <Card title="Contactos" icon="users" href="/api-reference/introduction">
    Gestiona propietarios, inquilinos y leads mediante la API de contactos.
  </Card>

  <Card title="Propiedades" icon="building" href="/api-reference/introduction">
    Administra tu catálogo de propiedades, precios y condiciones.
  </Card>

  <Card title="Conversaciones" icon="comments" href="/api-reference/introduction">
    Integra el sistema de mensajería y comunicación unificada.
  </Card>

  <Card title="Tesorería" icon="wallet" href="/api-reference/introduction">
    Automatiza pagos, suscripciones y dispersiones financieras.
  </Card>
</CardGroup>

## Próximos pasos

Ahora que has realizado tu primera integración, explora estas funcionalidades:

<CardGroup cols={2}>
  <Card title="Referencia completa de API" icon="book" href="/api-reference/introduction">
    Consulta todos los endpoints disponibles con ejemplos detallados.
  </Card>

  <Card title="Autenticación" icon="key" href="/api-reference/authentication">
    Aprende más sobre los diferentes tipos de tokens y permisos.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/api-reference/introduction">
    Configura notificaciones en tiempo real para eventos importantes.
  </Card>

  <Card title="Mejores prácticas" icon="lightbulb" href="/api-reference/introduction">
    Optimiza tus integraciones siguiendo nuestras recomendaciones.
  </Card>
</CardGroup>

<Note>
  ¿Necesitas ayuda? Consulta nuestra [documentación completa](/api-reference/introduction) o contacta a nuestro equipo de soporte.
</Note>