BlazeSphere Technology · API v1

WhatsLite

API independiente de WhatsApp para enviar y recibir mensajes, administrar plantillas y conectar webhooks. Meta Gateway custodia los tokens; WhatsLite nunca los entrega al cliente.

Contratar por USD 15/mes Descargar OpenAPI Estado del servicio

URL base oficial

https://whatslite.blaze.do/v1

Autenticación: Authorization: Bearer bwl_live_<kid>.<secret>. La llave se crea una sola vez desde el detalle de la suscripción en Blaze Portal.

Primeros pasos

1. Contrata WhatsLite. 2. Conecta el número por Meta Gateway. 3. Crea una API key. 4. Configura tu webhook. 5. Envía el primer mensaje.

curl -X POST https://whatslite.blaze.do/v1/messages \
  -H 'Authorization: Bearer bwl_live_…' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: pedido-123' \
  -d '{"channel_id":"chb_…","to":"+1809…","type":"text","text":{"body":"Hola"}}'

Mensajes y canales

GET/v1/channels

POST/v1/messages

GET/v1/messages

GET/v1/messages/{message_id}

Plantillas y multimedia

GET/v1/templates

POST/v1/templates

POST/v1/media

GET/v1/usage

Lo que administras en ERP

Compra y facturación, activación, conexión de Meta, API keys con scopes, webhooks firmados, límites, consumo y actividad por cliente.

Plantillas: PENDING → APPROVED → enviar

POST /v1/templates devuelve 202 Accepted y el objeto de Meta, normalmente PENDING. Consulta GET /v1/templates; solo APPROVED se puede enviar.

POST https://whatslite.blaze.do/v1/templates
{"name":"aviso_pago","language":"es","category":"UTILITY","components":[{"type":"BODY","text":"Hola {{1}}. Balance: {{2}}.","example":{"body_text":[["Ana","RD$ 1,200.00"]]}}]}

POST https://whatslite.blaze.do/v1/messages
{"channel_id":"chb_…","to":"+1809…","type":"template","template":{"name":"aviso_pago","language":"es","body_parameters":["Ana","RD$ 1,200.00"]}}

Si crear responde con timeout, lista antes de repetir: Meta puede haber aceptado el primer POST. No se promete exactly-once de creación entre réplicas.

MikroWISP

Configura los cinco aliases que muestra Blaze Portal y copia esta URL. La key de query solo sirve para este proveedor.

GET https://whatslite.blaze.do/v1/native-integrations/mikrowisp/messages?phone={destinatario}&mensaje={mensaje}&api_key=<TU_API_KEY>

No registres la URL completa: la key puede quedar en historial o logs del proveedor. Rótala si se expone.

WispHub Genérico v2

En Ajustes > SMS > WhatsApp Genérico > Versión 2 configura POST, headers y Data JSON:

POST https://whatslite.blaze.do/v1/native-integrations/wisphub/messages
Authorization: Bearer <TU_API_KEY>
Content-Type: application/json

{"to":"{destinatario}","message":"{mensaje}"}

Usa recipient_format=e164. Deja Código de País activo para el país principal: el destino llega con prefijo sin +. Para extranjeros, desactívalo y guarda prefijo sin + ni ceros. Sube Límite de caracteres a ≥1024 y por encima del formato más largo; 160 puede truncarlo. El query api_key se rechaza siempre.

DomISP: enviar eventos JSON

WhatsLite procesa la plantilla y mantiene el estado del mensaje. Usa una clave nativa DomISP y una Idempotency-Key estable por evento; el canal se obtiene de tu suscripción.

POST https://whatslite.blaze.do/v1/native-integrations/domisp/messages
Authorization: Bearer <TU_API_KEY_DOMISP>
Content-Type: application/json
Idempotency-Key: domisp:factura:FAC-123:emitida:v1

{"to":"18095550123","alias":"FACTURA_GENERADA","parameters":["Ana Perez","NIC-12345","FAC-123","RD$ 1,200.00","10/10/2026"],"client_reference":"domisp:factura:FAC-123"}

Guarda el message_id del HTTP 202 y confirma entrega con webhooks. Consulta el manual DomISP → WhatsLite (.md) para configuración, catálogo, PHP y callbacks.

Presets manuales WispHub

Genérico v2 confirma el transporte HTTP, no el enlace automático de estos eventos. Confirma en tu instalación la plantilla/mensaje donde se pega cada formato y haz un smoke real.

BIENVENIDA|{{nombre_cliente}}|{{empresa}}|{{telefono_empresa}}

RECORDATORIO_PAGO|{{cliente_nombre}}|{{fecha_corte}}|{{total}}|{{ver_factura}}

CONFIRMACION_PAGO|{{cliente_nombre}}|{{factura.id_factura}}|{{empresa}}

AVISO_CORTE_O_SUSPENSION|{{cliente_nombre}}|{{url_autologin}}|{{empresa}}

Cada preset muestra alias, nombre legible y meta_template_name real versionado. PENDING, REJECTED y drift se bloquean.

Usa siempre Idempotency-Key. DomISP la exige. Sin ella, las rutas MikroWISP/WispHub deduplican la solicitud canónica durante cinco minutos; no es una garantía indefinida. Nunca coloques una service key del ERP o Meta Gateway en una aplicación cliente.