Introducción
SMS complementa WhatsApp en mercados con menor penetración de WhatsApp o alertas urgentes. La API SMS de Buzzbip acepta números directos o referencias de contacto. Respete límites de tasa y regulaciones locales de opt-in.
Pasos
Siga estos pasos para completar la integración.
- Obtén JWT de POST /api/login_check.
- Opcional: crea contacto con POST /api/contacts/.
- Envía SMS con POST /api/sms/ incluyendo number y message.
- Revisa estado de entrega en historial GET /api/sms/.
Detalles
Envía SMS transaccionales vía POST /api/sms/ con JWT. Incluye número completo con código de país y mensaje conciso conforme a reglas del operador.
curl -X POST 'https://app.buzzbip.com/api/sms/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"number": "21690123456", "message": "Your order shipped!"}'Pruebe en staging antes de envíos en producción.
Notas de integración
Al integrar este endpoint de Buzzbip, use https://app.buzzbip.com como host de producción. Obtenga JWT de POST /api/login_check y envíe Authorization: Bearer en cada solicitud. Confirme que User.hasApiAccess está habilitado en el admin de Buzzbip. Analice respuestas JSend (status, message, data). Para plugins e-commerce, envíe también x-api-key, x-platform-type y x-base-uri. Respete las barras finales en POST /api/contacts/ y POST /api/whatsapp/. Implemente reintentos con backoff ante límites de tasa. Guarde credenciales en el servidor y reautentíquese antes del vencimiento JWT (3600 s).
Seguridad
Buenas prácticas: credenciales solo en servidor, TLS obligatorio, monitorear fallos de autenticación. Separe cuentas staging y producción. Documente plantillas y automatizaciones. Redacte números y contenido en registros compartidos.
¿Qué sigue?
Siga aprendiendo: api/sms api/contacts getting-started/rate-limits