API-Referenz

Willkommen bei der itellicoAI API

Die itellicoAI REST (Representational State Transfer) API ermöglicht es dir, Agenten, Telefonnummern, Session Initiation Protocol (SIP)-Trunks, Gespräche und Analytik programmgesteuert zu verwalten.

Nutze diesen Bereich, wenn

Nutze die API-Dokumentation, wenn du Setups automatisieren, Geschäftssysteme synchronisieren, Agent-Workflows aus einer anderen App auslösen oder Daten außerhalb des Dashboards verwalten möchtest. Wenn du hauptsächlich im Produkt arbeitest, bleibst du meist in der Oberfläche; wenn du entwickelst oder technische Abläufe betreust, startest du hier.

Offizielle SDKs

Nutze die Python- oder TypeScript-SDKs für ein besseres Entwicklererlebnis

OpenAPI-Spezifikation

Sieh dir die vollständige OpenAPI-Spezifikation an

Wähle deine Integrationsmethode

SDKs (Empfohlen)
REST-API

Am besten für: Die meisten AnwendungenUnsere offiziellen Python- und TypeScript-SDKs bieten:

Typsicherheit mit Autovervollständigung
Automatische Authentifizierung
Strukturierte Fehlerbehandlung
Weniger Boilerplate-Code

SDK-Dokumentation ansehen →

Basis-URL

https://api.itellico.ai

Authentifizierung

Alle API-Endpunkte erfordern eine Authentifizierung mit einem API-Schlüssel, der im X-API-Key-Header übergeben wird:

curl -H "X-API-Key: your-api-key" https://api.itellico.ai/v1/accounts/current

Die meisten Ressourcen-Endpunkte sind Account-spezifisch. Rufe zuerst /v1/accounts/current auf und verwende dann die zurückgegebene id des Accounts in Pfaden wie /v1/accounts/{account_id}/agents. Endpunkte, die eine Account-ID akzeptieren, akzeptieren auch me für den aktuellen Account.

Erfahre in der API-Schlüssel-Dokumentation, wie du API-Schlüssel erstellst und verwaltest.

Wichtige Ressourcen

Die API ist in diese wichtigsten Ressourcen gegliedert:

Accounts - Verwalte deine Accounts und Subaccounts
Agenten - Erstelle und konfiguriere KI-Sprachagenten
Anbieter - Greife auf verfügbare Modelle, Transkribierer und Stimmen zu
Telefonnummern - Verwalte Telefonnummern für eingehende und ausgehende Anrufe
SIP-Trunks - Konfiguriere das SIP-Carrier-Routing für importierte Nummern, einschließlich Connect Your Own-Setups (manchmal als BYOC abgekürzt)
Gespräche - Greife auf den Gesprächsverlauf und die Details zu
Analytik - Verfolge Nutzungsmetriken und Leistungsdaten

Erste Schritte

API-Schlüssel erstellen

API-Schlüssel erstellen in deinem Dashboard

Authentifizierung prüfen

Sende deine erste Anfrage, um die Authentifizierung zu überprüfen:

curl
Python
TypeScript

curl -H "X-API-Key: sk-your-api-key" \
  https://api.itellico.ai/v1/accounts/current

from itellicoai import Itellicoai

client = Itellicoai(api_key="sk-your-api-key")
account = client.accounts.retrieve_current()
print(account.name)

import Itellicoai from 'itellicoai';

const client = new Itellicoai({ apiKey: 'sk-your-api-key' });
const account = await client.accounts.retrieveCurrent();
console.log(account.name);

Endpunkte erkunden

Durchsuche die Endpunkt-Dokumentation in der Seitenleiste

Häufige Aktionen

Agenten auflisten

curl
Python
TypeScript

curl -H "X-API-Key: sk-your-api-key" \
  https://api.itellico.ai/v1/accounts/{account_id}/agents

agents = client.agents.list("account_id")
for agent in agents.items:
    print(f"{agent.name} - {agent.id}")

const agents = await client.agents.list('account_id');
agents.items.forEach(agent => {
  console.log(`${agent.name} - ${agent.id}`);
});

Gespräche auflisten

curl
Python
TypeScript

curl -H "X-API-Key: sk-your-api-key" \
  https://api.itellico.ai/v1/accounts/{account_id}/conversations

conversations = client.accounts.list_conversations("account_id", limit=10)
for conversation in conversations.items:
    print(f"Status: {conversation.status}")
    print(f"Duration: {conversation.duration_seconds}s")

const conversations = await client.accounts.listConversations('account_id');
conversations.items.forEach(conversation => {
  console.log(`Status: ${conversation.status}`);
  console.log(`Duration: ${conversation.duration_seconds}s`);
});

Einen ausgehenden Anruf auslösen

curl -X POST https://api.itellico.ai/v1/accounts/{account_id}/calls \
  -H "X-API-Key: sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "phone",
    "agent_id": "agent-uuid",
    "from_number": "+43720123456",
    "to_number": "+4312345678"
  }'

Erste Schritte

Accounts

Subaccounts

Agents

Providers

Phone Numbers

SIP Trunks

Calls

Conversations

Analytics

API-Referenz

Willkommen bei der itellicoAI API

Nutze diesen Bereich, wenn

Offizielle SDKs

OpenAPI-Spezifikation

Wähle deine Integrationsmethode

Basis-URL

Authentifizierung

Wichtige Ressourcen

Erste Schritte

Häufige Aktionen

Agenten auflisten

Gespräche auflisten

Einen ausgehenden Anruf auslösen

Erste Schritte

Accounts

Subaccounts

Agents

Providers

Phone Numbers

SIP Trunks

Calls

Conversations

Analytics

​Willkommen bei der itellicoAI API

​Nutze diesen Bereich, wenn

Offizielle SDKs

OpenAPI-Spezifikation

​Wähle deine Integrationsmethode

​Basis-URL

​Authentifizierung

​Wichtige Ressourcen

​Erste Schritte

​Häufige Aktionen

​Agenten auflisten

​Gespräche auflisten

​Einen ausgehenden Anruf auslösen

Willkommen bei der itellicoAI API

Nutze diesen Bereich, wenn

Wähle deine Integrationsmethode

Basis-URL

Authentifizierung

Wichtige Ressourcen

Erste Schritte

Häufige Aktionen

Agenten auflisten

Gespräche auflisten

Einen ausgehenden Anruf auslösen