API di messaggistica Aircall

L'API Messaggi di Aircall fa parte del toolkit 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 ottimizzare i Flussi di lavoro relativi alla Messaggistica tramite 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 Successo del cliente.

Questo articolo spiega come utilizzare l'API Messaggi di Aircall, selezionare l'endpoint corretto per le proprie esigenze e rispettare le normative applicabili alla Messaggistica.

Panoramica dell'API Messaggi

L'API Messaggi di Aircall consente agli amministratori di recuperare l'attività dei messaggi, inviare messaggi SMS e MMS e garantire la conformità. Quando invii messaggi, puoi scegliere tra due endpoint distinti:

• Opzione 1: Invia messaggio ignorando la Posta in arrivo di Aircall
• Opzione 2: Invia messaggio nella conversazione dell'Agente

Ciascuno funziona in modo diverso e non è possibile utilizzare entrambi gli endpoint contemporaneamente sullo stesso Numero Aircall.

Selezione dell'endpoint appropriato

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 le Chiamate in uscita nelle App Aircall.

Opzione 1: endpoint Invia messaggio ignorando la Posta in arrivo di Aircall

L'utilizzo dell'endpoint Invia messaggio ignorando la Posta in arrivo di 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, quindi il tuo sistema deve registrarli altrove.

Dettagli principali:

• Gli SMS/MMS inviati e ricevuti non compaiono 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 possono visualizzare i messaggi e rispondere direttamente.
• Inviare codici di verifica monouso o messaggi automatici (ad esempio, conferme degli ordini e aggiornamenti sulle consegne).
• Inviare messaggi promozionali o di marketing non conversazionali.

Per i dettagli sull'implementazione, consulta Primi passi con l'invio di messaggi ignorando la Posta in arrivo di Aircall tramite l'API di Aircall.

Opzione 2: endpoint Invia messaggio 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 la visibilità per gli Utenti e consente di proseguire le Conversazioni.

Dettagli principali:

• Gli MMS tramite API non sono supportati.
• Gli SMS inviati e ricevuti compaiono 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 messaggio 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). Tutte le risposte del cliente compaiono in Aircall, consentendo agli Agenti di continuare la conversazione senza interruzioni.

Per le istruzioni di configurazione, consulta Primi passi con l'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 del settore e le normative locali.

Stati Uniti e Canada

• Gli SMS automatici e di marketing sono consentiti se il Numero è registrato correttamente (consulta la registrazione A2P 10DLC e le linee guida per i Numeri verdi) e puoi dimostrare il consenso del cliente.

Francia

• Le linee Mobile sono destinate esclusivamente all'uso personale e conversazionale. Gli SMS automatici o in blocco tramite API sono vietati, ma la Messaggistica conversazionale rimane consentita.

Indicazioni generali

• Le linee Mobile 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 Messaggi

Requisiti normativi

• I long code statunitensi e i Numeri verdi di Stati Uniti e Canada devono essere completamente registrati prima dell'uso.
• È supportata solo la Messaggistica nazionale, tranne che 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.

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 complessivamente nella 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 di Successo del cliente.

Per continuare la configurazione:

• Per l'Opzione 1, consulta Introduzione all'invio di messaggi ignorando la Posta in arrivo di Aircall tramite l'API di Aircall.
• Per l'Opzione 2, consulta Introduzione all'endpoint «Send Message in Agent Conversation» nell'API di Aircall.