RCSZilla Versione 1.0

Invia messaggio in arrivo

Guida all'integrazione dell'app mobile

Invia messaggio in arrivo

POST /?endpoint=submit_reply

Invia un SMS in arrivo o messaggio WhatsApp ricevuto dal dispositivo nella posta in arrivo del server.

Corpo della richiesta

CampoTipoDescrizione
from_phonestring obbligatorio Numero di telefono del mittente (cifre e + consentiti).
messagestring obbligatorio Testo del messaggio.
channelstring opzionale sms o whatsapp. Predefinito sms.

Esempio di richiesta

cURL
curl -X POST "https://api.rcszilla.com/?endpoint=submit_reply" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR-DEVICE-TOKEN" \
  -d '{
    "from_phone": "+40712345678",
    "channel": "sms",
    "message": "YES please send me more info"
  }'

Risposta

{
  "success": true,
  "message": "Reply received",
  "id": 209,
  "reply": null,
  "reply_queue_id": null
}
{
  "success": true,
  "message": "Reply received",
  "id": 209,
  "reply": "Thanks for your message! We will get back to you shortly.",
  "reply_queue_id": 315
}
*
Se reply non รจ null nella risposta, l'app deve inviare quel testo a from_phone sullo stesso canale e poi chiamare mark_sent con reply_queue_id.

Auto-reply Flow

  1. App receives inbound SMS/WhatsApp.
  2. App calls submit_reply.
  3. Server matches message against auto-reply rules.
  4. If matched โ†?server queues the reply and returns "reply" text inline.
  5. App sends the reply text directly to the sender (no second poll needed).
  6. App calls mark_sent with reply_queue_id to confirm delivery.