Einführung
Die Aircall Message API ist Teil der Entwicklertools von Aircall, die es externen Anwendungen und Diensten ermöglichen, programmgesteuert mit den Messaging-Funktionen von Aircall zu interagieren. Dies bietet Unternehmen die Möglichkeit, Automatisierungen und Integrationen zu erstellen und Workflows im Zusammenhang mit SMS und MMS zu optimieren.
Dieser Artikel behandelt:
- Übersicht über die Messaging-API
- Den richtigen Endpunkt für Ihre Anforderungen auswählen
- Option 1: „Nachricht senden“
- Option 2: „Nachricht im Agentengespräch senden“
- Anwendungsbeispiele
- Den richtigen Endpunkt für Ihre Anforderungen auswählen
- Überlegungen zur Verwendung der API zum Senden von SMS
- Allgemeine Hinweise zu den Aircall-Bestimmungen
- Ratenbegrenzungsspezifikationen
- Preisdetails
Übersicht über die Messaging-API
Über diese öffentliche API können Administratoren unter anderem Nachrichtenaktivitäten abrufen, Nachrichten senden und die Einhaltung von Vorschriften sicherstellen. Wenn es um das Senden von Nachrichten geht, können Sie die Messaging-API mit zwei deutlich unterschiedlichen Endpunkten nutzen. Anhand der folgenden Beschreibungen und Beispiele ist es wichtig, die Endpunktoption auszuwählen, die Ihren Anforderungen entspricht (da sie sich unterschiedlich verhalten).
Es ist nicht möglich, beide Endpunktoptionen gleichzeitig auf derselben Aircall-Nummer zu verwenden.
Den richtigen Endpunkt für Ihre Anforderungen auswählen
Bevor Sie eine Option auswählen, beachten Sie bitte:
- API-Messaging ist nur für Aircall-Nummern möglich, die für SMS aktiviert sind
- Aircall-Nummern mit API-Messaging können weiterhin für eingehende & ausgehende Anrufe in Aircall-Apps verwendet werden.
Option 1: Endpunkt „Nachricht senden“
Wenn Sie den Endpunkt Nachricht senden mit einer Aircall-Nummer verwenden, sind die gesendeten & empfangenen SMS/MMS in Aircall-Apps oder Webhooks nicht sichtbar . Dies bedeutet, dass gesendete & empfangene Nachrichten für Benutzer nicht direkt in Aircall sichtbar sind. Daher liegt es bei dieser Option in der Verantwortung des Kunden, alle gesendeten & empfangenen Nachrichten an einem externen Ort Ihrer Wahl aufzuzeichnen.
❌ Gesendete & empfangene SMS/MMS werden nicht in Aircall-Webhooks angezeigt
✅ MMS wird mit dieser Option unterstützt
⚠️ Sobald eine Nummer mit diesem Endpunkt konfiguriert ist, kann sie keine Nachrichten mehr von den Aircall-App-Schnittstellen senden/empfangen. Um wieder zu Benutzern zurückzukehren, die Nachrichten in Aircall-Apps senden/empfangen, muss die Konfiguration gelöscht werden.
Anwendungsbeispiele
- Erstellen Sie eine Integration, damit Benutzer Textnachrichten direkt von einem externen Tool aus sehen und beantworten können ( weitere Inspirationen finden Sie im Blog )
- Senden Sie nicht-konversationelle Nachrichten wie einmalige Bestätigungscodes zur Zwei-Faktor-Authentifizierung, automatische Auftragsbestätigungen oder Lieferbenachrichtigungen per SMS.
- Senden Sie nicht-konversationelle Nachrichten für Marketing- und Werbeinhalte per SMS
In diesem Artikel und Tutorial wird ausführlich erläutert, wie der Endpunkt Nachricht senden mit einer Aircall-Nummer genutzt werden kann.
Option 2: Endpunkt „Nachricht im Agentengespräch senden“
Wenn Sie den Endpunkt Nachricht im Agentengespräch senden mit einer Aircall-Nummer verwenden, sind die gesendeten & empfangenen SMS direkt in Aircall-Apps anzeigbar (im Gegensatz zu Option 1).
❌ Das Senden von MMS über API wird mit dieser Option derzeit nicht unterstützt
✅ Gesendete & empfangene SMS sind in Aircall-Apps und über Message Event Webhooks
sichtbar.⚠️ Diese Option kombiniert Automatisierung und die Möglichkeit für Aircall-Benutzer, das Gespräch wie unten gezeigt fortzusetzen.
Anwendungsbeispiele
- Senden Sie eine automatische Nachricht, um Kunden zu begrüßen, die eine SMS an Ihre Aircall-Nummer senden. Lassen Sie sie wissen, dass ihnen in Kürze geholfen wird (Screenshot unten). Dies zeigt auch, wie die über die API gesendeten Nachrichten mit „Externes Tool“ als Absendername in Aircall-Apps angezeigt werden.
- Auslösen von Nachrichten basierend auf CRM-Aktivitäten. Wenn ein Kunde beispielsweise in eine bestimmte Phase übergeht, kann die API eine Nachricht senden, um den Kunden einzubeziehen, und jede Antwort wird in Aircall angezeigt, damit ein Teammitglied das Gespräch fortsetzen kann.
Wie oben gezeigt, können Kunden auf über die API gesendete Nachrichten antworten. Diese Antworten werden direkt in der Konversationsansicht angezeigt, damit Aircall-Benutzer bei der Kommunikation mit Kunden Transparenz und Kontinuität haben.
In diesem Artikel wird ausführlich erläutert, wie Sie den Nachricht im Agentengespräch senden Endpunkt mit einer Aircall-Nummer nutzen können.
Aircall API Messaging-Funktionen und -Bestimmungen
Unabhängig davon, welches Tool Sie zum Senden von SMS verwenden, gelten weiterhin Branchenstandards und lokale Vorschriften.
In den USA oder Kanada ist das automatisierte Versenden von SMS und für Marketingzwecke zulässig, sofern die Nummer für den richtigen Zweck registriert ist (siehe Artikel zur A2P 10DCL -Registrierung und gebührenfrei ) und dass Sie Ihr Einverständnis nachweisen können.
Mobilleitungen sind persönlich gedacht, das heißt, sie sollten nur einem einzigen Agenten zugeordnet werden. Wenn Sie die API mit Mobilleitungen verwenden, müssen Sie sicherstellen, dass nur der besagte Agent den implementierten Anwendungsfall steuert.
In Frankreich beispielsweise sind Mobilfunkanschlüsse nur für den persönlichen und gesprächsbezogenen Gebrauch vorgesehen, d. h. die Verwendung der API zum automatischen Versenden von SMS ist verboten. Es ist jedoch möglich, über die API eine gesprächsbezogene Kommunikation zu führen.
⚠️ Holen Sie sich lokale Anleitung, um sicherzustellen, dass Sie konforme Anwendungsfälle einrichten.
Überlegungen zur Verwendung der Messaging-API
Gesetzliche Anforderungen
- Die Konfiguration von US-Langwahlnummern oder gebührenfreien US/CA-Nummern funktioniert nur für vollständig registrierte Nummern.
- Wir erlauben nur das Senden im Inland, mit Ausnahme von Nachrichten zwischen den USA und Kanada – dasselbe Verhalten wie das für direktes Versenden von Nachrichten aus Aircall-Anwendungen beschriebene.
Ratenbegrenzungen
- Die Aircall API begrenzt die Anzahl der Anfragen auf 60 pro Minute, unabhängig vom verwendeten Endpunkt. Außerdem werden einige spezifische Einschränkungen angewendet, um eine übermäßige Nutzung der Funktion zum Senden von Nachrichten zu vermeiden. Aircall implementiert spezifische stündliche, tägliche und monatliche Limits, die für jede Nummernart und jedes Land unterschiedlich sind. Diese Limits können ohne vorherige Ankündigung geändert werden, um eine ordnungsgemäße Nutzung zu gewährleisten.
- Für Nummern in den USA und Kanada gelten SMS-Limits von 1.000 pro Stunde, 10.000 pro Tag und 20.000 pro Monat für ausgehende Segmente.
- Für französische Mobilfunkanschlüsse gelten Limits von 100 Stunden-, 1.000 Tages- und 10.000 Monatsgesprächen, um die Nutzung von Gesprächen zu gewährleisten.
- Weitere Leitungslimits sind 500 stündliche, 2.000 tägliche und 20.000 monatliche ausgehende SMS-Segmente.
Preise
Der Zugriff auf die API zum Senden von Nachrichten ist im Professional-Plan enthalten. Wenden Sie sich an Ihren Customer Success Manager oder Ihr Supportteam, wenn Sie an einem Upgrade Ihres Abonnementplans interessiert sind.
- Die Gebühren pro gesendetem Volumen sind die gleichen wie die Gebühren beim Senden über Aircall-Apps.
- Das Volumen aus API- und Anwendungsquellen wird in Ihren Rechnungen zusammengefasst.
Um mit Option 1 fortzufahren, lesen Sie weiter: Erste Schritte beim Senden von Nachrichten mithilfe der API von Aircall .
Um mit Option 2 fortzufahren, lesen Sie weiter: Erste Schritte mit dem Endpunkt „Nachricht im Agentengespräch senden“ in der API von Aircall