Seol Teachtaireachtaí Cascáidigh
Seol teachtaireachtaí thar cainéil iolracha le hiarratas API amháin. Déanann Cascáid do theachtaireacht a sheoladh go huathoibríoch trí Telegram Bot, Viber Bot, Teachtaireachtaí Gnó Viber, RCS, agus SMS.
Críochphointí
Cascáid Chaighdeánach
_CÓD_BLOCK_0__
Seoltar teachtaireachtaí trí gach cainéal atá ar fáil in ord.
Tosaíocht Telegram-Viber
_CÓD_BLOCK_1__
Tugann sé tosaíocht do chainéil Telegram agus Viber le seachadadh níos tapúla.
Fíordheimhniú
Tacaíonn Cascade API le trí cheanntásc fíordheimhnithe. Cuir ceann amháin ar a laghad san áireamh:
| Ceanntásc | Cur Síos |
|---|---|
X-Údarú-Eochair |
Eochair API SMSBAT (molta) |
X-Viber-Auth-Token |
Dintiúir bot Viber |
X-Tg-Bot-Key |
Eochair bot teileagram |
Struchtúr Iarratas
Ceanntásca
_CÓD_BLOCK_2__
Comhlacht Iarratas
Seol raon rudaí teachtaireachta:
_CÓD_BLOCK_3__
Paraiméadair
| Paraiméadar | Cineál | Ag Teastáil | Cur Síos |
|---|---|---|---|
id |
teaghrán | Tá | D'aitheantóir rianaithe |
ó Ainm |
teaghrán | Tá | Ainm taispeána an tseoltóra |
go Fón |
teaghrán | Tá | Uimhir theileafóin an fhaighteora (formáid E.164) |
teachtaireacht Cineál |
teaghrán | Tá | Cineál na teachtaireachta: idirbheart, promo, viber_survey, flashcall |
téacs |
teaghrán | Tá* | Ábhar na teachtaireachta (* riachtanach don chuid is mó de na cineálacha) |
ttl |
slánuimhir | Níl | Am le maireachtáil i soicindí |
sceidealaithe |
teaghrán | Níl | Am dáta ISO 8601 maidir le seachadadh sceidealta |
Cineálacha Teachtaireachta
Teachtaireachtaí Idirbheart
Fógraí ríthábhachtacha amhail deimhnithe ordaithe agus nuashonruithe cuntais:
_CÓD_BLOCK_4__
Teachtaireachtaí Promóisin
Feachtais mhargaíochta le meáin shaibhre:
_CÓD_BLOCK_5__
Suirbhé Viber
Pobalbhreith idirghníomhach le 2-5 rogha freagartha:
_CÓD_BLOCK_6__
Uasmhéid téacs an tsuirbhé: 85 carachtar
Glaoch Flash
Fíorú gutháin trí ghlao uathoibrithe:
_CÓD_BLOCK_7__
Samplaí
Bunbheart
_CÓD_BLOCK_8__
Promo Sceidealta
_CÓD_BLOCK_9__
Mórtheachtaireachtaí
_CÓD_BLOCK_10__
Freagra
Freagra Ratha
_CÓD_BLOCK_11__
Réimsí Freagartha
| Réimse | Cineál | Cur Síos |
|---|---|---|
teachtaireachtId |
teaghrán (UUID) | Aitheantóir teachtaireacht an chórais |
trackinId |
teaghrán | D'aitheantóir rianaithe (ó iarratas) |
Úsáid messageId le haghaidh rianú stádais agus trackinId chun comhghaolú le do chóras.
Samplaí Forfheidhmithe
Python
_CÓD_BLOCK_12__
JavaScript (Node.js)
_CÓD_BLOCK_13__
PHP
_CÓD_BLOCK_14__
Dea-Chleachtais
Uimhreacha Teileafóin
Úsáid formáid E.164 i gcónaí:
- ✅ +380XXXXXXXXX
- ❌ 380XXXXXXXXX
- ❌ 0XXXXXXXXX
Aitheantais Rianaithe
- Úsáid aitheantais uathúla do gach teachtaireacht
- Cuir comhthéacs san ID (m.sh.,
ordú-12345,promo-summer-2025) - Coinnigh IDanna faoi 255 carachtar
- Seachain carachtair speisialta
TTL (Am le Beo)
Luachanna TTL molta:
- OTP/Fíorú: 300-600 soicind (5-10 nóiméad)
- Idirbheartach: 3600-86400 soicind (1-24 uair an chloig)
- Chun Chun Cinn: 86400-259200 soicind (1-3 lá)
- Suirbhéanna: 604800 soicind (7 lá)
Teachtaireachtaí Sceidealta
- Úsáid crios ama UTC le haghaidh
scheduledSent - Ná sceideal níos mó ná 30 lá roimh ré
- Tabhair cuntas ar dhifríochtaí crios ama
- Déan tástáil le sceidil atá gar don todhchaí ar dtús
Mórsheoladh
- Seol i mbaisceanna de 100-1000 teachtaireacht
- Teorainn rátaí a chur i bhfeidhm
- Earráidí a láimhseáil go galánta
- Bain triail eile as teachtaireachtaí teipthe
Láimhseáil Earráide
Cóid Stádais HTTP
| Cód | Cur Síos |
|---|---|
| 200 | Rath |
| 400 | Drochiarratas - paraiméadair neamhbhailí |
| 401 | Neamhúdaraithe - eochair API neamhbhailí |
| 429 | An iomarca iarratas |
| 500 | Earráid fhreastalaí |
Freagra Earráid
_CÓD_BLOCK_15__
Bain triail eile as an loighic
_CÓD_BLOCK_16__
Na Chéad Chéimeanna Eile
- Athróga Teachtaireachta - Úsáid ábhar dinimiciúil
- Cineálacha Teachtaireachtaí - Déan iniúchadh ar na cineálacha teachtaireachta
- Stádas Seachadta - Rianaigh seachadadh