---
title: "Come aggiungo l’invio di SMS alla mia app tramite API?"
description: "Come aggiungere l’invio di SMS alla vostra app con le API: credenziali, formato dei numeri, codifica, webhook di consegna, nuovi tentativi e controlli prima del go-live."
canonical: "https://omnichannels.ai/it/answers/integrate-sms-api/"
language: "it"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Come aggiungo l’invio di SMS alla mia app tramite API?

Canonical: https://omnichannels.ai/it/answers/integrate-sms-api/
Language: it
Publisher: OmniChannels.ai by BroadNet Technologies

**Risposta breve:** Per aggiungere l’invio di SMS a un’app, chiamate l’API SMS del provider dal vostro backend con un token di accesso, il numero del destinatario in formato internazionale, un Sender ID approvato e il testo del messaggio. Salvate l’ID messaggio restituito, ricevete gli stati di consegna su un webhook e gestite errori, nuovi tentativi e limiti di frequenza prima del go-live.

## Passaggi per l’integrazione

1. Ottenete credenziali di test e registrate i numeri di prova a cui invierete.
2. Conservate il token API in un gestore di segreti o in una variabile d’ambiente sul vostro server, mai in un’app mobile o nel codice del browser.
3. Memorizzate i numeri in formato E.164 e convertiteli nel formato richiesto dall’API.
4. Scegliete la codifica: testo GSM-7 oppure Unicode per arabo, emoji e altri alfabeti.
5. Inviate il messaggio e salvate l’ID messaggio restituito accanto al vostro record.
6. Configurate un webhook per ricevere gli stati di consegna.
7. Aggiungete nuovi tentativi con backoff per le risposte 429 e 5xx e registrate i Sender ID per ogni paese che li richiede.

## Errori da evitare

- Chiamare l’API dall’app client, esponendo il token a chiunque.
- Inviare numeri con segno più, spazi o zero iniziale nazionale quando l’API si aspetta solo cifre.
- Lasciare che un solo apice tipografico o una sola emoji porti l’intero messaggio in Unicode, riducendo i caratteri per segmento.
- Ritentare alla cieca dopo un timeout. Se l’API non ha una chiave di idempotenza, registrate prima ogni invio e controllatene lo stato prima di rinviare.
- Ignorare le risposte 429 invece di attendere l’intestazione Retry-After.

## Esempio: una singola richiesta SMS

Su OmniChannels.ai inviate un SMS con POST https://api.broadnet.me/sms/sendSms, un’intestazione Authorization: Bearer e un corpo JSON. Una chiamata riuscita restituisce 200 con l’ID messaggio come testo semplice. L’accesso di test viene rilasciato dopo una breve richiesta e vale per i vostri numeri verificati; non esiste una registrazione self-service immediata.

| Campo | Esempio | Nota |
|---|---|---|
| senderId | OmniDemo | Il vostro Sender ID approvato |
| destinationNumber | 447700900123 | Prefisso internazionale più numero, solo cifre |
| message | Codice di verifica: 482913 | Il testo |
| messageType | TEXT | TEXT per GSM-7, UNICODE per arabo ed emoji |

## Fonti ufficiali

- [RFC 9110: HTTP Semantics (IETF)](https://datatracker.ietf.org/doc/html/rfc9110)
- [ITU-T Recommendation E.164 — The international public telecommunication numbering plan](https://www.itu.int/rec/T-REC-E.164)
- [3GPP TS 23.038 — Alphabets and language-specific information](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=745)

## Domande correlate

- https://omnichannels.ai/it/answers/smpp-vs-http-api/
- https://omnichannels.ai/it/answers/delivery-report-webhook/
- https://omnichannels.ai/it/answers/why-sms-split-into-parts/
- https://omnichannels.ai/it/answers/what-is-sender-id/
- https://omnichannels.ai/it/answers/send-whatsapp-message-api/

Aggiornato: 2026-10-10