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

# Erste Schritte mit der telli API

> Starte mit der telli API: authentifiziere dich mit deinem API-Schlüssel, erkunde die Endpunkte und lade die OpenAPI-Spezifikationen herunter

Die telli API ist eine REST-API mit JSON-Request- und -Response-Bodies. Mit ihr verwaltest du Kontakte und Kontakteigenschaften, löst Anrufe aus und planst sie, rufst Anrufergebnisse ab und arbeitest mit Agenten und Telefonnummern. Für Anruf-Events in Echtzeit kombinierst du sie mit [Webhooks](/de/webhooks).

Wenn du lieber ohne Code integrierst, verbindet sich telli auch mit CRMs und Automatisierungsplattformen. Sieh dir dazu den [Integrationsüberblick](/de/integrations-overview) an.

<Tip>
  **Authentifizierung**

  Alle Endpunkte authentifizieren sich mit einem API-Schlüssel aus der telli App (Einstellungen > Entwickler), gesendet als Bearer-Token:

  ```bash theme={null}
  Authorization: Bearer <your-api-key>
  ```
</Tip>

## OpenAPI-Spezifikation

Alle Endpunkte in dieser Referenz werden aus den OpenAPI-Dateien der API generiert. Lade sie herunter, um Client-Bibliotheken zu generieren, die API in Tools wie Postman zu importieren oder Coding-Agents maschinenlesbaren API-Kontext mitzugeben:

| Spezifikation | Umfasst                                                                                     | Download                                                                         |
| ------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| V2 API        | Kontakte, Kontakteigenschaften und Agenten sowie die [Webhook](/de/webhooks)-Event-Payloads | [https://docs.telli.com/openapi-v2.json](https://docs.telli.com/openapi-v2.json) |
| V1 API        | Anrufe und Telefonnummern sowie die veralteten Kontakt-Endpunkte                            | [https://docs.telli.com/openapi.json](https://docs.telli.com/openapi.json)       |

Kontakt-Endpunkte existieren in beiden Versionen. Nutze V2 für neue Integrationen und sieh dir die [Migrationsanleitung](/de/v2-migration-guide) an, falls du noch die veralteten V1-Kontakt-Endpunkte verwendest.

## Basis-URLs

| Service                            | Basis-URL                                              |
| ---------------------------------- | ------------------------------------------------------ |
| API                                | [https://api.telli.com](https://api.telli.com)         |
| [MCP-Server](/de/integrations/mcp) | [https://mcp.telli.com/mcp](https://mcp.telli.com/mcp) |
| telli App                          | [https://app.telli.com](https://app.telli.com)         |