SMS · API SMS

API SMS: SMS dal Suo software con una sola richiesta.

Inviate SMS dal Suo CRM, ERP, infrastruttura e-commerce o dalla Sua applicazione, interrogate lo stato di consegna, ricevete i messaggi in entrata e le notifiche di rifiuto. REST e JSON; autenticazione con chiave Bearer, eventi tramite webhook firmati HMAC.

Chiamiamo in orario di lavoro. Il Suo numero viene usato solo per questa conversazione · KVKK
# SMS di massa personalizzato curl -X POST https://api.buluthat.com/api/sms.php?action=send \ -H "Authorization: Bearer bt_xxx" -H "Content-Type: application/json" \ -d '{"header":"FIRMAADI","message":"Merhaba {ad}, siparişiniz kargoda.", "recipients":[{"phone":"05321234567","name":"Ayşe"}]}' # risposta {"ok":true,"data":{"campaign_id":152,"status":"queued","recipients":1,"credits":1}} # evento di consegna (webhook, firmato HMAC) X-Buluthat-Event: sms.delivery {"event":"delivery","data":{"campaign_id":152,"status":"delivered"}}
Cosa c'è

Funzioni

Invio con una sola richiesta

azione send: un solo numero, una lista o testi diversi personalizzati; i segnaposto si compilano con i campi del destinatario.

Report di consegna

con status interroghi lo stato di ogni messaggio tramite il numero di invio o il Suo riferimento (custom_ref).

Webhook firmato

Gli eventi di consegna, SMS in entrata e rifiuto vengono firmati con X-Buluthat-Signature (HMAC-SHA256) e inviati al Suo indirizzo; in caso di errore si riprova con intervalli crescenti.

Interrogazione di credito e intestazione

con balance il credito SMS / OTP residuo e le date di scadenza, con headers le Sue intestazioni approvate.

Invio programmato e annullamento

con send_at data futura fino a 90 giorni; con cancel i messaggi non ancora inviati vengono annullati, il credito rimborsato.

Lista nera

con blacklist_add / blacklist_remove sincronizzi la Sua lista dei rifiuti.

Endpoint OTP

gestite il codice di verifica con otp_send, otp_verify e otp_status senza mantenere una tabella separata.

İYS e impostazioni di velocità

con is_commercial il messaggio commerciale passa dal controllo İYS; con rate_per_minute limitate l'invio al minuto.

Richiesta

Iniziate a inviare SMS in 4 passaggi

Caricate i documenti dal pannello; dell'approvazione dell'intestazione ci occupiamo noi.

01
La Sua richiesta

Compili il modulo e scelga il pacchetto desiderato. Quando l'account è aperto, la password del pannello arriva alla Sua e-mail.

02
Caricate i documenti

Trasmettete dal pannello i dati dell'azienda, la visura fiscale, il documento del referente, lo specimen di firma e la dichiarazione di impegno.

03
Approvazione dell'intestazione

La Sua intestazione SMS (3-11 caratteri) viene approvata entro 1-3 giorni lavorativi se i documenti sono completi.

04
Inviate

Dal pannello inviate in blocco da Excel o dalla rubrica oppure collegate al Vostro software con l'API SMS.

FAQ

Informazioni sull'API SMS

Nella pagina API SMS della sezione Sviluppatori; con richiesta, risposta e codici di errore di esempio.

Lo crea nel pannello dalla schermata SMS di massa > API e Impostazioni; l'indirizzo del webhook si inserisce nella stessa schermata.

Il numero ripetuto nella stessa richiesta viene inviato una sola volta; se la protezione dai duplicati è attiva, lo stesso testo non viene inviato due volte allo stesso numero nello stesso giorno.