---
title: "Un'unica API di messaggistica per otto canali"
description: "Un'unica API REST per SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email e push, con webhook, SMPP, SDK TypeScript e server MCP."
canonical: "https://omnichannels.ai/it/developers/"
language: "it"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Un'unica API di messaggistica per otto canali

Canonical: https://omnichannels.ai/it/developers/
Language: it
Publisher: OmniChannels.ai by BroadNet Technologies

Inviate SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email e push dal vostro codice con un solo URL di base e un solo token Bearer. Seguite ogni messaggio tramite webhook, fate scalare gli SMS con SMPP e lasciate che gli agenti IA usino la stessa API tramite MCP.

**Risposta breve:** OmniChannels.ai offre agli sviluppatori un'unica API REST per SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email e push. Include circa 225 percorsi documentati descritti in una specifica OpenAPI 3.1, un SDK TypeScript, webhook per lo stato di consegna, SMPP v3.4 su TLS e un server MCP per gli agenti IA. L'accesso di prova invia ai vostri numeri verificati, i tecnici supportano l'integrazione e i rivenditori possono usare la stessa API con il proprio marchio.

## Cosa ottenete come sviluppatori

- **Un'API REST, otto canali:** SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email e push condividono un URL di base, un token Bearer e un formato di errore, quindi aggiungere un canale significa un nuovo endpoint, non un nuovo fornitore.
- **OpenAPI 3.1 e SDK TypeScript:** Circa 225 percorsi documentati in una specifica OpenAPI 3.1 che potete importare in Postman o usare per generare client, più il pacchetto ufficiale @broadnet/cpaas-sdk per TypeScript e Node.js.
- **Webhook per lo stato di consegna:** Gli stati sono normalizzati tra i canali (SUBMITTED, SENT, DELIVERED, READ, FAILED e REJECTED) e inviati al vostro endpoint HTTPS, con endpoint di polling e di nuovo invio come rete di sicurezza.
- **SMPP v3.4 per SMS ad alto volume:** Connessioni transceiver su TLS con IP allow-list, attivate per il vostro account, sulle stesse rotte dirette verso gli operatori dell'API REST.
- **Server MCP per agenti IA:** Collegate Claude, Cursor o qualsiasi client MCP all'API con il vostro token, così gli agenti possono inviare messaggi e leggere i rapporti di consegna entro i limiti che stabilite.
- **Provate prima di andare online:** Le credenziali di prova inviano ai vostri numeri verificati sullo stesso URL di base della produzione, quindi il vostro codice non cambia al passaggio.
- **Assistenza da parte di tecnici:** Un tecnico di messaggistica esamina il vostro caso d'uso, vi aiuta nella progettazione REST o SMPP, nei mittenti (Sender ID) e nelle regole dei paesi e resta con voi fino alla messa online.
- **Pensata per i rivenditori:** I rivenditori usano la stessa API con il proprio marchio, con sub-account che hanno ciascuno credito, mittenti (Sender ID), utenti e webhook propri, più un'API per rivenditori per gestire gli account.

## Il lato sviluppatori in sintesi

| Voce | Dettagli |
|---|---|
| API REST (SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email, push) | URL di base https://api.broadnet.me con autenticazione tramite token Bearer. L'accesso di prova viene rilasciato dopo una breve richiesta. |
| Webhook per lo stato di consegna | Configurati per account o sub-account. Gli stati sono normalizzati tra i canali. |
| SDK TypeScript | npm install @broadnet/cpaas-sdk axios. Altri linguaggi chiamano direttamente l'API REST o generano un client. |
| Specifica OpenAPI 3.1 | Pubblica su https://omnichannels.ai/developers/openapi.json (YAML in /developers/openapi.yaml): ogni operazione che un token cliente può chiamare, per Postman, Insomnia, generazione di client e strumenti di programmazione con IA. |
| Server MCP | https://mcp.broadnet.me/mcp tramite Streamable HTTP, autenticato con il vostro token. |
| SMPP v3.4 su TLS | Connessioni (bind), throughput e IP allow-list vengono attivati per il vostro account dal nostro team. |
| Voce (OTP, IVR, chiamate in uscita, agenti vocali IA) | Attivata con il referente; nell'API REST non ci sono endpoint voce pubblici. |

## Dalla prima richiesta alla produzione

1. **Richiedete l'accesso di prova:** Indicateci canali, paesi di destinazione, volumi e caso d'uso. Un tecnico esamina la richiesta e rilascia le credenziali di prova.
2. **Inviate il primo messaggio di prova:** Seguite la guida rapida per inviare un SMS al vostro numero verificato e ricevere il suo stato di consegna sul vostro webhook.
3. **Sviluppate l'integrazione:** Aggiungete i canali che vi servono, gestite errori e nuovi tentativi e registrate gli ID dei messaggi. I nostri tecnici possono rivedere la vostra progettazione per REST o SMPP.
4. **Fate approvare i mittenti:** Mittenti (Sender ID), account WhatsApp Business e agenti RCS vengono registrati in parallelo allo sviluppo, secondo le regole di ogni paese e piattaforma.
5. **Andate online:** Le rotte di produzione vengono attivate per il vostro account. Il vostro codice continua a chiamare lo stesso URL di base, quindi al passaggio non cambia nulla.

## Questa API fa per il vostro team?

### È la scelta giusta quando

- Volete un'unica integrazione per SMS, WhatsApp, RCS, messaggistica social, email e push invece di più fornitori.
- Vi servono gli stati di consegna per messaggio nei vostri sistemi, non solo in una dashboard.
- Inviate volumi elevati di SMS e volete SMPP accanto a REST.
- Rivendete messaggistica e vi serve la stessa API con il vostro marchio, con sub-account.
- Create agenti IA che devono inviare e tracciare messaggi tramite MCP.

### Da sapere prima di iniziare

- Non c'è una registrazione immediata in autonomia; l'accesso di prova viene rilasciato dopo una breve richiesta.
- L'SDK ufficiale è solo per TypeScript; gli altri linguaggi usano HTTP semplice o un client generato dalla specifica.
- L'API non accetta una chiave di idempotenza, quindi la vostra integrazione registra ogni invio prima di riprovare.
- Voce e SMPP vengono attivati con il nostro team e non tramite endpoint pubblici.
- Gli invii su WhatsApp, Messenger e Instagram seguono le regole di Meta, inclusi modelli approvati e finestre di messaggistica.

## Domande degli sviluppatori

### Come mi autentico?

Inviate il token di accesso del vostro account in un'intestazione Authorization: Bearer a ogni richiesta. I token sono rilasciati per account; non esiste un endpoint che scambi nome utente e password con un token. Un token mancante o non valido restituisce 401. Tenete il token sui vostri server, mai nel codice del browser o delle app mobili.

### Qual è l'URL di base e c'è una sandbox separata?

Ogni chiamata va a https://api.broadnet.me, senza prefisso di versione. Test e produzione usano lo stesso URL di base: le credenziali di prova inviano solo ai vostri numeri verificati e la produzione viene attivata per il vostro account dopo l'approvazione dei mittenti, quindi il vostro codice non cambia.

### Come ricevo i rapporti di consegna?

Gli stati vengono inviati all'URL del webhook configurato sul vostro account: SUBMITTED, SENT, DELIVERED, READ sui canali che segnalano la lettura, FAILED e REJECTED. Potete anche fare polling, ad esempio con GET /sms/list per i lavori SMS massivi e GET /whatsapp/message/bulk-insights per i lotti WhatsApp.

### Come gestisco nuovi tentativi e duplicati?

Riprovate solo in caso di errori di rete e risposte 429 e 5xx, con backoff esponenziale e jitter, e non ripetete mai invariati gli errori 4xx. L'API non accetta una chiave di idempotenza, quindi registrate ogni invio prima di effettuarlo, memorizzate l'ID del messaggio restituito e controllate lo stato dopo un timeout prima di inviare di nuovo.

### Quali sono i limiti di frequenza?

I valori predefiniti documentati sono 200 richieste al secondo per REST con picchi fino a 500 per un massimo di 60 secondi, 1.000 messaggi al secondo per ogni bind SMPP e 50 richieste al secondo per le verifiche dei numeri. I limiti del vostro account vengono confermati con le credenziali. Le richieste oltre il limite restituiscono 429 con un'intestazione Retry-After.

### Quali linguaggi sono supportati?

Qualsiasi linguaggio in grado di effettuare richieste HTTPS. C'è un SDK ufficiale TypeScript, @broadnet/cpaas-sdk, e la documentazione include esempi in HTTP semplice per cURL, Node.js, Python, PHP, Java, .NET, Go e Ruby. Potete anche generare un client dalla specifica pubblica OpenAPI 3.1 in /developers/openapi.json.

### Devo usare REST o SMPP per gli SMS?

REST è adatto alla maggior parte delle applicazioni e offre ogni canale tramite un'unica API. SMPP v3.4 su TLS è adatto agli SMS ad alto volume costante, soprattutto se avete già un client SMPP. Connessioni (bind), throughput e IP allow-list vengono attivati per il vostro account e potete usare entrambi su uno stesso account.

### Posso rivendere messaggistica tramite l'API?

Sì. I rivenditori usano la stessa API con il proprio marchio. Ogni sub-account ha credito, mittenti (Sender ID), utenti e webhook propri e un'API per rivenditori copre creazione degli account, ricariche di credito, listini e rapporti. Indicate la rivendita quando richiedete l'accesso, così impostiamo la struttura insieme a voi.

Aggiornato: 2026-10-10