Enviar Mensagem Recebida

Guia de Integração do Aplicativo Móvel

Enviar Mensagem Recebida

POST /?endpoint=submit_reply

Envia para a caixa de entrada do servidor um SMS ou mensagem de WhatsApp recebida pelo dispositivo. Se uma regra de resposta automática corresponder, o servidor enfileira uma resposta e retorna o texto da resposta imediatamente, para que o app possa enviá-la sem uma segunda consulta.

Corpo da Requisição

Campo	Tipo		Descrição
from_phone	string	obrigatório	Número de telefone do remetente (dígitos e + permitidos).
message	string	obrigatório	Texto do corpo da mensagem.
channel	string	opcional	`sms` ou `whatsapp`. O padrão é `sms`.

Exemplo de Requisição

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"
  }'

Resposta

{
  "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 não for nulo na resposta, o app deve enviar esse texto de volta para from_phone no mesmo canal e, em seguida, chamar mark_sent com reply_queue_id.

Auto-reply Flow

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