Quisiera recuperar remotamente el estado de entrega y certificación de los emails que envío. ¿Hay forma de hacerlo?
Cuando envías un email a través de eEvidence, confías en que lo entregaremos al destinatario. Sin embargo, ¿cómo puedes saber si realmente ha sido así? Los canales JSON y RESTful de intercambio de datos sobre HTTPs, te permiten recuperar los estados de entrega de tus emails consultando directamente nuestras bases de datos. Así de simple.
Hemos tenido que desplegar algunos recursos clave para poder ofrecer esta función de forma fiable. Por este motivo, esta función está disponible únicamente para planes Extended.
Acerca de nuestra solución JSON web service
JSON, o JavaScript Object Notation, es un formato estándar abierto que utiliza texto legible para transmitir paquetes de datos mediante pares de clave:valor. Se utiliza principalmente para transmitir datos entre un servidor y aplicaciones web, como alternativa a XML.
La consulta JSON de eEvidence se implementa definiendo cinco parámetros:
| /srv2/jlist | URI de base para el JSON web service |
| /{private.key} | Clave privada de cliente para consultas |
| /{geteevid.key} | Clave get eEvid de cliente para consultas |
| /{start.date} | Primera fecha de los datos a recuperar, en formato YYYYMMDD |
| /{end.date} | Última fecha de los datos a recuperar, en formato YYYYMMDD |
Una vez implementada, la consulta devuelve los datos relevantes de los eEvids durante el período solicitado, de acuerdo a la siguiente estructura:
| Clave | Valor |
| id: | ID del eEvid |
| type: | 'OUT' = petición para certificar email de salida, 'IN' = petición para certificar email de entrada, 'FILE' = petición para certificar solamente cuerpo del mensaje y adjuntos |
| xfield: | ID del email en origen (X-eEvid-SourceID en la cabecera email) |
| date: | fecha de entrega, en formato YYYY-MM-DD hh:mm:ss |
| subject: | asunto del email |
| to: | destinatario del email |
| af: | nombre de los archivos adjuntos |
| rcode: | código de respuesta en destino |
| rlog: | mensaje completo de respuesta en destino |
| status: | 'S' = Confirmado, 'D' = Confirmado con notificación diferida, 'P' = Pendiente de entrega, 'E' = Fallido, 'H' = Incompleto (Half Done) |
| tx_id: | ID secundario para programar descarga del eEvid.Cert |
La consulta más elemental se limita a los cuatro parámetros básicos y no devuelve registros de los eEvids confirmados: en el 99,9% de los casos los emails se entregan en cuestión de segundos, así que por qué malgastar tiempo y recursos. Otros parámetros opcionales permiten recuperar todos los registros —{full}—, con independencia de su estado, o consultar el estado de un email en particular —{xfield}.
Para cualquier duda, contacta por favor con Soporte.