Recuperar y modificar el historial de mensajes en Python

En esta guía, te mostraremos cómo puedes utilizar Python para buscar, recuperar y modificar los mensajes que envías con los SMS programables.

En estos ejemplos, se utilizarán el SDK para Python de Twilio y algunas características muy potentes de Twilio. Es muy fácil. ¡Empecemos!

Buscar mensajes anteriores

Cuando envías un mensaje SMS o MMS a través de la API REST de Twilio, utilizas el verbo <Message> en TwiML o recibes un mensaje en uno de tus número de Twilio, Twilio crea un recurso de instancia de mensaje. El recurso de lista de mensajes representa el conjunto de mensajes que envía y recibe una cuenta.

La recuperación de los mensajes enviados y recibidos del historial se realiza al consultar el recurso de lista de mensajes. A continuación, puedes ver cómo recuperar todos los mensajes desde tu cuenta:

Si deseas que Twilio reduzca esta lista de mensajes, puedes hacerlo al especificar el número de To, From y un DataSent. En el siguiente ejemplo, se muestra la introducción de los tres parámetros, pero puedes utilizar cualquier combinación que desees. En este ejemplo, se filtran los mensajes enviados desde un número específico a otro número específico en o después de una fecha en concreto:

Recuperar solo un mensaje

Si conoces el SID del mensaje (es decir, el identificador único del mensaje), puedes recuperar ese mensaje específico directamente.

¿Cómo podría conocer el SID?

Al enviar un mensaje con la API REST, recibirás un recurso de instancia de mensaje como respuesta de Twilio. Con esto, inspecciona y almacena la propiedad del SID del recurso. Obtén más información sobre el envío de mensajes en nuestra guía del tema.

Cuando utilices el verbo <Message> en TwiML, deberás especificar una URL de webhook y el atributo de acción para que Twilio llame a tu webhook cuando cambie el estado del mensaje. Tu webhook recibirá el parámetro MessageSid e identificará el mensaje entrante. Consulta nuestra guía sobre el seguimiento del estado de un mensaje a fin de obtener más información sobre esto.

Al recibir un mensaje, tu webhook recibirá el parámetro MessageSid e identificará el mensaje entrante. Puedes obtener más información sobre la recepción de mensajes aquí.

Sin embargo, puedes solicitar de inmediato el mensaje con el código anterior o puedes guardar el SID en una base de datos para recuperarlo posteriormente.

Eliminar o redactar mensajes enviados anteriormente

Si deseas eliminar un mensaje del historial, puedes hacerlo fácilmente al eliminar el recurso de instancia de mensaje.

Tal vez desees redactar el cuerpo del mensaje por motivos de seguridad, pero no te recomendamos borrar completamente el mensaje del historial. Para redactar un mensaje, se requiere publicar un cuerpo vacío en el recurso del mensaje: