L'API Aircall Message fa parte del kit di strumenti per sviluppatori di Aircall e consente ad applicazioni e servizi esterni di interagire in modo programmatico con le funzionalità di messaggistica di Aircall. Aiuta le aziende ad automatizzare i processi, creare integrazioni e semplificare i flussi di lavoro relativi alla messaggistica SMS e MMS.
IMPORTANTE: L'invio di messaggi tramite API è disponibile solo con il piano Aircall Professional. Per effettuare l'upgrade, contatta il nostro team Customer Success.
Questo articolo spiega come utilizzare l'API Aircall Message, selezionare l'endpoint corretto per le proprie esigenze e rispettare le normative applicabili alla messaggistica.
Panoramica dell'API Message
L'API Aircall Message consente agli amministratori di recuperare l'attività dei messaggi, inviare messaggi SMS e MMS e garantire la conformità. Per l'invio dei messaggi, è possibile scegliere tra due endpoint distinti:
- Opzione 1: inviare un messaggio ignorando la casella di posta Aircall
- Opzione 2: inviare un messaggio nella conversazione dell'agente
Ognuno funziona in modo diverso e non è possibile utilizzare contemporaneamente entrambi gli endpoint sullo stesso numero Aircall.
Selezione dell'endpoint corretto
Prima di selezionare un endpoint, tieni presente quanto segue:
- La messaggistica tramite API è disponibile solo per i numeri Aircall abilitati per gli SMS.
- I numeri Aircall con messaggistica tramite API possono comunque essere utilizzati per le chiamate in entrata e in uscita nelle app Aircall.
Opzione 1: endpoint per l'invio di messaggi ignorando la casella di posta Aircall
L'utilizzo dell'endpoint per l'invio di messaggi ignorando la casella di posta Aircall consente a un numero Aircall di inviare e ricevere messaggi SMS o MMS che non vengono visualizzati nelle app Aircall né inclusi nei webhook. I messaggi sono completamente esterni, pertanto il tuo sistema deve registrarli altrove.
Dettagli principali:
- Gli SMS/MMS inviati e ricevuti non vengono visualizzati nei webhook o nelle app Aircall.
- Gli MMS sono supportati.
- Una volta configurato con questo endpoint, il numero non può inviare o ricevere messaggi dall'app Aircall. Per ripristinare la messaggistica nelle app Aircall, è necessario rimuovere la configurazione.
Esempi di casi d'uso:
- Integrare Aircall con uno strumento esterno in cui gli utenti possano visualizzare i messaggi e rispondere direttamente.
- Inviare codici di verifica monouso o messaggi automatici (ad esempio, conferme d'ordine e aggiornamenti sulle consegne).
- Inviare messaggi di marketing o promozionali non conversazionali.
Per i dettagli sull'implementazione, consulta Introduzione all'invio di messaggi ignorando la casella di posta Aircall mediante l'API di Aircall.
Opzione 2: endpoint per l'invio di messaggi nella conversazione dell'agente
L'utilizzo dell'endpoint Invia messaggio nella conversazione dell'agente consente ai messaggi inviati tramite API di apparire direttamente nelle app Aircall. A differenza dell'opzione 1, questa configurazione mantiene i messaggi visibili agli utenti e consente di proseguire le conversazioni.
Dettagli principali:
- Gli MMS tramite API non sono supportati.
- Gli SMS inviati e ricevuti vengono visualizzati nelle app Aircall e nei webhook degli eventi dei messaggi.
- Combina l'automazione con la possibilità per gli utenti Aircall di continuare la conversazione all'interno dell'app.
Esempi di casi d'uso:
- Salutare automaticamente i clienti che inviano un SMS al tuo numero Aircall, informandoli che un agente risponderà a breve.
- Inviare messaggi automatici attivati da eventi del CRM (ad esempio, quando un cliente raggiunge una fase specifica). Le risposte del cliente vengono visualizzate in Aircall, consentendo agli agenti di continuare la conversazione senza interruzioni.
Per le istruzioni di configurazione, consulta Introduzione all'endpoint «Invia messaggio nella conversazione dell'agente» nell'API di Aircall.
Funzionalità e normative della messaggistica tramite API di Aircall
Indipendentemente dall'endpoint utilizzato, la messaggistica tramite API deve rispettare gli standard di settore e le normative locali.
Stati Uniti e Canada
- Gli SMS automatici e di marketing sono consentiti se il numero è registrato correttamente (consulta le linee guida sulla registrazione A2P 10DLC e sui numeri verdi) e se è possibile dimostrare il consenso del cliente.
Francia
- Le linee mobili sono destinate esclusivamente a un uso personale e conversazionale. Gli SMS automatici o in massa tramite API sono vietati, ma la messaggistica conversazionale rimane consentita.
Indicazioni generali
- Le linee mobili devono essere assegnate a un singolo agente che ne controlla l'utilizzo.
- Verifica sempre la conformità alle normative locali prima di implementare la messaggistica automatica.
IMPORTANTE: Richiedi una consulenza legale locale per assicurarti che il tuo caso d'uso della messaggistica sia conforme.
Considerazioni sull'utilizzo dell'API Message
Requisiti normativi
- I numeri geografici statunitensi e i numeri verdi di Stati Uniti e Canada devono essere completamente registrati prima dell'uso.
- È supportata solo la messaggistica nazionale, ad eccezione di quella tra Stati Uniti e Canada (come per la messaggistica dalle app Aircall).
Limiti di frequenza
Aircall limita le richieste API a 120 al minuto per tutti gli endpoint. Si applicano ulteriori limiti orari, giornalieri e mensili in base al tipo di numero e al Paese.
| Tipo di numero | Limite orario | Limite giornaliero | Limite mensile |
|---|---|---|---|
| Numeri di Stati Uniti e Canada | 1,000 | 10,000 | 20,000 |
| Linee mobili francesi | 100 | 1,000 | 10,000 |
| Altre linee | 500 | 2,000 | 20,000 |
NOTA: I limiti di frequenza sono soggetti a modifiche senza preavviso per garantirne un uso corretto.
Prezzi
L'accesso all'API Send Message è incluso nel piano Professional. Il volume dei messaggi provenienti sia dall'API sia dall'app viene conteggiato insieme in fattura e le tariffe per messaggio sono identiche a quelle applicate tramite le app Aircall.
Per effettuare l'upgrade o saperne di più, contatta il nostro team Customer Success.
Per continuare la configurazione:
- Per l'Opzione 1, consulta Primi passi per inviare messaggi ignorando la casella di posta Aircall tramite l'API di Aircall.
- Per l'Opzione 2, consulta Primi passi con l'endpoint «Send Message in Agent Conversation» nell'API di Aircall.