Enviar mensagens SMS e MMS com um Particle Photon
Se você tem Wi‐Fi disponível, o Particle Photon é um dispositivo pequeno surpreendente para desenvolver sua Internet of Things... Thing. Medindo apenas 1,44" x .8", ele ainda tem um poderoso Cortex M3 ARM de 120 MHz da STMicroelectronics integrado, bem como um dispositivo Wi‐Fi da Cypress Semiconductor. Isso significa ciclos rápidos de construção e uma poderosa base de produtos de IoT por pouco dinheiro.
Hoje vamos mostrar como fazer com que seu Particle Photon envie MMS e SMS com a Twilio. Tudo o que você precisa é de seu Photon, uma rede Wi‐Fi amigável e cerca de 20 minutos.
Vamos lá!
Fazer login ou inscrever‐se em uma conta da Twilio
Crie uma nova conta com a Twilio (clique aqui para obter uma versão de avaliação gratuita da Twilio) ou entre na sua conta da Twilio.
Encontrar ou comprar um número compatível com SMS e/ou MMS
Para que isso funcione, você precisa usar um número habilitado para SMS (ou SMS e MMS).
- Entre no Console da Twilio
- Selecione a seção Phone Numbers (números de telefone) ('#' / hash tag) no lado esquerdo
- Navegue até seu inventário de números atual
Em "Capabilities" (Recursos), você verá os recursos de número de telefone. Você precisará de números com SMS ou ambos SMS e MMS ativados:
Se você não tiver um número com recursos de SMS ou MMS no momento, poderá adquirir um. Depois de navegar para o link "Buy a Number (Comprar um número)", clique na caixa de seleção SMS e/ou MMS:
Salve o número que você usa em uma guia do navegador, para que ele esteja prontamente disponível.
Recuperar seu Account SID (SID da conta) da Twilio e o API Secret (segredo de API)
Para chamar a API da Twilio a partir do Photon, você precisará autenticar. Você precisa ter o Account SID (SID da conta) da Twilio e um Auth Token (Token de autenticação) Twilio disponível.
Você pode encontrar ambos no Console da Twilio:
Como antes, mantenha‐os disponíveis.
Preparar seu Particle Photon para fazer o flash
Para fazer o flash do Particle Photon, primeiro você precisará garantir que ele esteja conectado à sua rede Wi‐Fi.
Se você ainda não o fez, siga o Guia de introdução do Particle para configurar seu Photon.
Exemplo 1: Um exemplo simples de envio de SMS com um Particle Photon
O Particle usa Webhooks (assim como a Twilio!) para acionar APIs externas quando ocorrem eventos. Quando você publica um evento na nuvem do Particle, o webhook que você cria é usado para acionar qualquer evento externo que você desejar. Isso pode significar sua própria lógica de servidor ou de negócios, mas para hoje vamos vincular nossos Webhooks do Particle à Twilio.
Faça login no IDE do Particle Web com sua conta.
Copiar nosso app Particle Photon compartilhado
Há duas maneiras de obter o código de exemplo para este aplicativo:
- Copiar diretamente do serviço de apps compartilhados do IDE do Particle Web
- Clonar de nosso repositório no Github
Esse trecho curto é tudo o que você precisa para enviar um SMS com o Photon.
Particle.publish("twilio_sms", body, PRIVATE);
Essa linha de código é a forma como fazemos o envio de um evento para a nuvem. Ainda não o adicionamos (isso é o próximo passo!), mas "twilio_sms
" é o evento que gera uma chamada para a Twilio, enquanto body
é uma variável que é passada.
Atualize o código para seu Photon com o ícone "Flash" (relâmpago). Você verá que os LEDs funcionam, mas ainda não obterá uma mensagem de texto.
Configurar um Webhook do Particle
Chegou a hora! Tenha em mãos suas credenciais da Twilio e um número de telefone compatível com SMS. Vamos passar por algumas etapas muito simples para fazer com que nosso Webhook do Particle funcione.
- Navegue até a tela Webhook Integration (Integração do Webhook) do console do Particle
- Clique no ícone do botão "+" para criar uma nova integração
- Selecione "Webhook"
- Nome do evento:
twilio_sms
- URL:
https://api.twilio.com/2010-04-01/Accounts/{{ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX}}/Messages
(substituir "ACXXX....
" pelo Account SID (SID da conta) da Twilio) - Tipo de solicitação:
POST
- Dispositivo:
Any
Em seguida, alteraremos algumas das opções avançadas para que possamos dar à Twilio o que ela precisa para enviar uma mensagem de texto.
Alterar as opções avançadas do Webhook do Particle
Faça as seguintes alterações depois de expandir a seção "Advanced Options" (Opções avançadas).
- Enviar dados personalizados: Formulário
- Em Data (Dados), defina os três seguintes itens:
To - [[SEU NÚMERO/NÚMERO DE TELEFONE CELULAR QUE PODE RECEBER SMS]]
From - [[SEU NÚMERO TWILIO ACIMA]]
Body -{{PARTICLE_EVENT_VALUE}}
- Em HTTP BASIC AUTH:
Username (Nome do usuário) - [[Your Account SID (SID da conta)]]
Password (Senha) - [[Chave secreta da API]]
Depois de salvar, sinta‐se à vontade para enviar uma mensagem de "Teste" com o botão "Test" (Teste). Ou, espere o próximo passo - vamos juntos e pronto!
Desligar e ligar o Photon
Pressione o botão de reinicialização no Photon ou desligue e ligue.
Ele deve enviar uma mensagem de texto (dedos cruzados!). Legal!
Exemplo 2: Adicionar suporte de MMS a um Particle Photon
O primeiro exemplo, por padrão, é muito simples. Neste exemplo, vamos aumentar a complexidade adicionando mensagens de mídia opcionais por meio de MMS ao app.
Com o JSON formado corretamente, o Particle também permite passar inúmeras variáveis. Esse é o mecanismo que usaremos para desenvolver o recurso MMS.
Copiar nosso app compartilhado do Photon MMS
Como antes, há duas opções para recuperar nosso código. Você pode:
Mais uma vez, reduzimos o código ao mínimo. Em seu aplicativo de produção, você desejará verificar itens como tamanho da mensagem e codificação de mensagem de texto, além de adicionar sua lógica de negócios. Você também precisará considerar caracteres especiais, como aspas duplas.
Configurar outro Webhook
Nomeie um novo Webhook twilio_mms,
mas, caso contrário, siga as mesmas etapas do Webhook "twilio_sms" acima.
Além disso, você precisa alterar "Send Custom Data (Enviar dados personalizados)" para "Formulário":
- To - [[SEU NÚMERO/NÚMERO DE TELEFONE CELULAR QUE PODE RECEBER UM MMS]]
- From - [[SEU NÚMERO DE TELEFONE DA TWILIO ACIMA]]
- Body -
{{body}}
- MediaUrl -
{{image}}
Agora temos 2 variáveis personalizadas, body
e image
. Em C++, criamos manualmente o JSON e adicionamos o caminho da imagem e o corpo da mensagem.
Reiniciar ou desligar e ligar o Photon
Após uma reinicialização (supondo que você tenha feito o flash...), você verá uma mensagem e uma bela imagem de alguns animais selvagens.
Você consegue desenhar a coruja que aparece?
Textos do Particles de luz em movimento (ou ondas?)
20 minutos depois de iniciar este tutorial, agora você tem trechos que permitem enviar SMS ou MMS de um Particle Photon. Seja automatizando sua casa, monitorando o clima ou criando o Next Big ThingTM... sabemos que você construirá algo fantástico. Esperamos que esta base seja útil!
Mal podemos esperar para ver o que você vai construir! Mantenha‐nos informados no Twitter!
Precisa de ajuda?
Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.