Para una completa integración de nuestro servicio, usted debe poder enviarnos sus solicitudes de envío de SMS, pero también recibir la información relacionada con sus envíos. Tenemos 3 tipos de información para enviarle:
- Acuse de Recibo (si está utilizando SMS Premium)
- Respuestas a sus SMS o SMS entrantes (si ha activado y solicitado la opción)
- Pedido de Baja (Solicitud de desinscripción)
Para ello, tendrá que proporcionar la misma o diferentes URLs que serán llamadas por nuestros servidores para transmitirle esta información.
¿Dónde configurar esas URL ?
En su interfaz, a la izquierda en su menú, tendrá un enlace “Callbacks”.
A continuación, para cada tipo de devolución de llamada, puede definir la URL a la que se enviarán. Esta URL debería responder en aproximadamente 1 segundo, y no debería devolver respuesta. Para no malgastar recursos, su script debe registrar sólo los datos. A continuación, tendrá que proporcionar otro proceso que procese los datos, de forma asíncrona.
Callbacks URL
Esos callbacks se hacen por solicitud HTTP POST.
Pueden ser tres URLs diferentes, o una misma URL, en la cual usted diferenciará los tratamientos en función de los campos recibidos.
Ejemplo: puede identificar fácilmente el tipo de devolución de llamada según si recibe answer_date, DELIVERY_DATE o stop_date.
Restricciones especiales
La página a la que se dirige la URL que usted proporciona no debe mostrar nada, ni siquiera un HTML en blanco.
También debe responder en menos de 1 segundo. El procesamiento de los datos recibidos debe realizarse de forma asíncrona.
- Guarda los datos recibidos en la base de datos.
- Activar un script/servicios/cron que procese estos datos.
Esto nos permite acceder a los intercambios entre nuestros servidores y (el) los suyo(s) sin sobrecargar innecesariamente las conexiones.
Recomendaciones
- Pruebe su página antes de enviárnosla, llamándola con un comando CURL, por ejemplo.
- Desactivar la visualización de errores (para evitar cualquier error de advertencia, aviso, fatal, etc…).
- No mostrar ningún mensaje, sino redirigirlos a un archivo de registro.
- Por último, para mejorar el rendimiento, procese los datos recibidos de forma asíncrona: simplemente guarde los datos en algún lugar (archivo o tabla db) y delegue el procesamiento a otro script (cron o trigger).