Die Aircall Message API ist Teil des Entwickler-Toolkits von Aircall und ermöglicht externen Anwendungen und Diensten die programmgesteuerte Interaktion mit den Nachrichtenfunktionen von Aircall. Sie unterstützt Unternehmen dabei, Prozesse zu automatisieren, Integrationen zu erstellen und Arbeitsabläufe im Zusammenhang mit SMS- und MMS-Nachrichten zu optimieren.
ACHTUNG: Das Senden von Nachrichten über die 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 Endpoint für Ihre Anforderungen auswählen und wie Sie die relevanten Vorschriften für Nachrichten einhalten.
Übersicht über die Message API
Mit der Aircall Message API können Administratoren Nachrichtenaktivitäten abrufen, SMS- und MMS-Nachrichten senden und die Einhaltung von Vorschriften sicherstellen. Beim Senden von Nachrichten können Sie zwischen zwei unterschiedlichen Endpoints wählen:
- Option 1: Nachricht senden und den Aircall Inbox umgehen
- Option 2: Nachricht in der Agent-Konversation senden
Beide verhalten sich unterschiedlich, und es ist nicht möglich, beide Endpoints gleichzeitig für dieselbe Aircall Rufnummer zu verwenden.
Den richtigen Endpoint auswählen
Beachten Sie vor der Auswahl eines Endpoints 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 Aircall-Apps weiterhin für eingehende und ausgehende Anrufe verwendet werden.
Option 1: Endpoint „Send Message Skipping Aircall Inbox“
Durch die Verwendung des Endpoints „Send Message Skipping Aircall Inbox“ kann eine Aircall Rufnummer SMS- oder MMS-Nachrichten senden und empfangen, die nicht in Aircall-Apps angezeigt oder in Webhooks enthalten sind. Nachrichten sind vollständig extern, daher muss Ihr System sie an anderer Stelle erfassen.
Wichtige Details:
- Gesendete und empfangene SMS/MMS werden nicht in Aircall Webhooks oder Apps angezeigt.
- MMS wird unterstützt.
- Sobald die Rufnummer mit diesem Endpoint 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.
Beispiele für Anwendungsfälle:
- Integrieren Sie Aircall mit einem externen Tool, in dem Benutzer Nachrichten direkt anzeigen und beantworten können.
- Senden Sie einmalige Verifizierungscodes oder automatisierte Nachrichten (z. B. Bestellbestätigungen, Lieferupdates).
- Senden Sie nicht-konversationelle Marketing- oder Werbenachrichten.
Einzelheiten zur Implementierung finden Sie unter Getting Started with Sending Messages Skipping Aircall inbox using Aircall’s API.
Option 2: Endpoint „Send Message in Agent Conversation“
Durch die Verwendung des Endpoints Send Message in Agent Conversation können über die API gesendete Nachrichten direkt in Aircall-Apps angezeigt werden. Im Gegensatz zu Option 1 bleibt in dieser Konfiguration die Sichtbarkeit für Benutzer erhalten und laufende Konversationen werden ermöglicht.
Wichtige Details:
- MMS über API wird nicht unterstützt.
- Gesendete und empfangene SMS werden in Aircall-Apps und in Message Event Webhooks angezeigt.
- Kombiniert Automatisierung mit der Möglichkeit für Aircall-Benutzer, die Konversation innerhalb der App fortzusetzen.
Beispiele für Anwendungsfälle:
- Begrüßen Sie Kunden automatisch, die Ihrer Aircall Rufnummer eine SMS senden, und teilen Sie ihnen mit, dass sich in Kürze ein Agent meldet.
- Senden Sie automatisierte Nachrichten, die durch CRM-Ereignisse ausgelöst werden (zum Beispiel wenn ein Kunde eine bestimmte Phase erreicht). Antworten des Kunden werden in Aircall angezeigt, sodass Agenten die Konversation nahtlos fortsetzen können.
Einrichtungsanweisungen finden Sie unter Getting Started with ‘Send Message in Agent Conversation’ Endpoint in Aircall’s API.
Funktionen und Vorschriften für Aircall API-Nachrichten
Unabhängig davon, welchen Endpoint 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 registration und Richtlinien für gebührenfreie Rufnummern) und Sie die Einwilligung des Kunden nachweisen können.
Frankreich
- Mobilfunkleitungen sind ausschließlich für die persönliche und konversationelle Nutzung bestimmt. Automatisierte oder Massen-SMS über API sind verboten, konversationelle Nachrichten bleiben jedoch zulässig.
Allgemeine Hinweise
- Mobilfunkleitungen sollten einem einzelnen Agent zugewiesen sein, der ihre Nutzung kontrolliert.
- Überprüfen Sie vor der Implementierung automatisierter Nachrichten stets die Einhaltung lokaler Vorschriften.
ACHTUNG: Lassen Sie sich lokal rechtlich beraten, 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 wird nur Lokale Nachrichten unterstützt, außer zwischen den USA und Kanada (wie bei Nachrichten aus Aircall-Apps).
Anfragenbegrenzung
Aircall begrenzt API-Anfragen für alle Endpoints auf 120 pro Minute. Zusätzliche stündliche, tägliche und monatliche Begrenzungen gelten je nach Rufnummerntyp und Land.
| Rufnummerntyp | Stündliches Limit | Tägliches Limit | Monatliches Limit |
|---|---|---|---|
| US- & CA-Rufnummern | 1,000 | 10,000 | 20,000 |
| Französische Mobilfunkleitungen | 100 | 1,000 | 10,000 |
| Andere Leitungen | 500 | 2,000 | 20,000 |
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 bitte an unser Kundenerfolg Team.
So fahren Sie mit Ihrer Einrichtung fort:
- Für Option 1 siehe Getting Started with Sending Messages Skipping Aircall inbox using Aircall’s API.
- Für Option 2 siehe Getting Started with ‘Send Message in Agent Conversation’ Endpoint in Aircall’s API.