API de messagerie Aircall

L’API de messagerie Aircall fait partie de la boîte à outils pour développeurs d’Aircall, permettant aux applications et services externes d’interagir de manière programmatique avec les fonctionnalités de messagerie d’Aircall. Elle aide les entreprises à automatiser les processus, à créer des intégrations et à rationaliser les flux de travail liés aux messages SMS et MMS.

Important: :
L’envoi de messages via l’API est uniquement disponible avec le plan Aircall Professional. Pour passer à ce plan, veuillez contacter notre équipe Customer Success.

Cet article explique comment utiliser l’API de messagerie Aircall, choisir le bon point de terminaison selon vos besoins et respecter les réglementations pertinentes en matière de messagerie.

Présentation de l’API de messagerie

L’API de messagerie Aircall permet aux administrateurs de récupérer l’activité des messages, d’envoyer des SMS et 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
• Option 2 : Envoyer un message dans une conversation agent

Chaque option fonctionne différemment, et il n’est pas possible d’utiliser les deux points de terminaison simultanément sur un même numéro Aircall.

Choix du point de terminaison approprié

Avant de choisir 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

Utiliser le point de terminaison Envoyer un message permet à un numéro Aircall d’envoyer et de recevoir des messages SMS ou 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 ou applications Aircall.
• Le MMS est 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 restaurer la messagerie dans les applications Aircall, la configuration doit être supprimée.

Exemples d’utilisation :

• Intégrer Aircall avec un outil externe où les utilisateurs peuvent voir et répondre directement aux messages.
• Envoyer des codes de vérification uniques ou des messages automatisés (par exemple, confirmations de commande, mises à jour de livraison).
• Envoyer des messages marketing ou promotionnels non conversationnels.

Pour les détails d’implémentation, voir Premiers pas pour envoyer des messages avec l’API Aircall.

Option 2 : point de terminaison Envoyer un message dans une conversation agent

Utiliser le point de terminaison Envoyer un message dans une conversation agent permet aux messages envoyés via l’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 :

• Le MMS via API n’est 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 d’utilisation :

• Saluer automatiquement les clients qui envoient un SMS à votre numéro Aircall, en leur indiquant qu’un agent 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, permettant aux agents de poursuivre la conversation sans interruption.

Pour les instructions de configuration, voir Premiers pas avec le point de terminaison « Envoyer un message dans une conversation agent » dans l’API Aircall.

Fonctionnalités et réglementations de la messagerie API Aircall

Quel que soit le point de terminaison utilisé, la messagerie via l’API doit respecter les normes industrielles 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 enregistrement A2P 10DLC et directives pour les numéros gratuits) et que vous pouvez démontrer le consentement du client.

France

• Les lignes mobiles sont réservées à un usage personnel et conversationnel uniquement. 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 attribuées à un seul agent qui contrôle leur utilisation.
• Vérifiez toujours la conformité aux réglementations locales avant de mettre en œuvre la messagerie automatisée.

Important: :
Consultez un conseiller juridique local pour vous assurer que votre cas d’utilisation de la messagerie est conforme.

Considérations lors de l’utilisation de l’API de messagerie

Exigences réglementaires

• Les numéros longs US et les numéros gratuits US/CA doivent être entièrement enregistrés avant utilisation.
• Seule la messagerie domestique est prise en charge, sauf entre les États-Unis et le Canada (comme pour la messagerie depuis les applications Aircall).

Limites de débit

Aircall limite les requêtes API à 60 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.

REMARQUE :
Les limites de débit sont susceptibles d’être modifiées sans préavis afin d’assurer une utilisation appropriée.

Tarification

L’accès à l’API Envoyer un message est inclus dans le plan Professional. Le volume de messages provenant à la fois de l’API et des applications est combiné sur votre facture, et les frais par message sont identiques à ceux facturés via les applications Aircall.

Pour passer à ce plan ou en savoir plus, veuillez contacter notre équipe Customer Success.

Pour poursuivre votre configuration :

• Pour l’Option 1, voir Premiers pas pour envoyer des messages avec l’API Aircall.
• Pour l’Option 2, voir Premiers pas avec le point de terminaison « Envoyer un message dans une conversation agent » dans l’API Aircall.