Consultel - Documentación
Notificaciones de entrega
- Introducción
- Listado de notificaciones de entrega
- Consultar las notificaciones de entrega desde el portal
- Exportar el listado de notificaciones de entrega
- Crear agenda a partir de notificaciones de entrega
- Eliminar contactos de una agenda a partir de notificaciones de entrega
- Consultar las notificaciones de entrega desde la API
Introducción
Las notificaciones de entrega son informes detallados que cada una de las operadoras de telefonía móvil nos envían, por cada uno de los SMS que envías a tus contactos. Cada notificación de entrega está relacionada con un envío SMS realizado, y en este informe viene detallado el resultado de dicho envío y la fecha en que hemos recibido la notificación por parte de la operadora de telefonía móvil.
Las notificaciones de entrega son muy útiles para conocer el total de contactos que han recibido tus envíos SMS, ya sea de un envío concreto o de todos tus envíos en general. También puedes obtener que contactos han generado una notificación de entrega de alguno de los errores que hay especificados en la siguiente tabla, y si lo deseas, puedes eliminar dicho contacto para no enviarle más SMS y así limpiar tus agendas de contactos erróneos.
Debes tener en cuenta antes de eliminar un contacto que hay notificaciones de entrega que indican un error temporal del contacto, y otras que son de error permanente. Las notificaciones que son de error temporal, pueden suponer que el contacto afectado este operativo otra vez en un corto espacio de tiempo, y de este modo sea apto para volver a recibir tus SMS, por lo que no es aconsejable en este tipo de casos que elimines tus contactos basándote en tan solo una notificación de este tipo. De otro modo, las notificaciones de error permanente indican que el contacto no está operativo, y que muy probablemente sea por un largo espacio de tiempo.
Por último, también puedes obtener notificaciones de entrega que no hacen referencia al estado del contacto, sino a otros factores como el saldo de tu cuenta, restricciones horarias en alguna de tus configuraciones de envíos, o en errores de conexión con alguna de las operadoras de telefonía móvil.
Listado de notificaciones de entrega
Listado de notificaciones de entrega existentes:
A continuación tienes una explicación detallada de cada notificación de entrega:
Pendiente
Esta notificación se asigna justo en el momento de realizar el envío del SMS al contacto correspondiente, y precisamente te indica que este envío esta pendiente de recibir una notificación por parte de la operadora de telefonía móvil.
Entregado
Esta notificación es enviada por la operadora de telefonía móvil, y te informa que el contacto ha recibido correctamente el SMS enviado.
Otro error
Esta notificación es enviada por la operadora de telefonía móvil, es un error temporal, y te informa que el contacto no esta operativo en estos momentos sin especificar cual es el motivo.
Destinatario desconocido
Esta notificación es enviada por la operadora de telefonía móvil, y te informa que dicha operadora no puede entregar el SMS enviado al contacto correspondiente por no poder asociar el número del destinatario a ningún operador.
Caducado
Esta notificación es enviada por la operadora de telefonía móvil, es un error temporal, y te informa que dicha operadora ha intentado entregar el SMS enviado al contacto correspondiente durante 48 horas, sin poder lograrlo ya que dicho contacto se encuentra apagado o fuera de cobertura.
No disponible temporalmente
Esta notificación es enviada por la operadora de telefonía móvil, es un error temporal, y te informa que el contacto al que enviaste el SMS, no está operativo en estos momentos pero que en cualquier momento puede volver a ser apto para recibir tus SMS.
No disponible permanentemente
Esta notificación es enviada por la operadora de telefonía móvil, es un error permanente, y te informa que el contacto al que enviaste el SMS, no está operativo en estos momentos y que muy probablemente sea por un largo espacio de tiempo.
No admite publicidad
Esta notificación es enviada por la operadora de telefonía móvil, y te informa que el contacto al que enviaste el SMS, ha indicado a su operadora el deseo de no recibir SMS publicitarios.
No enviado por estar en la lista negra. Coste reembolsado
Esta notificación es enviada por la aplicación, y te informa que has intentado enviar un SMS a un contacto que tienes dentro de tu agenda de lista negra. También te indica que el coste del envío de este SMS ha sido reembolsado en el saldo de tu cuenta.
El contacto no desea publicidad de PREMIUM SMS
Esta notificación es enviada por la aplicación, y te informa que has intentado enviar un SMS a un contacto que está dentro de la lista negra de PREMIUM SMS.
Sin saldo para enviar el mensaje
Esta notificación es enviada por la aplicación, y te informa que has intentado enviar un SMS sin disponer del saldo suficiente en tu cuenta para poder realizarlo.
Temporalmente no entregable. Coste reembolsado
Esta notificación es enviada por la aplicación, y te informa que no se ha podido enviar el SMS al contacto correspondiente porque ha habido un error temporal de conexión con la operadora de telefonía móvil de dicho contacto. También te indica que el coste del envío de este SMS ha sido reembolsado en el saldo de tu cuenta.
No enviado por restricción horaria
Esta notificación es enviada por la aplicación, y te informa que no se ha podido enviar el SMS al contacto correspondiente porque la configuración de envío que lo debía ejecutar, ha llegado a su fecha de finalización sin tener el tiempo necesario de realizarlo.
No entregado por superar límites de envío al destinatario
Esta notificación es enviada por la operadora de telefonía móvil, y te informa que no se ha podido enviar el SMS por haber superado las restricciones del número de envíos a un mismo destinatario. No se permite el SPAM en nuestra plataforma.
Consultar las notificaciones de entrega desde el portal
Para consultar las notificaciones a través del portal, dirígete al apartado de 'Informes' y pulsa en Notificaciones de entrega
Podrás consultar las notificaciones de entrega y utilizar los siguientes filtros de búsqueda:
- Fecha
- Por tipo de aplicación
- Por configuración
- Por número de móvil
- Por el estado de la notificación
Desde el portal, puedes realizar diversas acciones con el listado de notificaciones de entrega generado por tu búsqueda pulsando el botón 'Opciones':
- Exportar el listado de notificaciones de entrega
- Crear agenda a partir de notificaciones de entrega
- Eliminar contactos de una agenda a partir de notificaciones de entrega
Exportar el listado de notificaciones de entrega
Puedes exportar el listado de notificaciones resultantes de tu búsqueda a un archivo Excel (.xlsx) o CSV (.csv).
Crear agenda a partir de notificaciones de entrega
Puedes crear una agenda nueva que contenga los contactos (número de móvil) que aparecen en los resultados de tú búsqueda.
Esta opción es útil para crear agendas nuevas a partir de las notificaciones de entrega de tus envíos. Por ejemplo, puedes crear una agenda nueva con todos los contactos que han recibido los SMS correctamente en tus envíos (con notificación de entrega entregado) y así asegurarte que no enviarás mensajes a usuarios que no los vayan a recibir.
Otra opción podría ser crear nuevas agendas con notificaciones de entrega de mensajes que no se han recibido, para después poder exportarlas y poder realizar acciones comerciales con estos números o eliminarlos de tus agendas.
Depende de tu modelo de negocio, es importante que pienses como puedes usar esta opción para crear nuevas agendas a través de las notificaciones de entrega y el filtro de estado de la notificación (es decir, buscar por entregados, caducados, etc.)
Eliminar contactos de una agenda a partir de notificaciones de entrega
Puedes eliminar contactos de una agenda que elijas a partir de los contactos (números de móvil) que aparecen en los resultados de tu búsqueda.
Además podrás aplicar los siguientes filtros:
- El contacto debe aparecer X veces en el listado
- No se borrará el contacto de la agenda si aparece X veces como entregado en un período de tiempo que tu elijas
Esta opción es útil para limpiar tus agendas según los parámetros que elijas. Por ejemplo, puedes usar esta opción para limpiar tus agendas de contactos a los que no se ha podido entregar el mensaje. Para hacer esto, deberías buscar notificaciones de entrega con estado diferente a entregado, y usar esta opción para eliminar estos contactos de la agenda que elijas.
Consultar las notificaciones de entrega desde la API
Puedes realizar peticiones a la API para obtener notificaciones de entrega según los parámetros que elijas. Puedes consultar la documentación de la API para Notificaciones de entrega para conocer todos los detalles.
Realizando peticiones a la API puedes utilizar los siguientes filtros de búsqueda:
- Fecha
- Id de mensaje
- Por tipo de aplicación
- Por configuración
- Por número de móvil
- Por el estado de la notificación
A diferencia del método de consulta por el portal, la API dispone de un filtro de búsqueda más: id de mensaje. Si realizas peticiones de envío de SMS desde la API, por cada mensaje obtenido te devolveremos su id de mensaje correspondiente. Así podrás consultar la notificación de entrega cuando desees.
Obtener notificaciones a través de una Callback URL
Al realizar peticiones de envío de SMS a través de la API debes utilizar una configuración de envío. Si lo deseas, en esta configuración de envío puedes definir una URL donde te enviaremos a través de una petición POST, el id del mensaje y el estado de la notificación de entrega.