Envie qualquer coisa por SMS com o IFTTT e a Vonage

Moro em Tel Aviv, uma cidade litorânea com 300 dias de sol por ano. O clima é tão estável que nunca verifico a previsão do tempo. Mas, sempre que chove, cai uma chuva torrencial! E eu acabo encharcado e com frio. Se ao menos eu tivesse algum tipo de lembrete para me avisar que vai chover.

Você já ouviu falar do IFTTT? IFTTT significa “If This Then That” (Se isso, então aquilo). É um serviço baseado na web que permite criar instruções condicionais simples, chamadas de applets, para automatizar várias tarefas e ações em diferentes serviços da web e dispositivos. E tudo isso sem precisar programar! A ideia básica é conectar diferentes aplicativos e dispositivos para criar fluxos de trabalho automatizados com base em gatilhos e ações.

As plataformas “no-code” e “low-code” são extremamente úteis para uma infinidade de coisas diferentes. E o melhor de tudo é quando você as combina para resolver problemas!

Então, neste post, vou mostrar como criei um applet no IFTTT para me ajudar a saber quando vai chover e levar um guarda-chuva comigo. O applet vai me enviar um SMS de aviso usando o AI Studio da Vonage, que não requer programação ou requer pouca programação AI Studio da Vonage.

IFTTT Explore

Pré-requisitos:

1. Account de desenvolvedor da Vonage

2. Account no IFTTT - Cadastre-se para obter um account gratuito no IFTTT

3. Número virtual da Vonage

Criação de um applet do IFTTT

Acesse a página “Criar Applet”. Pesquise e selecione “Weather Underground”. Em seguida, você verá uma lista de todos os gatilhos disponíveis do Weather Underground.

Choose a Weather Underground Trigger

Você deve selecionar “A previsão para amanhã indica”. A primeira metade do nosso Applet está pronta! Você deve ser redirecionado para uma página parecida com esta:

Applet If This Than That Page

Agora precisamos, de alguma forma, instruir o IFTTT a enviar um SMS. Faremos isso usando o AI Studio da Vonage.

Criação de um agente de SMS de saída

Vamos criar agora nosso Agente do AI Studio. Acesse o Painel do AI Studio. Siga as instruções encontradas na documentação do AI Studio aqui. Há três opções importantes para o nosso agente; selecione:

• Tipo: SMS

• Modelo: Começar do zero

• Evento: Outbound

Nosso agente será extremamente simples: enviará um único SMS informando que amanhã vai chover. Ele também enviará um link para a previsão do tempo completa e informará as temperaturas máximas e mínimas previstas.

Para isso, precisamos criar três parâmetros no AI Studio, que armazenarão os valores que recebermos do IFTTT. Os parâmetros serão do @sys.any tipo Entidade e se chamarão, ForecastUrl, HighTempCelsius, e LowTempCelsius. Veja abaixo:

AI Studio Dashboard Parameter Creation

Agora podemos adicionar nosso único nó “Enviar mensagem” e nossa mensagem de alerta, que utiliza nossos três parâmetros.

AI Studio Send Message

O último passo é publicar nosso agente.

Conectando o IFTTT com Webhooks

Agora que nosso agente está configurado, tudo o que precisamos fazer é concluir nosso Applet no IFTTT e conectá-lo ao agente. Faremos isso usando o serviço Webhook. Portanto, no IFTTT, continue e procure por “Webhook”.

Choose IFTTT Webhook Service

Selecione “Fazer uma solicitação na web” e continue até ver a seguinte página:

Make a web request

No campo URL, você precisará colar uma das opções a seguir. O endpoint depende da região selecionada para o seu agente.

Para agentes da UE --> https://studio-api-eu.ai.vonage.com/messaging/conversation Para agentes dos EUA --> https://studio-api-us.ai.vonage.com/messaging/conversation

Conjunto Método para POST.

Conjunto Tipo de conteúdo como application/json.

Para cabeçalhos adicionais , você precisará adicionar o seu X-Vgai-Key. Você pode encontrar o X-Vgai-Key no canto superior direito do seu painel do AI Studio. Clique no ícone de usuário e, em seguida, Generate API Key.

Exemplo: X-Vgai-Key: SUA_CHAVE_X_VGAI

Para “Body”, vamos adicionar o seguinte código:

{
  "to": "YOUR_PHONE_NUMBER",
  "agent_id": "YOUR_VONAGE_AGENT_ID",
  "channel": "sms",
  "session_parameters": [

    {
      "name": ForecastUrl,
      "value": {{ForecastUrl}}
    },

    {
      "name": "HighTempCelsius",
      "value": {{HighTempCelsius}}
    },

    {
      "name": "LowTempCelsius",
      "value": {{LowTempCelsius}}
    }
  ]
}

Você precisará substituir YOUR_PHONE_NUMBER pelo número de telefone no qual deseja receber os alertas. Por exemplo, “15551234567”. Da mesma forma, substitua YOUR_VONAGE_AGENT_ID pelo seu ID de agente, que pode ser encontrado na seção “Detalhes do agente”, localizada no painel lateral da sua conta de agente no AI Studio.

Por fim, clique em “Criar ação” e pronto!

Conclusão

Você já conhecia o IFTTT antes deste artigo? Para que você o utiliza? Que outras ferramentas “no-code” ou “low-code” você está usando? Estou muito interessado em saber o que você achou deste artigo.

Junte-se a mim no Vonage no Slack da Comunidade de Desenvolvedores ou X, antes conhecido como Twitter, e me conte quais projetos incríveis você está desenvolvendo!

Recursos adicionais

Low-Code e No-Code: qual é a melhor opção para você?

Se você sabe apontar e clicar, então você consegue criar uma IA conversacional

Curso rápido: Crie agentes virtuais para o WhatsApp com o Vonage AI Studio