À propos de l'API de messagerie Aircall

Présentation

L'API de messagerie fait partie de la suite d'outils de développement d'Aircall qui permettent aux applications et services externes d'interagir par programmation avec les fonctionnalités de messagerie d'Aircall. Cela permet aux entreprises de créer des automatisations, intégrations et de rationaliser les flux de travail liés aux SMS et aux MMS.

Cet article couvre :

• Présentation de l'API de messagerie
  • Sélectionner le point de terminaison adapté à vos besoins
    • Option 1 : « Envoyer un message »
    • Option 2 : « Envoyer un message dans une conversation avec un agent »
  • Exemples de cas d'utilisation
• Considérations lors de l'utilisation de l'API pour l'envoi de SMS
  • Orientations générales sur la réglementation Aircall
  • Spécifications de limite de débit
• Détails des prix

Présentation de l'API de messagerie

Grâce à cette API publique, les administrateurs peuvent récupérer l'activité de messagerie, envoyer des messages et garantir la conformité, entre autres fonctionnalités. Lorsqu'il s'agit d'envoyer des messages, vous pouvez exploiter l'API de messagerie avec deux points de terminaison bien différents . À l'aide des descriptions et des exemples ci-dessous, il est important de sélectionner l'option de point de terminaison qui correspond à vos besoins (car ils se comportent différemment).

Il n'est pas possible d'utiliser simultanément les deux options de point de terminaison sur le même numéro Aircall.

Sélection du point de terminaison adapté à vos besoins

Avant de sélectionner une option, veuillez noter :

• La messagerie API n'est possible que pour les numéros Aircall activés pour les SMS
• Les numéros Aircall avec API Messaging peuvent toujours être utilisés pour les appels entrants & sortants dans les applications Aircall.

Option 1 : point de terminaison « Envoyer un message »

Lorsque vous utilisez le point de terminaison Envoyer un message avec un numéro Aircall, les SMS/MMS envoyés & reçus ne sont pas visibles dans les applications Aircall ou les webhooks. Cela signifie que les messages envoyés & reçus ne seront pas visibles pour les utilisateurs directement dans Aircall. Par conséquent, avec cette option, il incombe au client d'enregistrer tous les messages envoyés & reçus dans un emplacement externe de votre choix.

❌ Les SMS/MMS envoyés & reçus n'apparaîtront pas dans les webhooks Aircall

✅ MMS est pris en charge avec cette option

⚠️ Une fois qu'un numéro est configuré avec ce point de terminaison, il ne peut plus envoyer/recevoir de messages depuis les interfaces de l'application Aircall. Pour que les utilisateurs puissent à nouveau envoyer/recevoir des messages dans les applications Aircall, la configuration doit être supprimée du numéro.

Exemples de cas d'utilisation

• Créez une intégration pour que les utilisateurs puissent voir et répondre aux messages texte directement à partir d'un outil externe ( voir le blog pour plus d'inspiration)
• Envoyez des messages non conversationnels tels que des codes de vérification à usage unique à des fins d'authentification à deux facteurs, des confirmations de commande automatisées ou des notifications de livraison par SMS
• Envoyez des messages non conversationnels à des fins de marketing et de contenu promotionnel via SMS

Cet article et tutoriel expliquent plus en détail comment exploiter le point de terminaison Envoyer un message avec un numéro Aircall.

Option 2 : point de terminaison « Envoyer un message dans une conversation avec l'agent »

Lorsque vous utilisez le point de terminaison Envoyer un message dans une conversation avec un agent avec un numéro Aircall, les SMS envoyés & reçus sont visibles directement dans les applications Aircall (contrairement à l'option 1).

❌ L'envoi de MMS via API n'est actuellement pas pris en charge avec cette option

✅ Les SMS envoyés & reçus sont visibles dans les applications Aircall et via Webhooks d'événements de message

⚠️ Cette option combine l'automatisation et la possibilité pour les utilisateurs d'Aircall de poursuivre la conversation comme indiqué ci-dessous.

Exemples de cas d'utilisation

• Envoyez un message automatique pour accueillir les clients qui envoient un SMS à votre numéro Aircall. Faites-leur savoir qu'ils seront bientôt pris en charge (capture d'écran ci-dessous). Cela illustre également comment les messages envoyés via l'API sont affichés avec « Outil externe » comme nom d'expéditeur dans les applications Aircall.

• Déclenchement de messages en fonction des activités CRM. Par exemple, si un client passe à une étape spécifique, l'API peut envoyer un message pour engager le client et toute réponse apparaît dans Aircall pour qu'un membre de l'équipe poursuive la conversation.

Comme indiqué ci-dessus, les clients peuvent répondre aux messages envoyés via l'API, et ces réponses seront affichées directement dans la vue de conversation pour que les utilisateurs d'Aircall aient une visibilité et une continuité lorsqu'ils communiquent avec les clients.

Cet article explique plus en détail comment exploiter le Envoyer un message dans une conversation avec un agent point de terminaison avec un numéro Aircall.

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

Quel que soit l'outil que vous utilisez pour envoyer des SMS, les normes du secteur et les réglementations locales s'appliquent toujours.

Aux États-Unis ou au Canada, l'envoi de SMS de manière automatisée et à des fins de marketing est acceptable à condition que le numéro soit enregistré à cette fin (voir l'article sur A2P 10DCL et sans frais ) et que vous pouvez prouver votre consentement.

Les lignes mobiles sont censées être personnelles, ce qui signifie qu'elles ne doivent être rattachées qu'à un seul agent. Lorsque vous utilisez l'API avec des lignes mobiles, vous devez vous assurer que seul l'agent en question contrôle le cas d'utilisation mis en œuvre.

En France par exemple, les lignes mobiles sont destinées à un usage personnel et conversationnel uniquement, ce qui signifie qu'il est interdit d'utiliser l'API pour envoyer des SMS de manière automatisée. Il est néanmoins possible d'engager une communication conversationnelle via l'API.

⚠️ Demandez conseil à votre interlocuteur local pour vous assurer que vous configurez des cas d'utilisation conformes.

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

Exigences réglementaires

• La configuration des codes longs américains ou des numéros gratuits US/CA ne fonctionnera que pour les numéros entièrement enregistrés.
• Nous autorisons uniquement les envois nationaux, à l'exception des messages entre les États-Unis et le Canada, comme décrit pour la messagerie directement depuis les applications Aircall .

Limites de débit

• L'API Aircall limite le nombre de requêtes à 60 par minute, quel que soit le point de terminaison utilisé. Certaines restrictions spécifiques sont également appliquées pour éviter une utilisation excessive de la fonction d'envoi de messages. Aircall met en œuvre des limites horaires, quotidiennes et mensuelles spécifiques qui sont différentes pour chaque type de numéro et chaque pays. Ces limites sont susceptibles d'être modifiées sans préavis pour garantir une utilisation appropriée.
• Les numéros américains et canadiens bénéficient de limites de segment SMS sortant de 1 000 par heure, 10 000 par jour et 20 000 par mois.
• Les lignes mobiles françaises bénéficient de limites de 100 heures, 1 000 jours et 10 000 mois pour garantir des cas d'utilisation conversationnels.
• Les autres limites de ligne sont de 500 segments SMS sortants par heure, 2 000 par jour et 20 000 par mois.

Tarifs

L'accès à l'API d'envoi de messages est inclus dans le forfait Professionnel. Contactez votre responsable de la réussite client ou votre équipe d'assistance si vous souhaitez mettre à niveau votre forfait d'abonnement.

• Les frais par volume envoyé sont les mêmes que ceux facturés lors d'un envoi via les applications Aircall.
• Le volume provenant à la fois des sources API et des sources d'application sera résumé dans vos factures.

Pour continuer avec l'option 1, continuez à lire : Commencer à envoyer des messages à l'aide de l'API d'Aircall .

Pour continuer avec l'option 2, continuez à lire : Premiers pas avec le point de terminaison « Envoyer un message dans une conversation avec un agent » dans l'API d'Aircall