Mga Papasok na Mensahe (Mga Callback)
Kapag nagpadala ang mga user ng papasok na mensahe sa iyong Viber bot o iba pang naka-configure na channel, ipinapasa ng SMSBAT ang mga mensaheng ito sa iyong server sa pamamagitan ng Webhook (Callback).
Format ng Webhook
Ang mga callback ay ipinapadala sa iyong na-configure na Webhook URL sa pamamagitan ng HTTP POST na kahilingan na may JSON payload.
Halimbawa ng Katawan ng Kahilingan
{
"idUuid": "123e4567-e89b-12d3-a456-426614174000",
"alphaName": "ViberBotName",
"phoneNumber": "380936670003",
"text": "Hello, I need help with my order",
"dt": "2025-01-20T14:30:00.000Z"
}
Mga Parameter
| Patlang | Uri | Paglalarawan |
|---|---|---|
idUuid |
string | Natatanging identifier para sa papasok na mensahe |
alphaName |
string | Ang pangalan ng iyong brand/bot na nakatanggap ng mensahe |
phoneNumber |
string | Ang numero ng telepono ng nagpadala |
teksto |
string | Ang nilalaman ng teksto ng papasok na mensahe |
dt |
oras ng petsa | Timestamp kung kailan natanggap ang mensahe |
Configuration
Upang simulan ang pagtanggap ng Mga Papasok na Mensahe:
1. Ibigay ang iyong Webhook URL (kinakailangan ng HTTPS) sa iyong SMSBAT Account Manager o i-configure ito sa Dashboard.
2. Dapat tanggapin ng iyong endpoint ang mga kahilingan sa POST na may Content-Type: application/json.
3. Dapat tumugon ang iyong server ng 200 OK kapag matagumpay na natanggap ang payload.
Tandaan: Kung hindi tumugon ang iyong server ng
200 OKo nag-time out, maaaring subukan ng SMSBAT na muling subukan ang paghahatid batay sa configuration ng iyong account.