Un'unica API di messaggistica per otto canali
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.
curl -X POST https://api.broadnet.me/sms/sendSms \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"senderId": "OmniDemo",
"destinationNumber": "447700900123",
"message": "Your code is 482913",
"messageType": "TEXT"
}'
# 200 OK
2603121407537573731Una richiesta reale: POST /sms/sendSms restituisce l'ID del messaggio come testo semplice. Sostituite token, mittente (Sender ID) e numero con i vostri.
Risposta breve
Aggiornato
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'unica integrazione copre ogni canale usato dai vostri clienti, con gli strumenti che un team di produzione si aspetta.
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
Cosa è disponibile oggi e cosa viene configurato con il nostro team.
| Voce | Stato | Dettagli |
|---|---|---|
| API REST (SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email, push) | Disponibile | 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 | Disponibile | Configurati per account o sub-account. Gli stati sono normalizzati tra i canali. |
| SDK TypeScript | Disponibile | npm install @broadnet/cpaas-sdk axios. Altri linguaggi chiamano direttamente l'API REST o generano un client. |
| Specifica OpenAPI 3.1 | Disponibile | 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 | Disponibile | https://mcp.broadnet.me/mcp tramite Streamable HTTP, autenticato con il vostro token. |
| SMPP v3.4 su TLS | Su richiesta | 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) | Su richiesta | Attivata con il referente; nell'API REST non ci sono endpoint voce pubblici. |
Dalla prima richiesta alla produzione
Non c'è una registrazione immediata in autonomia. L'accesso parte da una breve richiesta, così l'account viene configurato per i vostri canali e paesi.
- 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.
Documentation
Everything you need to integrate, from your first API call to SMPP binds and AI agents. The documentation is in English.
- Get startedQuickstart: send your first messageGet test credentials, send your first SMS with cURL, Node.js, Python or PHP, receive the delivery status, and check what to do before going live.
- Get startedAuthenticationHow to authenticate API requests with a Bearer token, store and rotate it safely, read a 401 response, and connect Facebook Pages and Instagram via OAuth.
- Messaging channelsSMS APISend single and bulk SMS, choose TEXT or UNICODE encoding, count segments, schedule, control bulk jobs and look up numbers before you send.
- Messaging channelsWhatsApp Business APISend WhatsApp templates, text, media and interactive messages through one multipart endpoint, manage templates and batches, and track every recipient.
- Messaging channelsRCS Business Messaging APISend RCS text, media, rich cards, carousels and suggested replies, check device capability first, and plan SMS fallback for users without RCS.
- Messaging channelsFacebook Messenger APIConnect a Facebook Page with OAuth, then send Messenger text, media, button and carousel templates and quick replies within Meta's messaging windows.
- Messaging channelsInstagram Messaging APIConnect an Instagram professional account with OAuth and reply to Instagram DMs by API: text, media, quick replies, generic templates and reactions.
- Messaging channelsTelegram APISend Telegram text, photos, documents, video, location and contact messages from your connected sender, use saved templates, and smoke-test in a sandbox.
- Messaging channelsEmail APISend transactional and bulk email through your SMTP sender with HTML, templates, attachments, CC and scheduling, plus domain checks and a sandbox send.
- Messaging channelsPush Notifications APISend push notifications to your app's users by user reference, device token, topic or segment, with images, deep links, actions, templates and dry runs.
- Messaging channelsVoice: OTP, IVR, calls and AI agentsWhat voice can do on OmniChannels.ai, from voice OTP and IVR to AI voice agents and SMS-to-voice fallback, and how our team provisions it for your account.
- Events and errorsWebhooks and delivery statusesReceive delivery statuses and inbound messages on your HTTPS endpoint, respond fast, deduplicate events, and poll or re-trigger statuses when needed.
- Events and errorsErrors, retries and rate limitsHTTP status codes and error bodies, which errors to retry with backoff and jitter, default rate limits, pagination, and how to avoid duplicate sends.
- ConnectivitySMPP v3.4 connectivityWhen to use SMPP instead of REST, how binds are provisioned over TLS, submit_sm essentials, encoding, concatenation, delivery receipts and error codes.
- ToolsMCP server for AI agentsConnect Claude, Cursor, VS Code and other MCP clients to the messaging API so AI agents can send and track messages safely with your token.
- ToolsSDKs, OpenAPI spec and code samplesUse the TypeScript SDK, import the OpenAPI 3.1 spec into Postman or Insomnia, generate clients, and call the API from Java, .NET, Go and Ruby.
- ToolsOpenAPI 3.1 specDownload the public OpenAPI 3.1 spec of the messaging API, import it into Postman or Insomnia, generate clients and types, and give it to AI coding tools.
- ToolsUse the MCP server with Claude CodeAdd the OmniChannels.ai MCP server to Claude Code with claude mcp add, share it in .mcp.json, keep the token in an environment variable and gate send tools.
- ToolsUse the MCP server with CursorConnect Cursor to the OmniChannels.ai MCP server with .cursor/mcp.json, read the token from an environment variable, toggle tools and send a first message.
- ToolsUse the MCP server with n8nGive an n8n AI Agent the OmniChannels.ai messaging tools with the MCP Client Tool node, or call the REST API and receive delivery statuses with plain n8n nodes.
- ToolsMake and Zapier with webhooksSend messages from Make scenarios and Zaps with an HTTP request to the REST API, and get delivery statuses and inbound messages via a Make or Zapier webhook.
Come l'API si inserisce nei vostri sistemi
I vostri sistemi chiamano un'unica API REST con un solo token bearer. BroadNet instrada ogni messaggio sul canale e sull'operatore giusti e rimanda gli stati di consegna al vostro webhook.
La vostra app, il CRM o l'agente IA
- Token bearer, un solo URL di base
- SMPP 3.4 su TLS per volumi elevati
- Server MCP per agenti IA
API di messaggistica BroadNet
API di messaggistica BroadNethttps://api.broadnet.meIl telefono del vostro cliente
Stati di consegna al vostro webhook
SENTDELIVEREDREADFAILED
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.
Guide su questo argomento
- IntegrazioneIntegrare una API di messaggistica: REST, SMPP e webhook9 min di lettura
- MarketingInviato, consegnato, letto, fallito: gli stati dei messaggi8 min di lettura
- IntegrazioneCome collegare un CRM a una inbox omnicanale con i webhook8 min di lettura
- SMS e OTPMessaggi OTP su WhatsApp e SMS: sicurezza, consegna e frodi9 min di lettura
- WhatsAppCodici di errore WhatsApp Cloud API: significato e soluzioni8 min di lettura
- SMS e OTPCos'è l'SMS A2P? Come i messaggi aziendali arrivano al telefono8 min di lettura
Scoprite altre funzioni della piattaforma
Richiedete l'accesso di prova
Indicateci canali, paesi e volumi. Un tecnico configurerà le credenziali di prova per i vostri numeri verificati e vi aiuterà a pianificare il passaggio alla produzione.
Descriveteci i vostri sistemi e cosa volete collegare. Un solution engineer vi ricontatterà.