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

# Introducción

> Integra Sofia Chat con tu CRM, ERP o cualquier sistema mediante la API pública v1: URL base, formato y tu primer request.

Todo lo que necesitas para integrar Sofia Chat con tu CRM, ERP o cualquier sistema: envía mensajes de WhatsApp, consulta conversaciones, sincroniza contactos y lanza campañas sin pasar por el panel. Aquí están los conceptos; la [Referencia de API](/referencia-de-api/introduccion) tiene cada endpoint con su esquema y un cliente para probarlo.

| Campo                  | Valor                                                                                                                                         |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| URL base               | `https://api-v2.sofiachat.com/api/v1`                                                                                                         |
| Autenticación          | Header `X-API-Key` (ver [Autenticación](/desarrolladores/autenticacion))                                                                      |
| Formato                | JSON (UTF-8) en cuerpo de petición y respuesta. `Content-Type: application/json`                                                              |
| Zona horaria           | Todas las fechas son ISO 8601 en UTC (`2026-08-25T03:14:16.549Z`)                                                                             |
| Referencia interactiva | [Referencia de API](/referencia-de-api/introduccion) — el esquema completo, generado desde OpenAPI, con un cliente para probar cada endpoint. |

<Note>La API v1 es independiente del panel: usa métodos REST estándar (`GET`, `POST`, `PATCH`, `DELETE`) y no requiere sesión de usuario. Esta guía cubre autenticación, formato, errores y un tutorial de campaña; el listado de endpoints, campos y respuestas de ejemplo vive en la [Referencia de API](/referencia-de-api/introduccion).</Note>

## Primer request en 30 segundos

Este es el endpoint `GET /v1/me`: devuelve la organización de la key, el plan con límites y consumo, y los datos de la propia key.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api-v2.sofiachat.com/api/v1/me \
    -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  ```

  ```javascript Node theme={null}
  const res = await fetch("https://api-v2.sofiachat.com/api/v1/me", {
    headers: { "X-API-Key": process.env.KEY },
  });
  const data = await res.json();
  console.log(data);
  ```

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

  res = requests.get(
      "https://api-v2.sofiachat.com/api/v1/me",
      headers={"X-API-Key": KEY},
  )
  data = res.json()
  ```
</CodeGroup>

```json Respuesta theme={null}
{
  "data": {
    "organization": { "id": 3, "name": "Mi Empresa", "type": "production" },
    "plan": {
      "name": "Growth",
      "limits": { "conversations": 5000, "users": 10, "departments": 3, "integrations": 3, "tools": 10 },
      "usage":  { "conversations": 1240, "users": 6,  "departments": 1, "integrations": 2, "tools": 4 }
    },
    "apiKey": { "id": 7, "name": "Integración CRM", "scopes": ["read","write"], "expiresAt": null }
  }
}
```

Ábrelo en la [Referencia de API](/referencia-de-api/introduccion) para probarlo con tu key.