SMS · API de SMS

API de SMS: SMS desde su software con una sola solicitud.

Envíe SMS desde su CRM, ERP, infraestructura de comercio electrónico o su propia aplicación, consulte el estado de entrega y reciba los mensajes entrantes y los avisos de baja. REST y JSON; autenticación con clave Bearer y eventos mediante webhook firmado con HMAC.

Llamamos en horario laboral. Su número se usa solo para esta conversación · KVKK
# SMS masivo personalizado 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":"Hola {ad}, su pedido está en camino.", "recipients":[{"phone":"05321234567","name":"Ayşe"}]}' # respuesta {"ok":true,"data":{"campaign_id":152,"status":"queued","recipients":1,"credits":1}} # evento de entrega (webhook, firmado con HMAC) X-Buluthat-Event: sms.delivery {"event":"delivery","data":{"campaign_id":152,"status":"delivered"}}
Qué incluye

Funciones

Envío con una sola solicitud

acción send: un solo número, una lista o textos distintos personalizados; los marcadores se rellenan con los campos del destinatario.

Informe de entrega

con status consulte el estado de cada mensaje mediante el número de envío o su propia referencia (custom_ref).

Webhook firmado

Los eventos de entrega, SMS entrante y baja llegan a su dirección firmados con X-Buluthat-Signature (HMAC-SHA256); si falla, se reintenta con espaciamiento creciente.

Consulta de crédito y encabezado

con balance el crédito de SMS / OTP restante y las fechas de vencimiento; con headers sus encabezados aprobados.

Envío programado y cancelación

con send_at, fecha futura de hasta 90 días; con cancel se anulan los mensajes no enviados y se reembolsa el crédito.

Lista negra

sincronice su propia lista de bajas con blacklist_add / blacklist_remove.

Endpoints OTP

gestione el código de verificación con otp_send, otp_verify y otp_status sin mantener una tabla aparte.

İYS y ajuste de velocidad

con is_commercial el mensaje comercial pasa por el control de İYS; con rate_per_minute limita los envíos por minuto.

Solicitud

Empiece a enviar SMS en 4 pasos

Usted carga los documentos desde el panel; nosotros damos seguimiento a la aprobación del encabezado.

01
Su solicitud

Complete el formulario y elija el paquete que desee. Cuando se abra su cuenta, la contraseña del panel llegará a su correo.

02
Cargue los documentos

Envíe desde el panel los datos de la empresa, el certificado fiscal, el documento del responsable, la circular de firmas y la carta de compromiso.

03
Aprobación del encabezado

Su encabezado SMS (3-11 caracteres) se aprueba en 1-3 días hábiles si los documentos están completos.

04
Envíe

Haga envíos masivos desde el panel con Excel o la agenda, o conéctelo con su software mediante la API de SMS.

Preguntas frecuentes

Acerca de la API de SMS

En la página API de SMS de la sección Desarrolladores; con ejemplos de solicitudes, respuestas y códigos de error.

Lo genera en el panel, en Panel > SMS masivo > API y ajustes; introduce su dirección de webhook en la misma pantalla.

Un número repetido en la misma solicitud se envía una sola vez; con la protección antiduplicados activa, el mismo texto no llega dos veces al mismo número el mismo día.