Documentazione API Marketing SMS Gratuito

Guida all'integrazione dell'app mobile

URL base https://api.rcszilla.com/?endpoint={endpoint}

Ottieni prima la tua chiave API

Prima di inviare messaggi SMS di marketing gratuiti, crea una chiave API personale nel pannello web. Questa chiave consente al tuo sito, CRM o strumento di automazione di chiamare l'API direttamente.

Accedi al pannello web e vai su Impostazioni.
Scorri fino alla sezione Chiave API e clicca su Genera chiave.
Copia la chiave e usala nell'header Authorization: Bearer delle tue richieste.

Send a Test SMS

Paste your API key, enter a phone number and message, then queue a live SMS request.

JavaScript

API Key Endpoint Method

To Phone Channel Schedule Message

JSON Body / Query Parameters

https://api.rcszilla.com/?endpoint=queue_sms

{
  "status": "ready"
}

How to Send an SMS

Use queue_sms to add an outgoing SMS to the queue. The Android device/app sends it when it polls the API.

Endpoint	`POST https://api.rcszilla.com/?endpoint=queue_sms`
Auth	`Authorization: Bearer YOUR-API-KEY`
to	string	Recipient phone number, with country code recommended.
message	string	SMS text to send.
channel	string	Use `sms` (default). Also supports `whatsapp` and `email`. For `email`, `to` is an email address, `subject` is required, and `smtp_server_id` is optional (auto round-robin when omitted).
subject	string	Required when `channel=email`. Ignored for SMS/WhatsApp.
smtp_server_id	int	Optional. SMTP server to send the email through; omit to auto-rotate across your configured servers.
scheduled_at	string	Optional date/time in `YYYY-MM-DD HH:MM:SS` format.

cURLSend SMS

curl -X POST "https://api.rcszilla.com/?endpoint=queue_sms" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR-API-KEY" \
  -d "{\"to\":\"+40700000000\",\"message\":\"Hello from RCSZilla\",\"channel\":\"sms\"}"

JSONSuccess Response

{
  "success": true,
  "message": "Queued",
  "id": 123
}

Panoramica API

Questa è l'API REST utilizzata dall'app Android RCSZilla e dal pannello web per i flussi di lavoro di marketing SMS gratuito. Usala per mettere messaggi in coda, segnalare lo stato di consegna, inviare risposte in entrata e sincronizzare la configurazione del dispositivo.

Tutte le richieste e risposte usano JSON. Tutti gli endpoint sono serviti da https://api.rcszilla.com/ e vengono selezionati tramite il parametro ?endpoint=.

Formato richiesta

Ogni richiesta deve inviare Content-Type: application/json e un header di autorizzazione (tranne claim_device, che è pubblico).

HTTPEsempio di richiesta

POST https://api.rcszilla.com/?endpoint=queue_sms HTTP/1.1
Host: api.rcszilla.com
Content-Type: application/json
Authorization: Bearer YOUR-API-KEY

{"to": "+40700000000", "message": "Hello from RCSZilla", "channel": "sms"}

Formato risposta

Ogni risposta è un oggetto JSON. Le risposte riuscite contengono sempre "success": true. I fallimenti contengono "success": false e un campo "message".

JSONEsempio di risposta - success

{
  "success": true,
  "message": "Queued",
  "id": 123
}

JSONEsempio di risposta - error

{
  "success": false,
  "message": "id required"
}

Quick Reference

Endpoint	Metodo	Autenticazione	Descrizione
queue_sms	POST	Bearer	Queue an SMS, WhatsApp, or email message to send
claim_device	POST	-	Register a new device (public)
register_device	POST	Bearer	Update device metadata
pending_messages	GET	Bearer	Fetch outgoing message queue
mark_processing	POST	Bearer	Lock a message as in-progress
mark_sent	POST	Bearer	Report message sent
mark_delivered	POST	Bearer	Report delivery receipt
mark_failed	POST	Bearer	Report send failure
submit_reply	POST	Bearer	Submit an incoming message to inbox
queue_status	GET	Bearer	Get single message status
poll	POST	Bearer	Unified heartbeat + queue + config fetch
heartbeat	POST	Bearer	Device keep-alive (deprecated; use poll)
get_config	GET	Bearer	Fetch device configuration
log_outgoing	POST	Bearer	Log a directly-sent message
ack_commands	POST	Bearer	Acknowledge processed commands