Recuperar e modificar o histórico de mensagens em Java

Este guia mostrará como você pode usar Java para pesquisar, recuperar e modificar as mensagens enviadas com o Programmable SMS. Os fragmentos de código neste guia foram elaborados usando Java e requerem o Java JDK versão 8 ou superior. Eles também usam o SDK Java da Twilio.

Vamos começar!

Pesquisar mensagens anteriores

Quando você envia uma mensagem SMS ou MMS pela API REST usando o verbo <Message> em TwiML, ou alguém envia uma mensagem para um dos seus números Twilio, a Twilio cria um recurso de instância de mensagem. O recurso Lista de mensagens representa o conjunto de mensagens enviadas e recebidas por uma conta.

A recuperação de mensagens enviadas e recebidas do histórico pode ser realizada consultando o recurso Lista de mensagens. Veja a seguir como recuperar todas as mensagens da sua conta:

Se quiser que a Twilio restrinja essa lista de mensagens, você pode especificar um número To, um número From e um DateSent. O exemplo a seguir mostra uma especificação de todos os três, mas você pode especificar qualquer combinação de parâmetros necessários. Este exemplo filtra as mensagens enviadas de um número específico para outro em ou após uma determinada data:

Recuperar uma única mensagem

Se você souber o SID da mensagem (ou seja, o identificador exclusivo da mensagem), poderá recuperar essa mensagem específica diretamente.

Como saber o SID? Ao enviar uma mensagem usando a API REST, você receberá um recurso de instância de mensagem como resposta da Twilio. Dessa forma, você pode inspecionar a propriedade SID do recurso. Leia mais sobre o envio de mensagens em nosso guia sobre o tópico.

Ao usar o verbo <Message> em TwiML, você precisará especificar um URL do webhook do atributo action, para que a Twilio chame o webhook quando o status da mensagem mudar. O webhook receberá um parâmetro MessageSid identificando a mensagem recebida. Leia nosso guia sobre rastrear o status das mensagens para obter mais informações sobre como fazer isso.

Ao receber uma mensagem, o webhook receberá um parâmetro MessageSid identificando a mensagem recebida. Você pode saber mais sobre receber mensagens aqui.

Independentemente de como o SID é obtido, você pode solicitar imediatamente a mensagem usando o código acima, ou salvar o SID em um banco de dados para recuperá‐lo posteriormente.

Excluir ou ocultar mensagens enviadas anteriormente

Se quiser excluir uma mensagem do histórico, você pode fazer isso facilmente excluindo o recurso de instância de mensagem.

Talvez você queira ocultar o corpo da mensagem para fins de segurança, mas não excluir a mensagem do histórico por completo. A ocultação de uma mensagem é feita publicando um corpo vazio no recurso de mensagem: