Tunisia (+216) SMS Verification: Checklist para sa mga Developer

Ano ang dapat nasa pre-flight checklist bago mag-order ng +216 number?

Daanan nang minsan ang listahang ito at magiging maayos ang karamihan ng Tunisia test run:

• Handa na ang API key. Gumawa ng Bearer key sa Developer console; nagsisimula sa or_live_ ang mga live key.
• May pondo ang wallet. Kumukuha ang OTP Gateway mula sa prepaid mong USD balance; kinukumpirma ito ng GET /api/v1/balance mula sa script.
• Maaabot ang webhook. Mag-register ng HTTPS endpoint, itago ang secret nito, at tiyaking tama ang orasan ng server mo para pumasa ang mga timestamp check.
• Nasuri na ang presyo. Tawagin ang GET /api/v1/prices?country=tn&service=<id> para sa eksaktong serbisyong planong i-test.
• Nasubukan na ang phone field. Tiyaking tumatanggap ang sarili mong form ng walong-digit na Tunisian na national number at ng idinikit na international na +216.
• Mapagparaya ang parser. Kumpirmahing gumagana ang code extraction para sa mga mensaheng Arabic, French at English (tingnan sa ibaba).
• Nasuri na ang mga tuntunin. Sinusubukan mo ang sarili mong produkto o ino-operate ang sarili mong lehitimong account, alinsunod sa mga patakaran ng serbisyo at sa Acceptable Use Policy ng OTP Route.

Paano ipino-format ang mga Tunisian number para sa E.164?

Gumagamit ang Tunisia ng closed numbering plan: walong digit ang bawat subscriber number at walang trunk prefix, kaya walang kailangang alisin bago idagdag ang country code. Ang E.164 form ay simpleng +216 na sinusundan ng walong digit na iyon. Madalas isulat ng mga lokal ang mga number sa mga grupo gaya ng xx xxx xxx, kaya alisin ang mga espasyo, tuldok at gitling kapag nino-normalize. Iwasang mag-validate laban sa nakapirming listahan ng mga unang digit; mas ligtas ang length check kasama ang kagalang-galang na phone library kaysa sa sariling sulat na talahanayan ng mga range.

Anong mga wika ang gamit ng mga Tunisian verification text?

Arabic ang opisyal na wika, Tunisian Arabic ang sinasalita sa araw-araw, at karaniwan ang French sa negosyo, administrasyon at maraming app. Dahil dito, maaaring makakita ang isang test run ng mga code sa French, English o Arabic depende sa sender at locale ng device.

Ang mga mensaheng Arabic ay naglalakbay bilang Unicode SMS at maaaring may mga right-to-left direction mark sa paligid ng mga digit. Nakakaligtas sa lahat ng tatlong wika ang regex na kumukuha ng unang pagkakasunod-sunod ng apat hanggang walong ASCII digit, pagkatapos tanggalin ang mga hindi nakikitang mark. Karaniwang idinaragdag ng mga team ang Tunisia sa matrix nila para sa mga francophone North African launch kasama ng Morocco at Algeria, para sa localisation QA ng mga right-to-left na layout, o dahil naglilingkod sila sa mga Tunisian na customer na nakatira sa Europe; sakop ng +216 number para sa testing ang bawat isa sa mga kasong iyon.

Hakbang-hakbang: pagtanggap ng Tunisia OTP sa pamamagitan ng API

Mahigit 1,700 serbisyo ang nakalista sa live snapshot para sa Tunisia, kabilang ang Facebook, WhatsApp, Instagram, Telegram, TikTok, Google (Gmail & YouTube), Snapchat, Signal, LinkedIn, Discord, ChatGPT (OpenAI), Microsoft & Outlook, Amazon at Uber. Nagbabago ang availability sa loob ng araw, kaya hayaang basahin ng OTP routing logic mo ito mula sa GET /api/v1/services at GET /api/v1/countries sa simula ng run.

1. Ipadala ang POST /api/v1/activations na may {"service": "facebook", "country": "tn"} at i-save ang activation id.
2. I-type ang ibinalik na number sa app na sinusubukan at i-trigger ang code.
3. Asikasuhin ang activation.sms_received sa webhook mo: i-verify ang X-OTPRoute-Signature (HMAC-SHA256 ng timestamp, tuldok at raw body), tanggihan ang mga lumang timestamp, at huwag pansinin ang mga duplicate para sa activation id na naproseso mo na.
4. Kung walang webhook, i-poll ang GET /api/v1/activations/{id}, na mananatiling malayo sa limitasyong 300 request kada minuto.
5. Tawagin ang POST /api/v1/activations/{id}/cancel kung naputol ang test.

Inililista ng API docs ang bawat field, at ipinapakita ng CI testing guide kung paano ito ikakabit sa pipeline.

Hakbang-hakbang mula sa dashboard

1. Gumawa ng account gamit ang email at anim-na-digit na code, o gamit ang Google sign-in, at i-on ang TOTP two-factor.
2. Magdagdag ng pondo gamit ang card o USDT/USDC.
3. Piliin ang Tunisia, saka ang serbisyo, at tingnan ang ipinapakitang presyo.
4. Mag-order, kopyahin ang +216 number, at humiling ng code sa target na app.
5. Kopyahin ang Tunisian na code mula sa dashboard sa sandaling lumabas ito at tapusin ang sign-up na sinusubukan mo.

Pag-troubleshoot: paano kung hindi lumabas ang +216 code?

Tumatakbo nang 20 minuto ang bawat activation, at magbabayad ka lang kapag dumating ang code. Kung lumipas ang window o nag-cancel ka, babalik sa wallet ang buong halaga.

• Walang dumating kahit ano: hayaang maubos ang window, saka subukan ulit mamaya o sa ibang service route kung pinapayagan ng test.
• Tinanggihan ng serbisyo ang number: may mga serbisyong tumatanggi sa mga virtual number; sakop ng refund ang kasong iyon.
• Tahimik ang webhook pero ipinapakita ng dashboard ang code: malamang pumapalya ang signature check mo; ihambing sa raw body, hindi sa muling na-serialise na JSON, at suriin ang clock drift.
• Sunud-sunod na kabiguan: magdagdag ng back-off; bihirang makatulong ang muling pag-order sa masikip na loop.

Mga long-term line, billing at sandbox para sa Tunisia

Walang self-serve na long-term na Tunisian number. Produkto para sa US at Canada ang Dedicated Numbers mula $1.95/buwan; kung kailangan mo ng pangmatagalang +216 line, mag-email sa [email protected], at tandaang nakadepende sa mga lokal na patakaran ang availability.

Pay as you go ang wallet na walang monthly fee, at may PDF invoice sa email ang bawat top-up. Maaaring humiling ng sandbox mode ang mga development account, kung saan ang simulated na mga number at code ay nagbibigay-daan para patunayan ang integration nang hindi gumagastos ng balance.

Mga madalas itanong

Puwede ko bang i-test ang Tunisian sign-up flow nang walang Tunisian SIM?

Oo. Gumamit ng +216 number mula sa OTP Gateway at kunin ang code sa dashboard o sa pamamagitan ng SMS verification API at mga webhook.

May trunk prefix bang aalisin sa mga Tunisian number?

Wala. Walong digit ang mga Tunisian number na walang trunk prefix, kaya ang E.164 form ay +216 at ang mga digit na iyon lang.

Ano ang country id ng Tunisia OTP API?

Gamitin ang tn sa prices query at sa request body ng POST /api/v1/activations.

Magkano ang Tunisia verification number?

Mula $0.20 kada code; nakadepende sa serbisyo ang eksaktong halaga at lumalabas ito sa dashboard at sa prices endpoint bago ka mag-order. Tingnan ang pricing.

Pumapalya ang parser ko sa mga Arabic na OTP message. Ano ang dapat kong baguhin?

Alisin ang mga Unicode direction mark at itugma ang pagkakasunod-sunod ng mga digit sa halip na ang mga nakapaligid na salita, para gumana ang parehong patakaran sa mga katawang Arabic, French at English.

Puwede ba akong magtago ng +216 number para sa mga susunod na login?

Hindi sa pamamagitan ng self-serve. Isang code ang sakop ng gateway number, at sa US at Canada lang umiiral ang mga long-term line na agad na available.

Ang mga pangalan ng serbisyo ay trademark ng kani-kanilang may-ari. Walang kaugnayan ang OTP Route sa kanila. Gamitin nang legal ang mga number at sundin ang mga tuntunin ng bawat serbisyo at ang aming Acceptable Use Policy.