Le endpoint Send Message Skipping Aircall Inbox dans l’API publique Aircall vous permet d’envoyer des messages SMS ou MMS depuis vos numéros de téléphone Aircall. Cela est utile lors de l’intégration d’outils externes ou d’applications personnalisées qui doivent envoyer des messages comme s’ils provenaient d’Aircall.

Avant d’utiliser ce endpoint, assurez-vous d’avoir consulté l’article À propos de l’API de messages Aircall, qui explique les options de messagerie disponibles, la tarification, les réglementations et les taux limite.

Important: L’envoi de messages via l’API est disponible uniquement avec le forfait Aircall Professional. Pour effectuer une mise à niveau, contactez notre équipe réussite client.

Configurer un numéro Aircall pour la messagerie API

Pour activer la messagerie basée sur l’API, vous devez configurer votre numéro Aircall à l’aide du endpoint messages/configuration. Cela prépare le numéro à envoyer des messages uniquement via l’API (et non via l’application Aircall).

Étapes :

  1. Effectuez une requête POST vers le endpoint API messages/configuration.
  2. Utilisez le endpoint GET pour confirmer la configuration si nécessaire.
  3. Utilisez le endpoint DELETE pour supprimer la configuration si vous devez un jour désactiver la messagerie API.
Remarque: La configuration est requise avant que vous puissiez envoyer des messages SMS ou MMS via l’API.

Envoyer des messages à l’aide de l’API

Une fois votre numéro configuré, vous pouvez envoyer des messages en appelant le endpoint messages/send.

Étapes :

  1. Préparez le corps de votre requête conformément à la documentation de l’API.
  2. Effectuez une requête POST vers le endpoint messages/send.
  3. Consultez le corps de la réponse pour confirmer le statut du message.
Important: Les messages envoyés via l’API ne sont enregistrés ni affichés nulle part dans la plateforme Aircall.

Exemple de réponse pour un message envoyé

{
  "id": "abcdSMc6Dc8ea2bc71ab19102c3de4f60ba18aa",
  "status": "pending",
  "direct_link": "https://api.aircall.io/v1/numbers/1234567/messages/abcdSMc6Dc8ea2bc71ab19102c3de4f60ba18aa",
  "direction": "outbound",
  "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": "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": "body of the message"
}

Recevoir les messages entrants sur votre URL de rappel

Lorsque vous configurez votre numéro pour la messagerie API, vous spécifiez également une URL de rappel. Ce endpoint recevra tous les messages entrants ou les réponses aux messages que vous avez envoyés.

Exemple de payload pour un message reçu

{
  "resource": "message",
  "event_name": "message.received",
  "timestamp": 1722604989549,
  "token": "91aa69db-c65e-42d9-85e7-g346b1h2204aa",
  "data": {
    "id": "abdcSM11da5992cb15eed9f21bcdb26d264bb40a",
    "status": "received",
    "direct_link": "https://api.aircall.io/v1/numbers/1234567/messages/abdcSM11da5992cb15eed9f21bcdb26d264bb40a",
    "direction": "inbound",
    "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": "Body of the message received"
  }
}

Tutoriels et ressources complémentaires

Un tutoriel technique est disponible et présente une implémentation complète de l’API SMS Aircall. L’examen de cet exemple peut vous aider à comprendre comment créer votre intégration efficacement.

Besoin d’assistance supplémentaire ?

Si vous ne disposez pas de ressources de développement, l’équipe solution engineer d’Aircall et les Partenaires certifiés peuvent vous aider avec des implémentations personnalisées. Contactez notre équipe réussite client pour explorer ces options.