Help Center Seol Teachtaireacht

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éadarCineálCur Síos
óteaghránAitheantas an tseoltóra alfa-uimhriúil
chuigteaghránUimhir theileafóin an fhaighteora i bhformáid E.164 (m.sh., +380XXXXXXXXX)
cineálteaghránCineál na teachtaireachta: sms, viber_promo, viber_trans, viber_carousel, viber_survey, viber_otp, rcs, flashcall
téacsteaghránÁbhar na teachtaireachta (riachtanach don chuid is mó de na cineálacha, roghnach do roinnt)

Paraiméadair Roghnacha

ParaiméadarCineálCur Síos
custaiméirMessageIdteaghránD’aitheantóir inmheánach le haghaidh rianaithe
ttlslánuimhirAm le maireachtáil i soicindí
messageDataréadCumraíocht chineál-shonrach (athraíonn de réir cineáil na teachtaireachta)

Fíordheimhniú

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

=== “Ceanntásc Eochrach API”

_CÓD_BLOCK_2__

=== “Údar Bunúsach HTTP”

_CÓD_BLOCK_3__

=== “Eochair API mar Phasfhocal”

_CÓD_BLOCK_4__

Freagra

Freagra Ratha

CÓD_BLOCK_5_

Réimsí Freagartha

RéimseCineálCur Síos
messagelistIdslánuimhirAitheantóir uathúil don liosta teachtaireachtaí
teachtaireachtIdteaghránAitheantóir uathúil do gach teachtaireacht
stádasteaghránStádas na teachtaireachta: ghlactha, diúltaithe, theip
páirteannaslánuimhirLíon na gcodanna teachtaireachta (do SMS)
custaiméirMessageIdteaghránD’aitheantóir inmheánach (má chuirtear ar fáil é)
chuigteaghránUimhir 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ódCur Síos
200D’éirigh leis an iarratas
400Drochiarratas - paraiméadair neamhbhailí
401Neamhúdaraithe - theip ar fhíordheimhniú
429An iomarca iarratas - sáraíodh teorainn an ráta
500Earrá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