saapuvat viestit (takaisinsoitto)
Kun käyttäjät lähettävät saapuvan viestin Viber-bottiisi tai muihin määritettyihin kanaviin, SMSBAT välittää nämä viestit palvelimellesi Webhookin (takaisinsoitto) kautta.
Webhook-muoto
Takaisinsoitto lähetetään määritettyyn Webhook-URL-osoitteeseen HTTP POST -pyynnön kautta JSON-hyötykuormalla.
Pyyntötekstiesimerkki
{
"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"
}
Parametrit
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| ”idUuid” | merkkijono | Saapuvan viestin yksilöllinen tunniste |
| ”alphaName” | merkkijono | Viestin vastaanottaneen brändin/botin nimi |
| ”puhelinnumero” | merkkijono | Lähettäjän puhelinnumero |
| ”teksti” | merkkijono | Saapuvan viestin tekstisisältö |
| ”dt” | päivämääräaika | Aikaleima, jolloin viesti vastaanotettiin |
Kokoonpano
Aloita saapuvien viestien vastaanottaminen:
- Anna Webhook-URL-osoitteesi (HTTPS vaaditaan) SMSBAT-tilivastaavallesi tai määritä se hallintapaneelissa.
- Päätepisteesi on hyväksyttävä POST-pyynnöt, joissa on “Content-Type: application/json”.
- Palvelimesi pitäisi vastata “200 OK”, kun se on vastaanottanut hyötykuorman.
Huomaa: Jos palvelimesi ei vastaa “200 OK” tai aikakatkaisu, SMSBAT voi yrittää lähettää uudelleen tilisi asetusten perusteella.