Aircall Nachrichten API

Die Aircall Message API ist Teil des Entwickler-Toolkits von Aircall und ermöglicht es externen Anwendungen und Diensten, programmgesteuert mit den Nachrichtenfunktionen von Aircall zu interagieren. Sie unterstützt Unternehmen dabei, Prozesse zu automatisieren, Integrationen zu erstellen und Workflows rund um SMS- und MMS-Nachrichten zu optimieren.

Achtung: Das Senden von Nachrichten über API ist nur im Aircall Professional-Abonnement verfügbar. Für ein Upgrade wenden Sie sich an unser Kundenerfolg-Team.

In diesem Artikel wird erklärt, wie die Aircall Message API verwendet wird, wie Sie den richtigen Endpunkt für Ihre Anforderungen auswählen und wie Sie relevante Vorschriften für Nachrichten einhalten.

Überblick über die Message API

Mit der Aircall Message API können Administratoren Nachrichtenaktivitäten abrufen, SMS- und MMS-Nachrichten senden und die Compliance sicherstellen. Beim Senden von Nachrichten können Sie zwischen zwei verschiedenen Endpunkten wählen:

• Option 1: Nachricht senden unter Umgehung des Aircall Posteingangs
• Option 2: Nachricht in einer Agent-Konversation senden

Beide verhalten sich unterschiedlich, und es ist nicht möglich, beide Endpunkte gleichzeitig für dieselbe Aircall-Rufnummer zu verwenden.

Den richtigen Endpunkt auswählen

Bevor Sie einen Endpunkt auswählen, beachten Sie bitte Folgendes:

• API-Nachrichten sind nur für Aircall-Rufnummern verfügbar, die für SMS aktiviert sind.
• Aircall-Rufnummern mit API-Nachrichten können in den Aircall-Apps weiterhin für eingehende und ausgehende Anrufe verwendet werden.

Option 1: Endpunkt „Nachricht senden unter Umgehung des Aircall Posteingangs“

Mit dem Endpunkt „Nachricht senden unter Umgehung des Aircall Posteingangs“ kann eine Aircall-Rufnummer SMS- oder MMS-Nachrichten senden und empfangen, die nicht in Aircall-Apps angezeigt und nicht in Webhooks aufgenommen werden. Die Nachrichten sind vollständig extern, daher muss Ihr System sie an anderer Stelle erfassen.

Wichtige Details:

• Gesendete und empfangene SMS/MMS erscheinen nicht in Aircall-Webhooks oder -Apps.
• MMS wird unterstützt.
• Sobald diese Rufnummer mit diesem Endpunkt konfiguriert ist, kann sie keine Nachrichten mehr über die Aircall-App senden oder empfangen. Um Nachrichten in Aircall-Apps wiederherzustellen, muss die Konfiguration entfernt werden.

Beispielhafte Anwendungsfälle:

• Aircall in ein externes Tool integrieren, in dem Benutzer Nachrichten direkt anzeigen und beantworten können.
• Einmalige Bestätigungscodes oder automatisierte Nachrichten senden (z. B. Bestellbestätigungen, Lieferupdates).
• Nicht-konversationelle Marketing- oder Werbenachrichten senden.

Implementierungsdetails finden Sie unter Erste Schritte beim Senden von Nachrichten unter Umgehung des Aircall-Posteingangs mit der Aircall-API.

Option 2: Endpunkt „Nachricht in Agent-Konversation senden“

Mit dem Endpunkt „Nachricht in Agent-Konversation senden“ können über API gesendete Nachrichten direkt in Aircall-Apps angezeigt werden. Anders als bei Option 1 bleibt diese Einrichtung für Benutzer sichtbar und ermöglicht fortlaufende Konversationen.

Wichtige Details:

• MMS über API wird nicht unterstützt.
• Gesendete und empfangene SMS erscheinen in Aircall-Apps und in Nachrichtenereignis-Webhooks.
• Kombiniert Automatisierung mit der Möglichkeit für Aircall-Benutzer, die Konversation in der App fortzusetzen.

Beispielhafte Anwendungsfälle:

• Kunden, die Ihrer Aircall-Rufnummer eine SMS senden, automatisch begrüßen und sie darüber informieren, dass sich in Kürze ein Agent meldet.
• Automatisierte Nachrichten senden, die durch CRM-Ereignisse ausgelöst werden (zum Beispiel wenn ein Kunde eine bestimmte Phase erreicht). Antworten des Kunden erscheinen in Aircall, sodass Agenten die Konversation nahtlos fortsetzen können.

Einrichtungsanweisungen finden Sie unter Erste Schritte mit dem Endpunkt „Nachricht in Agent-Konversation senden“ in der Aircall-API.

Aircall-API-Nachrichtenfunktionen und Vorschriften

Unabhängig davon, welchen Endpunkt Sie verwenden, müssen Nachrichten über API den Branchenstandards und lokalen Vorschriften entsprechen.

Vereinigte Staaten und Kanada

• Automatisierte und Marketing-SMS sind zulässig, wenn Ihre Rufnummer ordnungsgemäß registriert ist (siehe A2P 10DLC-Registrierung und Richtlinien für gebührenfreie Rufnummern) und Sie die Zustimmung des Kunden nachweisen können.

Frankreich

• Mobilfunkleitungen sind nur für persönliche und konversationelle Nutzung vorgesehen. Automatisierte oder Massen-SMS über API sind verboten, konversationelle Nachrichten bleiben jedoch zulässig.

Allgemeine Hinweise

• Mobilfunkleitungen sollten einem einzelnen Agenten zugewiesen sein, der ihre Nutzung kontrolliert.
• Überprüfen Sie vor der Implementierung automatisierter Nachrichten immer die Einhaltung lokaler Vorschriften.

Achtung: Holen Sie lokalen Rechtsrat ein, um sicherzustellen, dass Ihr Anwendungsfall für Nachrichten konform ist.

Hinweise zur Verwendung der Message API

Regulatorische Anforderungen

• US-Langwahlnummern und gebührenfreie US-/CA-Rufnummern müssen vor der Nutzung vollständig registriert sein.
• Es werden nur Lokale Nachrichten unterstützt, außer zwischen den USA und Kanada (wie auch bei Nachrichten aus Aircall-Apps).

Anfragenbegrenzung

Aircall begrenzt API-Anfragen für alle Endpunkte auf 60 pro Minute. Zusätzliche stündliche, tägliche und monatliche Limits gelten je nach Rufnummerntyp und Land.

Hinweis: Anfragenbegrenzungen können ohne vorherige Ankündigung geändert werden, um eine ordnungsgemäße Nutzung sicherzustellen.

Preise

Der Zugriff auf die Send Message API ist im Professional-Abonnement enthalten. Das Nachrichtenvolumen aus API- und App-Quellen wird auf Ihrer Rechnung zusammengefasst, und die Gebühren pro Nachricht entsprechen denen, die über die Aircall-Apps anfallen.

Für ein Upgrade oder weitere Informationen wenden Sie sich an unser Kundenerfolg-Team.

So setzen Sie die Einrichtung fort:

• Für Option 1 siehe Erste Schritte beim Senden von Nachrichten unter Umgehung des Aircall-Posteingangs mit der Aircall-API.
• Für Option 2 siehe Erste Schritte mit dem Endpunkt „Nachricht in Agent-Konversation senden“ in der Aircall-API.