API (Application Programming Interface)

Un'API è un'interfaccia standardizzata che permette a due programmi di parlarsi. Definisce esattamente quali dati un programma può richiedere e in quale forma riceve la risposta — come un cameriere che fa la spola tra il cliente (il suo software) e la cucina (la nostra piattaforma).

Che cos'è un'API?

API sta per «Application Programming Interface» (interfaccia di programmazione delle applicazioni). Un'API è la lingua condivisa con cui due sistemi software si scambiano informazioni. Non è un programma da utilizzare, ma un contratto: «Se mi invii A, io ti restituisco B».

Si immagini un ristorante. Come cliente, lei non vede la cucina. Parla con il cameriere. Il cameriere conosce il menu (= la documentazione dell'API), prende la sua ordinazione in una forma fissa («pasta al pomodoro») e le porta il risultato. La cucina può cambiare — nuovi chef, nuove attrezzature — e finché il cameriere mantiene lo stesso menu, la sua esperienza resta invariata. È esattamente così che un'API separa ciò che il suo software chiede dal modo in cui il servizio sottostante lo eroga.

Perché le API contano

Le API sono la spina dorsale invisibile del software moderno. Quando il suo strumento di contabilità dialoga con Stripe, quando il suo negozio online verifica le scorte in tempo reale, quando il suo sito incorpora Google Maps — c'è un'API che lavora dietro le quinte. Senza API, ogni azienda dovrebbe costruire da sola ogni funzionalità. Con le API, si assemblano servizi specializzati come mattoncini.

L'API nel contesto SendSeven

SendSeven espone un'API che permette al suo software di inviare messaggi, gestire contatti e leggere conversazioni — su WhatsApp, SMS, e-mail, Telegram, Instagram, Messenger e live chat. Tre esempi concreti:

  • Negozio online: Dopo ogni ordine, il suo negozio invia automaticamente una conferma WhatsApp — senza digitazione manuale.
  • CRM: Nel momento in cui un lead passa allo stato «caldo», il CRM fa partire un messaggio personalizzato sul canale preferito del cliente.
  • Helpdesk: I messaggi WhatsApp in entrata arrivano come ticket nel suo sistema di helpdesk — tramite webhook nella direzione opposta.

Tipi di API

Non tutte le API funzionano allo stesso modo. Le varianti più diffuse:

  • REST API: Lo standard attuale per le API web. Usa HTTP come un browser, è facile da usare, è supportata da ogni kit di programmazione. SendSeven usa REST.
  • GraphQL: Una variante in cui il client specifica esattamente quali campi vuole ricevere. Più efficiente per modelli di dati complessi.
  • WebSocket: Per connessioni in tempo reale dove il server stesso invia eventi (per esempio, «nuovo messaggio ricevuto»).
  • MCP Server: Un tipo di interfaccia più recente, progettato specificamente per agenti IA come Claude o GPT.

Autenticazione: chi può fare cosa?

Le API non sono aperte al pubblico. Ogni chiamata deve identificarsi. SendSeven usa un'API Key — un token segreto e personale che funziona come una password. Chi ha la chiave può agire a suo nome. Per questo una chiave API non va mai nel frontend, mai in un repository pubblico di GitHub, mai in un'e-mail.

Cosa succede quando qualcosa va storto?

Ogni API risponde con un codice di stato. 200 OK significa che va tutto bene. 401 significa che l'autenticazione è fallita. 429 significa troppe richieste — vedi rate limiting. 500 significa un errore lato server. Una buona integrazione controlla il codice di stato e reagisce con buonsenso — per esempio, riprovando dopo una breve pausa.

API vs Connettore vs SDK

Questi tre termini si confondono spesso:

  • API: L'interfaccia grezza — chiamate HTTP, risposte JSON. Richiede competenze di programmazione.
  • SDK: Una libreria pronta all'uso (in Python, JavaScript, PHP…) che semplifica l'API per gli sviluppatori.
  • Connettore: Un'integrazione pronta verso uno specifico sistema di terze parti (per esempio, il connettore Shopify). Spesso utilizzabile senza scrivere codice.

Mi serve un'API come PMI?

Risposta breve: solo se vuole automatizzare qualcosa che non è possibile di serie. SendSeven offre tre strade, a seconda della profondità tecnica:

  1. Piattaforma: Cliccare invece di programmare — la scelta predefinita per assistenza clienti e marketing.
  2. Connettori: Integrazioni pronte a Shopify, HubSpot, Zapier, ecc. — di solito senza codice.
  3. API: Per workflow su misura, software proprietario o operazioni di massa.