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 gesendet werden, als kämen sie von einer Aircall-Telefonnummer, indem sie benutzerdefinierte Entwicklungen oder Low-Code-Integrations-Middleware verwenden.
Dieser Artikel behandelt:
- Erste Schritte
- Tutorials verfügbar
- So erhalten Sie weitere Unterstützung
Wir haben außerdem einen weiteren Artikel , der Folgendes behandelt:
- Allgemeine Hinweise zu den Aircall-Bestimmungen für SMS
- Vorschriften und Spezifikationen zur Ratenbegrenzung.
- Preisdetails
Erste Schritte
Um mit der Messaging-API zu beginnen, lesen Sie bitte die API-Dokumentation . Diese Dokumentation behandelt Folgendes:
1. Einrichten Ihrer Aircall-Nummer für API-Messaging (nur).
Konfiguration: Sie müssen eine POST-Anfrage an den Aircall-API-Endpunkt „ messages/configuration “ 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.
2. 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.
3. Empfangen von Antwortnachrichten auf Ihrer Rückruf-URL
Der Callback-URL-Endpunkt (in Schritt 1 konfiguriert) 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",
"Nummer": {
"ID": 84848484,
"Direktlink": "https://api.aircall.io/v1/numbers/1234567",
"Name": "US-SMS-Leitung 1",
"Ziffern": "+1 626-800-9000",
"Land": "USA",
"Zeitzone": "Amerika/Chicago",
"Öffnen": wahr,
"Erstellt am": "2024-07-17T13:12:10Z"
},
"Text": "Text der Nachricht"
}
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 benutzerdefinierten Implementierungen zu unterstützen. Bitte wenden Sie sich an Ihren Success Manager, wenn Sie dies näher erkunden möchten.
Weitere Einzelheiten zur Aircall Messaging API finden Sie unter: Über die Aircall Messaging API