API & MCP-Server

Kategorie: Integrationen & API · Aktualisiert am 29.05.2026

voiceOne lässt sich in Ihre bestehenden Systeme einbinden – per Webhook, API und über den neuen MCP-Server.

Verfügbare Schnittstellen

Im Bereich System-Schnittstellen verbinden Sie voiceOne unter anderem mit:

• Telefonie & SIP-Trunk
• Kalender (CalDAV) für Terminbuchungen
• E-Mail / SMTP für Benachrichtigungen
• CRM & Google Contacts
• ERP / Warenwirtschaft
• API & Webhooks für eigene Tools
• Automatisierung über n8n

Eigene Tools per Webhook

Ihr KI-Agent kann während eines Anrufs externe Systeme aufrufen (z. B. eine Verfügbarkeitsprüfung oder Objektsuche) und die Antwort direkt im Gespräch verwenden.

API-Integrationen

voiceOne bietet umfassende API-Schnittstellen für die nahtlose Integration in Ihre bestehende Systemlandschaft. Die folgenden Webhooks lassen sich direkt aus einem Telefonanruf heraus auslösen.

E-Mail-Webhook für Anrufe

Der E-Mail-Webhook ermöglicht es, direkt aus einem Telefonanruf heraus E-Mails zu versenden. Das ist besonders nützlich für automatische Terminbestätigungen oder Follow-up-E-Mails.

• Base URL: https://app.voice-one.ai
• Endpoint: POST /api/email/send-from-call
• Vollständige URL: https://app.voice-one.ai/api/email/send-from-call
• Authentifizierung: keine zusätzliche Authentifizierung erforderlich (intern)

Webhook-Parameter-Konfiguration für KI-Agenten

Für die korrekte Konfiguration der E-Mail-Funktion in Ihren KI-Agenten verwenden Sie folgende JSON-Struktur:

[
  {
    "knownValue": "KNOWN_PARAM_CALL_ID",
    "name": "callId"
  },
  {
    "description": "E-Mail-Adresse des Empfängers",
    "name": "recipientEmail",
    "required": true
  },
  {
    "name": "templateName",
    "value": "Test-Call"
  },
  {
    "description": "Name des Empfängers",
    "name": "variables.name",
    "required": false
  },
  {
    "required": false,
    "description": "Firma",
    "name": "variables.company"
  },
  {
    "name": "variables.street",
    "description": "Straße und Hausnummer",
    "required": false
  },
  {
    "required": false,
    "description": "Postleitzahl",
    "name": "variables.postal_code"
  },
  {
    "description": "Stadt/Ort",
    "required": false,
    "name": "variables.city"
  },
  {
    "description": "Telefonnummer",
    "name": "variables.phone",
    "required": false
  },
  {
    "name": "variables.notes",
    "description": "Zusätzliche Notizen",
    "required": false
  }
]

Verfügbare Variablen für E-Mail-Templates

• {{name}} – Name des Empfängers
• {{company}} – Firma
• {{street}} – Straße
• {{postal_code}} – Postleitzahl
• {{city}} – Ort
• {{customer_number}} – Kundennummer
• {{notes}} – Notizen / Anmerkungen
• {{date}} – Datum
• {{time}} – Uhrzeit
• {{duration}} – Dauer in Minuten
• {{phone}} – Telefonnummer

Erfolgsantwort (200 OK)

{
  "success": true,
  "message": "Email sent to kunde@example.com",
  "callId": "unique-call-id",
  "template": "calendarBookingCustomer"
}

Fehlerantworten

• 400 Bad Request – fehlende Pflichtfelder
• 404 Not Found – Benutzer oder Template nicht gefunden
• 500 Internal Server Error – SMTP-Fehler

Voraussetzungen

• Der Benutzer muss in Firebase existieren.
• Eine E-Mail-Konfiguration muss in den Einstellungen hinterlegt sein.
• Die SMTP-Einstellungen müssen korrekt konfiguriert sein.

Integration in Anrufe: Um den Webhook aus einem KI-Anruf zu triggern, verwenden Sie die HTTP-Request-Funktion im Agent-Prompt oder Workflow.

SMS-Webhook für Anrufe

Der SMS-Webhook ermöglicht es, direkt aus einem Telefonanruf heraus SMS zu versenden. Ideal für kurze Bestätigungen, Links oder wichtige Informationen.

• Base URL: https://app.voice-one.ai
• Endpoint: POST /api/sms/send-from-call
• Vollständige URL: https://app.voice-one.ai/api/sms/send-from-call
• Authentifizierung: keine zusätzliche Authentifizierung erforderlich (intern)

Webhook-Parameter-Konfiguration für SMS in KI-Agenten

Verwenden Sie folgende JSON-Struktur für die SMS-Funktion:

[
  {
    "knownValue": "KNOWN_PARAM_CALL_ID",
    "name": "callId"
  },
  {
    "name": "recipientPhone",
    "required": true,
    "description": "Telefonnummer des Empfängers"
  },
  {
    "value": "custom",
    "name": "messageTemplate"
  },
  {
    "name": "message",
    "value": "Hallo {{name}}, hier ist der Link für die Terminbuchung: https://voice-one.ai/kontakt.html",
    "description": "SMS-Nachricht. Wenn 'value' angegeben ist, wird dieser Text verwendet. Wenn nur 'description' ohne 'value', generiert der Agent den Inhalt basierend auf dem Gespräch.",
    "required": false
  },
  {
    "value": "voiceOne",
    "name": "sender"
  },
  {
    "required": false,
    "description": "Name für die Variable {{name}}",
    "name": "variables.name"
  }
]

Verfügbare Template-Typen

• custom – freier Text mit Variablen-Ersetzung
• appointment – vordefinierte Terminbestätigung
• followup – Nachfass-SMS nach dem Gespräch

Variablen-Ersetzung in SMS

Der SMS-Text unterstützt folgende Variablen-Formate:

• {{variable}} – doppelte geschweifte Klammern (empfohlen)
• ${variable} – Dollar mit geschweiften Klammern
• $variable – nur Dollar-Zeichen

Beispiel mit mehreren Variablen:

{
  "name": "message",
  "value": "Hallo {{name}}, Ihr Termin am {{date}} um {{time}} wurde bestätigt. Adresse: {{address}}"
}

Erfolgsantwort (200 OK)

{
  "success": true,
  "message": "SMS erfolgreich gesendet",
  "details": {
    "recipient": "+491234567890",
    "sender": "voiceOne",
    "message_length": 85,
    "sms_count": 1,
    "estimated_cost": "0.04€",
    "template_used": "custom"
  }
}

Kontakt-API

Externe Systeme können Kontaktdaten an voiceOne übermitteln.

• Base URL: https://app.voice-one.ai
• Endpoint: POST /api/integration/contacts
• Vollständige URL: https://app.voice-one.ai/api/integration/contacts
• Authentifizierung: API-Schlüssel im Header X-API-Key

Request-Format

{
  "name": "Musterfirma GmbH",
  "email": "kontakt@musterfirma.de",
  "phone_number": "+49301234567",
  "company": "Musterfirma GmbH",
  "street": "Musterstraße 1",
  "city": "Berlin",
  "zip": "10115",
  "industry": "IT",
  "website": "https://www.musterfirma.de",
  "notes": "Erster Kontakt über API."
}

MCP-Server

Mit dem MCP-Server (Model Context Protocol) wird voiceOne direkt aus KI-Tools wie ChatGPT, Claude Desktop oder Cursor heraus nutzbar. Damit ist voiceOne der erste KI-Telefonassistent, der sich nativ in Ihren KI-Workflow einklinkt.