L'endpoint Send Message Skipping Aircall Posta in arrivo nell'API pubblica di Aircall consente di inviare messaggi SMS o MMS dai propri Numeri di telefono Aircall. È utile per integrare Strumenti esterni o applicazioni personalizzate che devono inviare messaggi come se provenissero da Aircall.

Prima di utilizzare questo endpoint, assicurati di aver consultato l'articolo Informazioni sull'API di Messaggistica Aircall, che illustra le opzioni di Messaggistica disponibili, i prezzi, le normative e i Limiti di frequenza.

Importante: L'invio di messaggi tramite l'API è Disponibile solo con il Piano Aircall Professional. Per effettuare l'upgrade, contatta il nostro Team Successo del cliente.

Configurare un Numero Aircall per la Messaggistica tramite API

Per abilitare la Messaggistica basata su API, devi configurare il tuo Numero Aircall utilizzando l'endpoint messages/configuration. In questo modo, il Numero potrà inviare messaggi esclusivamente tramite l'API, non tramite l'App Aircall.

Passaggi:

  1. Effettua una richiesta POST all'endpoint API messages/configuration.
  2. Se necessario, utilizza l'endpoint GET per confermare la configurazione.
  3. Utilizza l'endpoint DELETE per rimuovere la configurazione se devi disabilitare la Messaggistica tramite API.
Nota: La configurazione è necessaria prima di poter inviare messaggi SMS o MMS tramite l'API.

Inviare messaggi tramite l'API

Una volta configurato il Numero, puoi inviare messaggi chiamando l'endpoint messages/send.

Passaggi:

  1. Prepara il corpo della richiesta in base alla documentazione dell'API.
  2. Effettua una richiesta POST all'endpoint messages/send.
  3. Controlla il corpo della risposta per confermare lo stato del messaggio.
Importante: I messaggi inviati tramite l'API non vengono registrati né visualizzati in alcun punto della piattaforma Aircall.

Esempio di risposta per un messaggio inviato

{
  "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"
}

Ricevere messaggi In entrata sull'URL di callback

Quando configuri il tuo Numero per la Messaggistica tramite API, specifichi anche un URL di callback. Questo endpoint riceverà tutti i messaggi In entrata o le risposte ai messaggi inviati.

Esempio di payload per un messaggio ricevuto

{
  "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"
  }
}

Tutorial e ulteriori risorse di apprendimento

È Disponibile un tutorial tecnico che illustra un'implementazione completa dell'API SMS di Aircall. Esaminare questo esempio può aiutarti a comprendere come creare efficacemente la tua integrazione.

Hai bisogno di ulteriore Supporto?

Se non disponi di risorse di sviluppo, il Team di Ingegneria delle soluzioni di Aircall e i Partner certificati possono aiutarti con implementazioni personalizzate. Contatta il nostro Team Successo del cliente per valutare queste opzioni.