Zusammenfassung
Aircall bietet die Möglichkeit, SMS- oder MMS-Nachrichten über die Aircall Public API zu senden. Auf diese Weise können Kunden externe Tools so konfigurieren, dass SMS- oder MMS-Nachrichten so gesendet werden, als kämen sie von einer Aircall-Telefonnummer, indem sie benutzerdefinierte Entwicklungen oder Low-Code-Integrations-Middleware verwenden.
Bitte stellen Sie sicher, dass Sie Über Aircall Messaging API gelesen haben, bevor Sie mit diesem Artikel fortfahren . Er hebt die wichtigsten Unterschiede zwischen den beiden Endpunktoptionen zum Senden von Nachrichten hervor, sowie Details zu Preisen, Vorschriften und Ratenbegrenzungen.
⚠️ Das Senden von Nachrichten über die API ist nur im Aircall Professional-Plan verfügbar. Um auf den Professional-Plan zu aktualisieren, wenden Sie sich bitte an Ihren Customer Success Manager.
Erste Schritte mit dem Endpunkt „Nachricht senden“
Um mit der Messaging-API zu beginnen, lesen Sie bitte die API-Dokumentation . Diese Dokumentation behandelt Folgendes:
Einrichten Ihrer Aircall-Nummer für API-Messaging (nur)
Konfiguration: Sie müssen eine POST-Anfrage an den Aircall ' messages/configuration ' API-Endpunkt senden. Dadurch wird Ihre Aircall-Nummer eingerichtet, sodass Sie Nachrichten von der API senden können.
Hinweis: Es gibt GET- und DELETE-Endpunkte, mit denen Sie die Konfiguration bestätigen oder entfernen können.
Senden von Nachrichten von Ihrer Aircall-Nummer über die API
Um Nachrichten von der API zu senden, müssen Sie den API-Endpunkt ' messages/send ' verwenden.
Bitte beachten Sie, dass gesendete Nachrichten nicht auf der Aircall-Plattform aufgezeichnet werden.
Empfangen von Antwortnachrichten auf Ihrer Rückruf-URL
Der Callback-URL-Endpunkt (konfiguriert in Schritt 1) empfängt alle Antworten oder eingehenden Nachrichten von Ihrer Aircall-Nummer.
Das Format der Antwort auf eine gesendete Nachricht lautet:
{
"id": "abcdSMc6Dc8ea2bc71ab19102c3de4f60ba18aa",
"status": "ausstehend",
"direct_link": "https://api.aircall.io/v1/numbers/1234567/messages/abcdSMc6Dc8ea2bc71ab19102c3de4f60ba18aa",
"direction": "ausgehend",
"created_at": 1722758201825,
"sent_at": 1722758201825,
"updated_at": 1722758201825,
"raw_digits": "13023063029",
"number": {
"id": 84848484,
"direct_link": "https://api.aircall.io/v1/numbers/1234567",
"name": "US SMS line 1",
"digits": "+1 626-800-9000",
"country": "US",
"time_zone": "America/Chicago",
"open": true,
"created_at": "2024-07-17T13:12:10Z"
},
"body": "Nachrichtentext"
}
Das Antwortformat einer empfangenen Nachricht ist:
{
"Ressource": "Nachricht",
"Ereignisname": "Nachricht.empfangen",
"Zeitstempel": 1722604989549,
"Token": "91aa69db-c65e-42d9-85e7-g346b1h2204aa",
"Daten": {
"ID": "abdcSM11da5992cb15eed9f21bcdb26d264bb40a",
"Status": "empfangen",
"Direktlink": "https://api.aircall.io/v1/numbers/1234567/messages/abdcSM11da5992cb15eed9f21bcdb26d264bb40a",
"Richtung": "eingehend",
"created_at": 1722604989549,
"sent_at": 1722604989549,
"updated_at": 1722604989549,
"raw_digits": "18704575426",
"number": {
"id": 84848484,
"direct_link": "https://api.aircall.io/v1/numbers/1234567",
"name": "US SMS line 1",
"digits": "+1 626-800-9000",
"country": "US",
"time_zone": "America/Chicago",
"open": true,
"created_at": "2024-07-17T13:12:10Z"
},
"body": "Text der empfangenen Nachricht"
}
}
Tutorials verfügbar
Bitte lesen Sie dieses hilfreiche Tutorial für ein detailliertes technisches Beispiel zur Implementierung der Aircall SMS API.
Weitere Hilfe
Wenn Sie nicht über die erforderlichen Entwicklerkenntnisse verfügen, um diese Produktfunktion zu nutzen, stehen Ihnen unser Solutions Engineering-Team und unsere Partner zur Verfügung, um Sie bei der benutzerdefinierten Implementierung zu unterstützen. Bitte wenden Sie sich an Ihren Success Manager, wenn Sie weitere Informationen wünschen.
Weitere Einzelheiten zur Aircall Messaging API finden Sie hier: Über die Aircall Messaging API