L’API de messages Aircall fait partie de la boîte à outils développeur d’Aircall, permettant aux applications et services externes d’interagir par programmation avec les capacités de messages d’Aircall. Elle aide les entreprises à automatiser des processus, créer des intégrations et rationaliser les flux de travail liés aux SMS et aux MMS.
IMPORTANT: L’envoi de messages via API est uniquement disponible avec le forfait Professional d’Aircall. Pour passer à une offre supérieure, contactez notre équipe réussite client.
Cet article explique comment utiliser l’API de messages Aircall, sélectionner le bon point de terminaison selon vos besoins et respecter les réglementations pertinentes en matière de messages.
Vue d’ensemble de l’API de messages
L’API de messages Aircall permet aux administrateurs de récupérer l’activité des messages, d’envoyer des SMS et des MMS, et d’assurer la conformité. Lors de l’envoi de messages, vous pouvez choisir entre deux points de terminaison distincts :
- Option 1 : Envoyer un message sans passer par la boîte de réception Aircall
- Option 2 : Envoyer un message dans la conversation de l’Agent
Chacun fonctionne différemment, et il n’est pas possible d’utiliser les deux points de terminaison simultanément sur le même numéro Aircall.
Sélectionner le bon point de terminaison
Avant de sélectionner un point de terminaison, veuillez noter :
- La messagerie API est uniquement disponible pour les numéros Aircall activés pour les SMS.
- Les numéros Aircall avec messagerie API peuvent toujours être utilisés pour les appels entrants et sortants dans les applications Aircall.
Option 1 : point de terminaison Envoyer un message sans passer par la boîte de réception Aircall
L’utilisation du point de terminaison Envoyer un message sans passer par la boîte de réception Aircall permet à un numéro Aircall d’envoyer et de recevoir des SMS ou des MMS qui ne sont pas affichés dans les applications Aircall ni inclus dans les Webhooks. Les messages sont entièrement externes, votre système doit donc les enregistrer ailleurs.
Détails clés :
- Les SMS/MMS envoyés et reçus n’apparaissent pas dans les Webhooks ni dans les applications Aircall.
- Les MMS sont pris en charge.
- Une fois configuré avec ce point de terminaison, le numéro ne peut plus envoyer ni recevoir de messages depuis l’application Aircall. Pour rétablir la messagerie dans les applications Aircall, la configuration doit être supprimée.
Exemples de cas d’utilisation :
- Intégrer Aircall à un outil externe où les utilisateurs peuvent consulter les messages et y répondre directement.
- Envoyer des codes de vérification à usage unique ou des messages automatisés (par ex., confirmations de commande, mises à jour de livraison).
- Envoyer des messages marketing ou promotionnels non conversationnels.
Pour les détails de mise en œuvre, consultez Premiers pas avec l’envoi de messages sans passer par la boîte de réception Aircall à l’aide de l’API d’Aircall.
Option 2 : point de terminaison Envoyer un message dans la conversation de l’Agent
L’utilisation du point de terminaison Envoyer un message dans la conversation de l’Agent permet aux messages envoyés via API d’apparaître directement dans les applications Aircall. Contrairement à l’Option 1, cette configuration préserve la visibilité pour les utilisateurs et permet des conversations continues.
Détails clés :
- Les MMS via API ne sont pas pris en charge.
- Les SMS envoyés et reçus apparaissent dans les applications Aircall et dans les Webhooks d’événements de message.
- Combine l’automatisation avec la possibilité pour les utilisateurs Aircall de poursuivre la conversation dans l’application.
Exemples de cas d’utilisation :
- Accueillir automatiquement les clients qui envoient un SMS à votre numéro Aircall, en leur indiquant qu’un Agent leur répondra sous peu.
- Envoyer des messages automatisés déclenchés par des événements CRM (par exemple, lorsqu’un client atteint une étape spécifique). Toute réponse du client apparaît dans Aircall, ce qui permet aux agents de poursuivre la conversation sans interruption.
Pour les instructions de configuration, consultez Premiers pas avec le point de terminaison « Send Message in Agent Conversation » dans l’API d’Aircall.
Fonctionnalités et réglementations de la messagerie API Aircall
Quel que soit le point de terminaison utilisé, la messagerie via API doit respecter les normes du secteur et les réglementations locales.
États-Unis et Canada
- Les SMS automatisés et marketing sont autorisés si votre numéro est correctement enregistré (voir l’enregistrement A2P 10DLC et les directives pour les numéros gratuits) et si vous pouvez démontrer le consentement du client.
France
- Les lignes mobiles sont réservées à un usage personnel et conversationnel. Les SMS automatisés ou en masse via API sont interdits, mais la messagerie conversationnelle reste autorisée.
Conseils généraux
- Les lignes mobiles doivent être rattachées à un seul agent qui en contrôle l’usage.
- Vérifiez toujours la conformité avec les réglementations locales avant de mettre en œuvre une messagerie automatisée.
IMPORTANT: Demandez un conseil juridique local pour vous assurer que votre cas d’usage de messagerie est conforme.
Points à prendre en compte lors de l’utilisation de l’API de messages
Exigences réglementaires
- Les long codes américains et les numéros gratuits US/CA doivent être entièrement enregistrés avant utilisation.
- Seule la messagerie intranationale est prise en charge, sauf entre les États-Unis et le Canada (comme pour la messagerie depuis les applications Aircall).
Taux limite
Aircall limite les requêtes API à 120 par minute pour tous les points de terminaison. Des limites supplémentaires horaires, quotidiennes et mensuelles s’appliquent selon le type de numéro et le pays.
| Type de numéro | Limite horaire | Limite quotidienne | Limite mensuelle |
|---|---|---|---|
| Numéros US & CA | 1,000 | 10,000 | 20,000 |
| Lignes mobiles françaises | 100 | 1,000 | 10,000 |
| Autres lignes | 500 | 2,000 | 20,000 |
REMARQUE: Les taux limite peuvent être modifiés sans préavis afin de garantir un usage approprié.
Tarification
L’accès à l’API d’envoi de messages est inclus dans le forfait Professional. Le volume de messages provenant à la fois de l’API et de l’application est combiné sur votre facture, et les frais par message sont identiques à ceux engagés via les applications Aircall.
Pour passer à une offre supérieure ou en savoir plus, contactez notre équipe réussite client.
Pour poursuivre votre configuration :
- Pour l’Option 1, consultez Premiers pas avec l’envoi de messages sans passer par la boîte de réception Aircall à l’aide de l’API d’Aircall.
- Pour l’Option 2, consultez Premiers pas avec le point de terminaison « Send Message in Agent Conversation » dans l’API d’Aircall.