Skip to content

Seol Teachtaireacht

Seol teachtaireachtaí trí SMSBAT API ag baint úsáide as an gcríochphointe /bat/messagelist.

Críochphointe

_CÓD_BLOCK_0__

Struchtúr Iarratas

Is éard atá i gcorp an iarratais ná sraith réad teachtaireachta JSON:

_CÓD_BLOCK_1__

Paraiméadair

Paraiméadair Riachtanach

Paraiméadar Cineál Cur Síos
ó teaghrán Aitheantas an tseoltóra alfa-uimhriúil
chuig teaghrán Uimhir theileafóin an fhaighteora i bhformáid E.164 (m.sh., +380XXXXXXXXX)
cineál teaghrán Cineál na teachtaireachta: sms, viber_promo, viber_trans, viber_carousel, viber_survey, viber_otp, rcs, flashcall
téacs teaghrán Ábhar na teachtaireachta (riachtanach don chuid is mó de na cineálacha, roghnach do roinnt)

Paraiméadair Roghnacha

Paraiméadar Cineál Cur Síos
custaiméirMessageId teaghrán D'aitheantóir inmheánach le haghaidh rianaithe
ttl slánuimhir Am le maireachtáil i soicindí
messageData réad Cumraíocht chineál-shonrach (athraíonn de réir cineáil na teachtaireachta)

Fíordheimhniú

Roghnaigh ceann amháin de thrí mhodh fíordheimhnithe:

_CÓD_BLOCK_2__

_CÓD_BLOCK_3__

_CÓD_BLOCK_4__

Freagra

Freagra Ratha

_CÓD_BLOCK_5__

Réimsí Freagartha

Réimse Cineál Cur Síos
messagelistId slánuimhir Aitheantóir uathúil don liosta teachtaireachtaí
teachtaireachtId teaghrán Aitheantóir uathúil do gach teachtaireacht
stádas teaghrán Stádas na teachtaireachta: ghlactha, diúltaithe, theip
páirteanna slánuimhir Líon na gcodanna teachtaireachta (do SMS)
custaiméirMessageId teaghrán D'aitheantóir inmheánach (má chuirtear ar fáil é)
chuig teaghrán Uimhir theileafóin an fhaighteora

Cineálacha Teachtaireachta

SMS

Teachtaireachtaí simplí téacs:

_CÓD_BLOCK_6__

Viber Promo

Teachtaireachtaí bolscaireachta le meáin shaibhre:

_CÓD_BLOCK_7__

Viber Idirbheartaíochta

Fógraí idirbhirt:

_CÓD_BLOCK_8__

Viber OTP

Fógraí pasfhocail aonuaire:

_CÓD_BLOCK_9__

Láimhseáil Earráide

Cóid Stádais HTTP

Cód Cur Síos
200 D'éirigh leis an iarratas
400 Drochiarratas - paraiméadair neamhbhailí
401 Neamhúdaraithe - theip ar fhíordheimhniú
429 An iomarca iarratas - sáraíodh teorainn an ráta
500 Earráid fhreastalaí inmheánach

Freagra Earráid

_CÓD_BLOCK_10__

Dea-Chleachtais

Formáid Uimhir Theileafóin

Úsáid formáid E.164 i gcónaí le haghaidh uimhreacha gutháin:

  • ✅ Ceart: +380XXXXXXXXX
  • ❌ Mícheart: 380XXXXXXXXX, 0XXXXXXXXX

Téacs na Teachtaireachta

  • Coinnigh SMS faoi 160 carachtar chun ilchodanna a sheachaint
  • Úsáid ionchódú UTF-8 do charachtair idirnáisiúnta
  • Déan tástáil ar charachtair speisialta roimh an mórchóir a sheoladh

TTL (Am le Beo)

  • Socraigh TTL cuí le haghaidh teachtaireachtaí ama-íogair
  • Teachtaireachtaí OTP: 300-600 soicind (5-10 nóiméad)
  • Teachtaireachtaí cur chun cinn: 3600-86400 soicind (1-24 uair an chloig)

Aitheantas Teachtaireachta an Chustaiméara

  • Úsáid aitheantóirí uathúla do gach teachtaireacht
  • Cuidíonn le rianú agus debugging
  • Úsáideach le haghaidh comhghaolú le taifid do chórais

Teorainneacha Ráta

Déan teagmháil le do bhainisteoir cuntais chun faisnéis a fháil faoi:

  • Teachtaireachtaí in aghaidh an tsoicind
  • Teachtaireachtaí in aghaidh an lae
  • Naisc chomhthráthacha

Na Chéad Chéimeanna Eile