Un servicio de notificaciones necesita tanto una forma de enviar textos como una ruta hacia los teléfonos de los destinatarios. Elegir una interfaz resuelve solo la primera parte de ese problema.
¿Qué hace cada parte?
Una API acepta solicitudes programáticas. Un gateway conecta tu aplicación con redes móviles.
Tu aplicación envía un destinatario, un remitente y un mensaje a través de la interfaz. El gateway pasa los mensajes hacia los servicios de red que los entregan. Un proveedor puede ofrecer ambas partes en un solo servicio.
La referencia de gateways SMPP describe gateways que conectan aplicaciones con centros de mensajes móviles. También describe gateways que ofrecen varias interfaces, incluidas HTTP y SMPP.
La interfaz no determina todas las capacidades de entrega. Un formato de solicitud conveniente no puede hacer válido un remitente no admitido en un destino.
¿Qué interfaz debo elegir?
Elige HTTP para una aplicación nueva, a menos que una integración SMPP existente o un requisito de conexión específico justifique gestionar SMPP.
Con HTTP, tu aplicación hace solicitudes y procesa respuestas. Aun así necesita reintentos, protección contra envíos duplicados y manejo de eventos de entrega.
SMPP usa una conexión que permanece abierta. Tu cliente autentica una sesión y gestiona la pérdida de conexión, las confirmaciones y las operaciones entrantes. SMPP explica ese trabajo.
Un sistema SMPP existente puede hacer de esa interfaz una opción práctica. Prueba las operaciones admitidas y los límites del proveedor antes de asumir que otra conexión SMPP se comporta de forma idéntica.
¿Qué capacidades de entrega debo comparar?
Compara la cobertura de destinos, los remitentes permitidos, el rendimiento y los reportes de fallos útiles con las necesidades de tu aplicación.
- Destinos: confirma la cobertura en cada país que atiendes, ya que una ruta funcional no garantiza otra.
- Remitentes: verifica la disponibilidad y el registro antes de comprometerte con la identidad que verán los destinatarios.
- Rendimiento: distingue los límites de solicitudes de la velocidad a la que la ruta de entrega puede transportar tráfico.
- Eventos: verifica cómo los mensajes entrantes y los fallos de entrega llegan a tu aplicación.
Las páginas de destinos de Bird publican requisitos específicos por país. Tipos de remitente explica las opciones de identidad.
¿Por qué la entrega llega por separado de la aceptación?
La red puede completar la entrega después de que tu solicitud de envío finalice.
Un centro de mensajes puede retener un texto mientras un teléfono no está disponible. Centros de mensajes explica esa etapa de espera.
Mantén el envío y la entrega como resultados separados en tu aplicación. De lo contrario, una solicitud aceptada puede parecer exitosa incluso cuando un reporte de entrega posterior registra un fallo.
¿Cómo envío a través de la HTTP API de Bird?
Envías un mensaje, guardas su identificador y procesas los eventos de entrega que siguen.
Usa POST /v1/sms/messages con to, from, text y category para un envío de texto libre. Establece category en uno de marketing, transactional, authentication o service. La guía de envío documenta los campos admitidos.
Una respuesta 202 confirma la aceptación. No confirma la entrega al teléfono. Rastrea el id devuelto a través de los eventos de SMS para que el resultado final actualice la solicitud correcta.
¿Qué ruta se adapta a mi aplicación?
Elige la interfaz que tu aplicación pueda operar de forma fiable y luego verifica las capacidades de entrega por separado.
- Usa HTTP para una integración nueva que no tenga un requisito específico de SMPP.
- Usa SMPP cuando un sistema existente o un comportamiento de conexión requerido justifique su gestión de sesión.
- Prueba los destinos, los remitentes y los eventos de entrega antes de comprometer tráfico en cualquiera de las dos rutas.
En resumen
La API y el gateway cumplen funciones distintas.
La API acepta tu solicitud, mientras que el gateway proporciona la ruta hacia la red móvil.
HTTP evita gestionar una sesión SMPP.
SMPP requiere recuperación de conexión y gestión de sesión además de tu flujo de mensajes.
La aceptación y la entrega son resultados separados.
Una solicitud de envío exitosa no confirma que el destinatario haya recibido el mensaje.
Compara la ruta de entrega además de la interfaz.
Verifica la cobertura de destinos, los requisitos de remitente, el rendimiento y los reportes de fallos antes de elegir una integración.