Aircall Messaging API

Die Aircall Message API ist Teil des Entwickler-Toolkits von Aircall und ermöglicht externen Anwendungen und Diensten die programmgesteuerte Interaktion mit den Messaging-Funktionen von Aircall. Sie unterstützt Unternehmen dabei, Prozesse zu automatisieren, Integrationen zu erstellen und Workflows im Zusammenhang mit SMS und MMS Messaging zu optimieren.

WICHTIG:
Das Senden von Nachrichten über die API ist nur im Aircall Professional-Plan verfügbar. Für ein Upgrade kontaktieren Sie bitte unser Customer Success Team.

Dieser Artikel erklärt, wie die Aircall Message API verwendet wird, wie der richtige Endpunkt für Ihre Bedürfnisse ausgewählt wird und wie die relevanten Messaging-Vorschriften eingehalten werden.

Übersicht über die Message API

Die Aircall Message API ermöglicht es Administratoren, Nachrichtenaktivitäten abzurufen, SMS- und MMS-Nachrichten zu senden und die Einhaltung von Vorschriften sicherzustellen. Beim Senden von Nachrichten können Sie zwischen zwei verschiedenen Endpunkten wählen:

• Option 1: Nachricht senden
• Option 2: Nachricht in Agenten-Konversation senden

Jeder verhält sich unterschiedlich, und es ist nicht möglich, beide Endpunkte gleichzeitig für dieselbe Aircall-Nummer zu verwenden.

Auswahl des richtigen Endpunkts

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

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

Option 1: Send Message Endpunkt

Die Verwendung des Send Message Endpunkts ermöglicht es einer Aircall-Nummer, SMS- oder MMS-Nachrichten zu senden und zu empfangen, die nicht in Aircall-Apps angezeigt oder in Webhooks einbezogen werden. Die Nachrichten sind vollständig extern, daher muss Ihr System diese an anderer Stelle speichern.

Wichtige Details:

• Gesendete und empfangene SMS/MMS erscheinen nicht in Aircall-Webhooks oder Apps.
• MMS wird unterstützt.
• Nach der Konfiguration mit diesem Endpunkt kann die Nummer keine Nachrichten mehr über die Aircall-App senden oder empfangen. Um das Messaging in Aircall-Apps wiederherzustellen, muss die Konfiguration entfernt werden.

Beispielanwendungsfälle:

• Integration von Aircall mit einem externen Tool, in dem Benutzer Nachrichten direkt ansehen und beantworten können.
• Senden von einmaligen Verifizierungscodes oder automatisierten Nachrichten (z. B. Bestellbestätigungen, Lieferupdates).
• Versenden von nicht-konversationellen Marketing- oder Werbenachrichten.

Für Implementierungsdetails siehe Erste Schritte mit dem Senden von Nachrichten über die Aircall API.

Option 2: Send Message in Agent Conversation Endpunkt

Die Verwendung des Send Message in Agent Conversation Endpunkts ermöglicht es, dass über die API gesendete Nachrichten direkt in Aircall-Apps angezeigt werden. Im Gegensatz zu Option 1 behält diese Einrichtung die Sichtbarkeit für Benutzer bei und ermöglicht fortlaufende Konversationen.

Wichtige Details:

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

Beispielanwendungsfälle:

• Automatisches Begrüßen von Kunden, die Ihre Aircall-Nummer per SMS kontaktieren, mit der Information, dass ein Agent bald antwortet.
• Senden von automatisierten Nachrichten, die durch CRM-Ereignisse ausgelöst werden (z. B. wenn ein Kunde eine bestimmte Phase erreicht). Alle Antworten des Kunden erscheinen in Aircall, sodass Agenten die Konversation nahtlos fortsetzen können.

Für Anweisungen zur Einrichtung siehe Erste Schritte mit dem ‘Send Message in Agent Conversation’ Endpunkt in der Aircall API.

Aircall API Messaging-Funktionen und Vorschriften

Unabhängig davon, welchen Endpunkt Sie verwenden, muss das Messaging über die API Branchenstandards und lokale Vorschriften einhalten.

Vereinigte Staaten und Kanada

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

Frankreich

• Mobilfunkleitungen sind nur für persönliche und konversationelle Nutzung bestimmt. Automatisierte oder Massen-SMS über die API sind verboten, konversationelles Messaging bleibt jedoch erlaubt.

Allgemeine Hinweise

• Mobilfunkleitungen sollten einem einzelnen Agenten zugewiesen sein, der deren Nutzung kontrolliert.
• Überprüfen Sie stets die Einhaltung lokaler Vorschriften, bevor Sie automatisiertes Messaging implementieren.

WICHTIG:
Holen Sie lokale rechtliche Beratung ein, um sicherzustellen, dass Ihr Messaging-Anwendungsfall konform ist.

Überlegungen bei der Verwendung der Message API

Regulatorische Anforderungen

• US-Longcodes und gebührenfreie Nummern aus den USA/Kanada müssen vor der Nutzung vollständig registriert sein.
• Es wird nur domestisches Messaging unterstützt, außer zwischen den USA und Kanada (wie beim Messaging aus Aircall-Apps).

Ratenbegrenzungen

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

HINWEIS:
Ratenbegrenzungen können ohne Vorankündigung geändert werden, um eine ordnungsgemäße Nutzung sicherzustellen.

Preise

Der Zugriff auf die Send Message API ist im Professional-Plan 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 kontaktieren Sie bitte unser Customer Success Team.

Um mit Ihrer Einrichtung fortzufahren:

• Für Option 1 siehe Erste Schritte mit dem Senden von Nachrichten über die Aircall API.
• Für Option 2 siehe Erste Schritte mit dem ‘Send Message in Agent Conversation’ Endpunkt in der Aircall API.