Responder mensagens SMS e MMS com Python

Python é uma linguagem de programação amplamente utilizada devido à sua sintaxe de fácil compreensão, grande variedade de bibliotecas e ferramentas disponíveis para processamento de linguagem natural. Além disso, suporta programação orientada a objetos, o que permite estruturas mais complexas e maior organização de código.

É importante observar que diferentes serviços de mensagens podem ter diferentes mecanismos e restrições de API, portanto, você precisará pesquisar a documentação da API do seu serviço de mensagens para obter mais detalhes sobre como responder a mensagens usando Python.

API é a sigla para Application Programming Interface (Interfaz de Programación de Aplicaciones), um conjunto de regras e protocolos usados ​​para comunicação entre diferentes sistemas de computador. As APIs permitem que um aplicativo se conecte a outro e acesse suas funções e dados para realizar tarefas específicas. Da mesma forma, são muito úteis no desenvolvimento de software porque permitem a integração de diversas funcionalidades numa única aplicação, tornando-a mais completa e eficiente.

Neste artigo, ajudarei você a aprender como usar SMS programável para responder a mensagens recebidas em um aplicativo da web Python. Não se preocupe se você não estiver familiarizado com o webhooks e TwiML. Com este guia, ajudarei você a entender o básico rapidamente.

SMS (Short Message Service) é um serviço de mensagens curtas que permite enviar e receber mensagens de texto em telefones celulares. O conteúdo da mensagem é limitado a no máximo 160 caracteres.

MMS (Multimedia Messaging Service) é um serviço de mensagens multimídia que permite enviar e receber mensagens que incluem não apenas texto, mas também imagens, áudio e vídeo em celulares. As mensagens MMS têm maior capacidade que o SMS e podem atingir vários megabytes de tamanho.

A Twilio pode enviar uma solicitação HTTP para seu aplicativo Web quando ocorrem determinados eventos, como uma mensagem de texto recebida para um de seus números de telefone da Twilio.

O que é um webhook?

Webhooks são uma forma de integração de sistemas em que um aplicativo envia uma notificação push para outro aplicativo quando ocorre um evento em tempo real. Eles são frequentemente usados ​​em aplicativos web e móveis para sincronizar dados entre aplicativos de diferentes provedores ou para automatizar processos de trabalho. Da mesma forma, os webhooks são um meio de conectar aplicações para que possam se comunicar entre si de forma prática e automatizada.

Para gerenciar um webhook, você só precisa criar um pequeno aplicativo web que possa aceitar solicitações HTTP.

Principais elementos de um webhook

1. URL de destino: é o endereço da web para onde o serviço webhook deve enviar os dados.

2. Payload: é o conjunto de dados enviado por meio de um webhook. Pode incluir informações como ID do usuário, eventos recentes, informações de compra, etc.

3. Evento ou trigger: É a ação que provoca a ativação do webhook. Pode ser uma mudança no status da conta do usuário, um novo pedido ou um comentário em uma postagem nas redes sociais, entre outros.

4. Autenticação: é uma medida de segurança que garante que os dados do webhook venham de uma fonte confiável. Pode ser uma chave de API ou um token de autenticação.

5. Protocolo de comunicação: é o método de transmissão de dados utilizado. Pode ser HTTP, HTTPS ou outro protocolo de comunicação semelhante.

6. Métodos ou verbos HTTP: São as solicitações que o webhook enviará ao serviço receptor para informar sobre a conclusão de um evento. Os métodos HTTP mais comumente usados ​​em webhooks são POST e GET.

O que é TwiML?

TwiML (Twiilio Markup Language) é uma linguagem de marcação baseada em XML para controlar interações de voz e mensagens na plataforma de comunicações em nuvem da Twilio. TwiML nos permite como desarrolladores crear aplicaciones personalizadas y automatizar procesos de comunicación por medio de comandos que controlan las diferentes acciones realizadas durante una llamada o mensaje de texto como, por ejemplo, reproducir un archivo de audio, enviar un mensaje de texto o redirigir una llamada , entre outros. TwiML é mais fácil de mostrar do que explicar.

Aqui estão alguns TwiMLs que você pode usar para atender uma chamada telefônica e responder a uma mensagem SMS recebida:

Todo arquivo TwiML terá uma parte raiz < Response> e essa parte pode ter um ou mais verbos.

Gerar TwiML no aplicativo web

Código de exemplo

Se alguém enviar uma mensagem de texto para você com seu número Twilio, você poderá enviar uma resposta TwiML por meio de seu webhook configurado. A seguir explico como gerar um TwiML utilizando a biblioteca auxiliar.

Como primeiro passo, temos que importar o Flask, um framework web para Python que permite o desenvolvimento de aplicações web de forma simples e flexível. É utilizado para construção de sites e serviços web para empresas e organizações, além de ser considerado um dos frameworks mais populares e utilizados no mundo do Python.

O Flask caracteriza-se pela sua simplicidade, eficiência e poderoso sistema de extensão, que lhe permite integrar facilmente outros módulos e ferramentas para personalizar e adicionar funcionalidades à aplicação. Além disso, o Flask é compatível com a maioria dos provedores de hospedagem de aplicativos web.

Neste exemplo, quando o seu número de telefone Twilio receber uma mensagem, ele enviará uma solicitação HTTP ao seu servidor. HTTP significa em inglês Hypertext Transfer Protocol e é um protocolo usado para transmitir dados na World Wide Web. É o protocolo mais comum para comunicação entre clientes e servidores web. HTTP é um protocolo sem estado, o que significa que não mantém informações entre solicitações, o que contribui para sua escalabilidade e desempenho.

O código mostra como seu servidor pode responder com uma mensagem de texto usando a biblioteca auxiliar do Twilio.

Configurar a URL do webhook

Assim que tiver o URL, as respostas TwiML serão geradas em seu aplicativo Web, para que você possa configurar seu número de telefone Twilio para ligar para o URL do seu webhook sempre que uma nova mensagem SMS (ou MMS) aparecer.

Faça login no site do Twilio e vá para a página de números do console:

Modifique o número de telefone no painel principal.

Encontre a opção A MESSAGE COMES IN (Mensagem recebida).

Selecione Webhook e cole na URL que você vai usar:

Configurar SMS Webhook

Escolher HTTP POST ou HTTP GET conforme se adapta ao seu aplicativo da web.

No método GET o cliente envia uma solicitação ao servidor web para obter dados dos recursos especificados. Os dados geralmente são incluídos na URL da solicitação, tornando-os visíveis na barra de endereços do navegador.

Por outro lado, POST é um método de solicitação usado para enviar dados ao servidor web para processamento em algum lugar do servidor. Em uma solicitação POST, os dados são enviados no corpo da mensagem HTTP e não na URL.

URL do webhook de backup

No console você notará que também há um lugar onde você pode mencionar uma URL de webhook para PRIMARY HANDLER FAILS (Falha no controlador principal). Se ocorrer um erro ou nenhuma resposta for retornada em 15 segundos, ele chamará imediatamente essa URL com o controlador Twilio primário.

Responder com conteúdo multimídia (mensagem MMS)

Envie um MMS com imagem

Se quiser enviar um MMS você deve adicionar um URL de imagem. Você precisa reiniciar o servidor e enviar uma mensagem de texto com seu número Twilio novamente. Desta forma você deverá receber uma mensagem de texto com a imagem incluída.

Os números que possuem a função MMS poderão enviar e receber mensagens MMS. Você pode visualizar e verificar os recursos dos números no portal da conta Twilio que possuem MMS habilitado.

Respostas personalizadas para mensagens SMS recebidas

Gere uma mensagem TwiML dinâmica

Continuamos explicando como responderemos a um SMS recebido, usando uma mensagem diferente dependendo do parâmetro Body da solicitação recebida do Twilio.

Conclusão

Neste artigo, aprendemos como usar Python para responder mensagens SMS e MMS recebidas usando Twilio. Exploramos como configurar webhooks, gerar TwiML e personalizar respostas com base no conteúdo da mensagem recebida.

Com esse conhecimento, agora você está preparado para criar aplicativos mais avançados que usam os recursos do Twilio e do Python para lidar com mensagens recebidas e oferecer uma experiência mais rica aos usuários.

Não se sinta mal se precisar de ajuda: todos nós precisamos dela às vezes e programar é difícil. Ao ver os resultados depois de dias sem conseguir dormir tranquilo pensando nas alternativas possíveis para que o algoritmo não tenha erros, você se sente muito bem por poder concluir aquele projeto que tanto lhe custou aprender e executar.

Então anime-se e evolua a cada dia!