Skip to content

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