Résumé
Aircall offre la possibilité envoyer des SMS ou des MMS à l'aide de l'API publique Aircall Aircall. Cela permet aux clients de configurer des outils externes pour envoyer des SMS ou des MMS comme provenaient
un numéro de téléphone Aircall, en utilisant des développements personnalisés ou un middleware d'intégration low-code.Veuillez vous assurer d'avoir lu À propos de l'API de messagerie Aircall avant de poursuivre la lecture de cet article. Il met en évidence les principales différences entre les deux options de point de terminaison pour l'envoi de messages, ainsi que les tarifs, les réglementations et les détails des limites de débit.
⚠️ L'envoi de messages via API n'est disponible que sur le plan Aircall Professional. Pour passer au plan Professional, veuillez contacter votre responsable de la réussite client.
Premiers pas avec le point de terminaison « Envoyer un message »
Pour commencer à utiliser l'API de messagerie, veuillez consulter la documentation de l'API . Cette documentation couvre les éléments suivants :
Configuration de votre numéro Aircall pour la messagerie API (uniquement)
Configuration : vous devrez effectuer une requête POST au point de terminaison de l'API Aircall ' messages/configuration ' . Cela configurera votre numéro Aircall pour vous permettre d'envoyer des messages depuis l'API.
Remarque : il existe des points de terminaison GET et DELETE qui vous permettent de confirmer ou de supprimer la configuration.
Envoi de messages depuis votre numéro Aircall via API
Pour envoyer des messages depuis l'API, vous devrez utiliser le point de terminaison de l'API ' messages/send
Gardez à l'esprit que les messages envoyés ne seront pas enregistrés sur la plateforme Aircall.
Réception de messages de réponse sur votre URL de rappel
Le point de terminaison de l'URL de rappel (configuré à l'étape 1) recevra toutes les réponses ou messages entrants de votre numéro Aircall.
Le format de la réponse pour un message envoyé sera :
{
"id": "abcdSMc6Dc8ea2bc71ab19102c3de4f60ba18aa",
"status": "en attente",
"direct_link": "https://api.aircall.io/v1/numbers/1234567/messages/abcdSMc6Dc8ea2bc71ab19102c3de4f60ba18aa",
"direction": "sortant",
"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": "Ligne SMS US 1",
"digits": "+1 626-800-9000",
"country": "US",
"time_zone": "America/Chicago",
"open": true,
"created_at": "2024-07-17T13:12:10Z"
},
"body": "corps du message"
}
Le format de réponse d'un message reçu sera :
{
"resource": "message",
"event_name": "message.received",
"timestamp": 1722604989549,
"token": "91aa69db-c65e-42d9-85e7-g346b1h2204aa",
"data": {
"id": "abdcSM11da5992cb15eed9f21bcdb26d264bb40a",
"status": "reçu",
"direct_link": "https://api.aircall.io/v1/numbers/1234567/messages/abdcSM11da5992cb15eed9f21bcdb26d264bb40a",
"direction": "entrant",
"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": "Ligne SMS US 1",
"digits": "+1 626-800-9000",
"country": "US",
"time_zone": "Amérique/Chicago",
"open": true,
"created_at": "2024-07-17T13:12:10Z"
},
"body": "Corps du message reçu"
}
}
Tutoriels disponibles
Veuillez consulter ce didacticiel utile pour un exemple technique détaillé sur la mise en œuvre de l'API SMS d'Aircall.
Assistance supplémentaire
Si vous ne disposez pas des compétences de développement nécessaires pour utiliser cette fonctionnalité du produit, notre équipe d'ingénierie des solutions et nos partenaires sont à votre disposition pour vous aider à réaliser des implémentations personnalisées. Veuillez contacter votre responsable de réussite si vous souhaitez approfondir cette question.
Pour plus de détails sur l'API de messagerie Aircall, veuillez consulter : À propos de l'API de messagerie Aircall