SMS · SMS API

SMS API: SMS vanuit uw software met één verzoek.

Verstuur SMS vanuit uw CRM, ERP, e-commerce-infrastructuur of eigen applicatie, vraag de bezorgstatus op, ontvang inkomende berichten en afmeldingen. REST en JSON; authenticatie met een Bearer-sleutel, gebeurtenissen via webhook met HMAC-handtekening.

Wij bellen tijdens kantooruren. Uw nummer wordt alleen voor dit gesprek gebruikt · KVKK
# gepersonaliseerde bulk-SMS curl -X POST https://api.buluthat.com/api/sms.php?action=send \ -H "Authorization: Bearer bt_xxx" -H "Content-Type: application/json" \ -d '{"header":"FIRMAADI","message":"Merhaba {ad}, siparişiniz kargoda.", "recipients":[{"phone":"05321234567","name":"Ayşe"}]}' # antwoord {"ok":true,"data":{"campaign_id":152,"status":"queued","recipients":1,"credits":1}} # bezorgingsgebeurtenis (webhook, met HMAC-handtekening) X-Buluthat-Event: sms.delivery {"event":"delivery","data":{"campaign_id":152,"status":"delivered"}}
Wat er is

Functies

Verzenden met één verzoek

de actie send: één nummer, een lijst of gepersonaliseerde verschillende teksten; plaatshouders worden gevuld uit de velden van de ontvanger.

Bezorgrapport

vraag met status de status van elk bericht op via het verzendnummer of uw eigen referentie (custom_ref).

Ondertekende webhook

Bezorging, inkomende SMS en afmeldgebeurtenissen worden met X-Buluthat-Signature (HMAC-SHA256) ondertekend en naar uw adres gestuurd; bij een fout wordt met uitstel opnieuw geprobeerd.

Opvraag van tegoed en afzendernaam

met balance het resterende SMS-/OTP-tegoed en de vervaldatums, met headers uw goedgekeurde afzendernamen.

Geplande verzending en annulering

met send_at tot 90 dagen vooruit plannen; met cancel worden niet-verzonden berichten geannuleerd en wordt het tegoed gecrediteerd.

Zwarte lijst

synchroniseer uw eigen afmeldlijst met blacklist_add / blacklist_remove.

OTP-endpoints

beheer de verificatiecode met otp_send, otp_verify en otp_status zonder aparte tabel.

İYS en snelheidsinstelling

met is_commercial gaat een commercieel bericht door de İYS-controle; met rate_per_minute beperkt u het aantal verzendingen per minuut.

Aanvraag

Begin in 4 stappen met SMS versturen

U uploadt uw documenten in het paneel; wij volgen de goedkeuring van de afzendernaam.

01
Uw aanvraag

Vul het formulier in en kies het gewenste pakket. Zodra uw account is geopend, komt uw paneelwachtwoord in uw e-mail.

02
Upload de documenten

Stuur bedrijfsgegevens, belastingdocument, identiteit van de bevoegde, handtekeningenregister en verklaring via het paneel.

03
Goedkeuring afzendernaam

Uw SMS-afzendernaam (3-11 tekens) wordt bij compleet documenten binnen 1-3 werkdagen goedgekeurd.

04
Verzend

Verstuur vanuit het paneel in bulk via Excel of adresboek, of koppel uw software via de SMS API.

FAQ

Over de SMS API

Op de pagina SMS API in het onderdeel Ontwikkelaars; met voorbeeldverzoek, antwoord en foutcodes.

U maakt hem aan in het paneel via Bulk-SMS > API en instellingen; ook uw webhook-adres voert u op hetzelfde scherm in.

Een in hetzelfde verzoek herhaald nummer wordt eenmaal verstuurd; staat de dubbelingsbeveiliging aan, dan gaat dezelfde tekst niet twee keer op dezelfde dag naar hetzelfde nummer.