fonio API und Webhooks: Möglichkeiten und Grenzen

Warum die Anbindung über Erfolg oder Frust entscheidet

fonio.ai nimmt deine Anrufe an, qualifiziert sie und transkribiert jedes Gespräch. Den eigentlichen Wert entfaltet der Voice Agent aber erst, wenn die Ergebnisse dort landen, wo du wirklich arbeitest: im CRM, in der Warenwirtschaft, in der Branchensoftware, in deinen internen Benachrichtigungen. Ein Agent, dessen Gespräche in einer Inbox versauern, löst nur das halbe Problem.

Genau diese zweite Hälfte ist unsere Arbeit. Wir verbinden fonio mit dem System, das du ohnehin nutzt, sodass aus einem Anruf automatisch ein sauberer Datensatz, ein Ticket, eine Bestellung oder eine Benachrichtigung wird, ohne dass jemand etwas abtippt.

Hat fonio eine API?

Ja. fonio hat eine öffentliche API, die „Fonio Public API" in Version 1.0, öffentlich dokumentiert seit Mai 2026. Sie ist zum Auslösen gebaut, nicht zum Auslesen: Damit startest du ausgehende Anrufe direkt aus deinem System, zum Beispiel sobald in deinem CRM ein neuer Lead landet. Anrufe, Transkripte und Aufnahmen rufst du darüber nicht ab. Die Gesprächsdaten schickt fonio per Webhook an dein System. Die technische Referenz steht in fonios Swagger-Dokumentation unter app.fonio.ai/api/docs (Stand 28. September 2026).

Was die fonio API kann

• Ausgehende Anrufe auslösen. Über den Endpunkt POST /public/v1/outbound_call ruft dein Assistent eine Nummer an. Typische Anwendung: Ein Formular auf deiner Website geht ein, und der Agent ruft den Interessenten sofort zurück. Oder dein CRM stößt eine Terminerinnerung an. Voraussetzung laut fonio: der Team-Tarif, eine importierte Rufnummer oder ein SIP-Trunk und eine abgeschlossene Identitätsprüfung (KYC) unter „Abo & Abrechnung". Zu den Kosten schreibt fonio: „Für jeden ausgehenden Anruf wird eine Minute vom enthaltenen Minutenkontingent abgezogen. Zusätzlich fallen ‚Carrier-Kosten' für jede angefangene Minute an." Die Antwort der API meldet nur Erfolg oder Fehler, eine Anruf-ID kommt nicht zurück. Details stehen im Help-Center-Artikel zur Outbound API (öffnet in neuem Tab).
• API-Schlüssel prüfen. Ein eigener Endpunkt testet, ob ein fonio-API-Schlüssel gültig ist. Angemeldet wird jede Anfrage mit diesem Schlüssel.
• Funktionen für Wiederverkäufer. Acht der 13 Operationen richten sich an Wiederverkäufer: Tarife abrufen, Kundenfirmen anlegen oder kündigen, Tarife je Firma verwalten. Sie funktionieren nur mit dem API-Schlüssel eines Reseller-Kontos, jedes andere Konto weist die API ab. Für einen einzelnen Betrieb spielen sie keine Rolle.
• Eigene Integrations-Server anbinden. Entwickler registrieren bis zu fünf eigene Server pro Firma, die fonio-eigene Integrationsbeschreibungen ausliefern. Angemeldet wird per Bearer-Token.

Webhooks vor, während und nach dem Anruf

Die meisten Anbindungen laufen nicht über die Public API, sondern über drei Webhooks, die du im Assistenten einrichtest. Sie sind in jedem fonio-Tarif enthalten, auch in Solo. Ausgehende Anrufe per API gibt es dagegen erst ab dem Team-Tarif.

• Vor dem Anruf: Schon bevor der Assistent abhebt, holt er auf Wunsch Daten aus deinem System, etwa die Kundendaten zur Anrufernummer. Sie stehen ihm dann im Gespräch als Variablen zur Verfügung. (Help Center: Inbound Webhook (öffnet in neuem Tab))
• Während des Anrufs: Unter einer Bedingung, die du festlegst, fragt der Assistent mitten im Gespräch eine Schnittstelle ab, etwa den Bestellstatus, und liest die Antwort gleich vor. fonio empfiehlt dafür eine Antwortzeit unter zwei Sekunden. (Help Center: Webhook während des Anrufs (öffnet in neuem Tab))
• Nach dem Anruf: fonio schickt die Gesprächsdaten an eine Adresse deiner Wahl: Anrufernummer, Link zum Gespräch, Transkript und die Felder, die du am Webhook festlegst. Was dort nicht definiert ist, wird nicht gesendet. (Help Center: Webhook nach dem Anruf (öffnet in neuem Tab))

Was die fonio API nicht kann

Einen Endpunkt, der Anrufe auflistet, Transkripte oder Aufnahmen abruft oder Assistenten anlegt und ändert, gibt es nicht (Stand 28. September 2026). Gesprächsdaten holst du also nicht ab, sie kommen per Webhook zu dir. Den Assistenten selbst konfigurierst du im Web-Interface. Damit ist die fonio API schmaler als die von Entwicklerplattformen wie Vapi oder Retell, bei denen du Assistenten per API anlegst und jeden Anruf samt Transkript einzeln abrufst. Für den typischen Fall, Gesprächsdaten ins CRM zu bringen, reicht der Webhook. Wer jeden Baustein per Code steuern will, ist mit einer Entwicklerplattform besser bedient; mehr dazu unter fonio vs. Vapi.

Wie wir fonio anbinden

In der Praxis kombinieren wir beide Richtungen. Nach jedem Gespräch fängt ein n8n-Workflow das Webhook-Ereignis auf, bereitet die Rohdaten auf und schreibt sie in dein Zielsystem. In die andere Richtung stößt n8n über die API einen Anruf an, sobald in deinem System etwas passiert, etwa ein neuer Lead aus dem Kontaktformular. Das setzt den Team-Tarif voraus.

In dieser Zwischenschicht passiert die eigentliche Logik: Telefonnummern normalisieren, Anliegen kategorisieren, bestehende Kontakte erkennen statt doppelt anlegen, nach Region oder Dringlichkeit verzweigen. Wer „nur den Webhook abfangen" will, kommt bis hierhin. Und bleibt dann an Dubletten, uneinheitlichen Formaten und Sonderfällen hängen. Tools wie n8n, Make oder Zapier sind die Brücke; die durchdachte Strecke darüber ist der Unterschied.

Ausgewählte Projekte, die wir umgesetzt haben

Wir reden nicht von der Theorie. Eine Auswahl echter Anbindungen (Kundennamen anonymisiert, Abläufe real):

First-Level-Support für einen Kassensoftware-Anbieter. Hier ging es nicht um ein paar Anrufe, sondern um Masse. Wir haben Zehntausende historische Support-Tickets mit KI ausgewertet, per Clustering und Vektor-Embeddings die wiederkehrenden Fälle herausgearbeitet und daraus einen Voice Agent gebaut, der echte First-Level-Minuten am Telefon abfängt. Was er nicht abschließend lösen kann, übergibt er über eine klare Eskalationslogik an einen Menschen — mit dem Kontext aus dem Gespräch, statt den Anrufer bei null anfangen zu lassen.

Anbindung an die Warenwirtschaft eines Getränke-Großhändlers. Aktuell in Umsetzung: Wir verbinden den Voice Agent mit der Warenwirtschaft COPRA, damit telefonische Vorgänge direkt im führenden System ankommen, statt parallel auf Zetteln und in Köpfen zu liegen. Genau solche ERP- und Warenwirtschafts-Anbindungen sind der Fall, an dem Standard-Konnektoren scheitern und eine saubere n8n-Strecke nötig wird.

fonio an ein Kampfsport-CRM mit SMS-Buchungsstrecke. Für eine Kampfsportschule haben wir die Strecke nach dem Anruf gebaut: fonio nimmt das Gespräch an, qualifiziert den Interessenten, und direkt danach geht eine SMS mit einem vorausgefüllten Buchungslink raus. Der Interessent tippt nur noch einen Termin an, alles landet strukturiert im CRM. Die korrekte Telefonnummer kommt dabei aus der Anrufer-Kennung, die fehleranfällige Eingabe von Namen verlagert sich aufs eigene Handy des Anrufers.

Unser eigener Agent als Rezeption. Was wir verkaufen, nutzen wir selbst: Unser Voice Agent nimmt eingehende Anrufe an wie eine Rezeption und meldet relevante Gespräche an unsere internen Tools, etwa per Telegram-Benachrichtigung. So sehen wir in Echtzeit, wer angerufen hat und worum es ging, ohne ständig aufs Telefon zu schauen.

Spezifische Anbindungen im Detail

Für die häufigsten Fälle haben wir eigene Seiten mit dem konkreten Vorgehen:

• fonio CRM-Anbindung: Leads automatisch in HubSpot, Pipedrive, Salesforce oder Zoho
• fonio Kalender-Anbindung: Termine direkt in Google Calendar, Outlook oder iCloud
• fonio lexoffice-Anbindung: Kontakte und Belege in die Buchhaltung
• fonio Telefonanlage anbinden: Einbindung in deine bestehende Telefonie

Wir bauen deine fonio-Integration

Wenn du nicht selbst basteln willst, übernehmen wir die komplette Anbindung: Webhook-Setup auf fonio-Seite, bei Bedarf ausgehende Anrufe per fonio API (ab dem Team-Tarif), n8n-Workflow mit Datenaufbereitung und Verzweigungslogik, Anbindung an dein CRM, deine Warenwirtschaft oder deine interne Software, Test mit echten Gesprächsszenarien und laufende Pflege im Retainer. n8n läuft dabei auf unseren eigenen Servern in Deutschland (Hetzner); die Verarbeitung in dieser Automatisierungs-Schicht findet in der EU statt, und wir stellen auf Wunsch einen Auftragsverarbeitungsvertrag (AVV) bereit.

Pakete starten bei 1.920 Euro Einrichtung plus ab 100 Euro monatlich, jährlich kündbar. Der genaue Umfang hängt davon ab, wie viele Systeme und Sonderfälle deine Strecke braucht. Jetzt kostenloses Erstgespräch buchen (öffnet in neuem Tab)

Lieber selbst starten?

Du willst fonio erst einmal allein ausprobieren? Hier geht es direkt los: fonio kostenlos testen (öffnet in neuem Tab). Die 10 % auf dein erstes Abo löst der persönliche Partnercode aus, den du im Checkout einträgst. Den Code und eine Schritt-für-Schritt-Anleitung schicken wir dir kostenlos per E-Mail über unseren Gratis-Guide.

Mehr zum Telefonassistenten selbst findest du auf der Voice Agent-Seite. Wie wir Abläufe rund um Anrufe, Angebote und Daten automatisieren, liest du unter KI-Automatisierung. Wer die Einrichtung ganz abgeben will, ist bei der Agentur für fonio richtig.

Häufige Fragen

Hat fonio eine API? Ja. fonio hat eine öffentliche API mit Anmeldung per API-Schlüssel. Für einen Betrieb zählt vor allem eine Funktion: ausgehende Anrufe auslösen, ab dem Team-Tarif. Die übrigen Operationen richten sich an Wiederverkäufer mit Reseller-Schlüssel und an Entwickler eigener Integrations-Server. Gesprächsdaten schickt fonio per Webhook, und während des Gesprächs fragt der Assistent auf Wunsch externe Systeme ab.

Kann ich Anrufe und Transkripte über die fonio API abrufen? Nein, einen solchen Endpunkt gibt es nicht (Stand 28. September 2026). Anrufernummer, Link zum Gespräch, Transkript und die Felder, die du festlegst, kommen nach jedem Gespräch per Webhook an eine Adresse deiner Wahl. Von dort leitet eine Automatisierungs-Schicht wie n8n, Make oder Zapier sie in nahezu jedes System weiter, das eine Schnittstelle hat.

Kann ich über die fonio API Anrufe starten? Ja, ab dem Team-Tarif. Die Public API hat einen Endpunkt für ausgehende Anrufe. Voraussetzung laut fonio sind außerdem eine importierte Rufnummer oder ein SIP-Trunk und eine abgeschlossene Identitätsprüfung. Ausgehende Anrufe verbrauchen Minuten aus deinem Kontingent, dazu kommen Carrier-Kosten für jede angefangene Minute. So ruft der Agent zum Beispiel automatisch zurück, sobald auf deiner Website ein Formular eingeht.

Sind Webhooks in jedem fonio-Tarif enthalten? Ja. Webhooks vor, während und nach dem Anruf sind in jedem fonio-Tarif enthalten, auch in Solo. Ausgehende Anrufe per API gibt es dagegen erst ab dem Team-Tarif (Stand 28. September 2026).

Welche Systeme lassen sich an fonio anbinden? In der Praxis fast alles mit einer Schnittstelle: CRM-Systeme wie HubSpot, Pipedrive oder Salesforce, Warenwirtschaft und ERP wie COPRA, Branchen- und Praxissoftware, Buchhaltung wie lexoffice sowie interne Tools wie Telegram oder Slack für Benachrichtigungen. Da die Anbindung über n8n läuft, ist die Liste offen.

Kann ich die fonio-Integration selbst bauen? Grundsätzlich ja, fonio bietet Webhooks und eine Public API, und n8n ist dafür gemacht. In der Praxis scheitern viele an Dubletten, uneinheitlichen Telefonnummern, bedingtem Routing und an Workflows, die auch dann robust bleiben müssen, wenn das Zielsystem mal nicht antwortet. Wenn du dir das ersparen willst, bauen wir die Strecke für dich.

Was kostet eine fonio-Integration? Pakete starten bei 1.920 Euro Einrichtung plus ab 100 Euro monatlich, jährlich kündbar. Der Preis richtet sich danach, wie viele Systeme angebunden werden und wie viele Verzweigungen und Sonderfälle die Strecke braucht. Den genauen Umfang klären wir im kostenlosen Erstgespräch.

Ist die Anbindung DSGVO-konform? Ja. Der n8n-Workflow läuft auf unseren eigenen Servern in Deutschland (Hetzner), die Verarbeitung in dieser Automatisierungs-Schicht findet in der EU statt. Auf Wunsch stellen wir einen Auftragsverarbeitungsvertrag (AVV) bereit.