Inicio » API SMS Octopush » Gestión de Callbacks

Gestión de Callbacks

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:

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.

  1. Guarda los datos recibidos en la base de datos.
  2. 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).