Quebre os silêncios constrangedores com piadas de fim de ano péssimas por SMS

Neste tutorial, vou mostrar a você como criar seu próprio “quebrador de silêncios constrangedores”, na forma de um aplicativo de SMS que vai responder com piadas de fim de ano péssimas e frases de efeito que você pode soltar na mesa, aliviando rapidamente a tensão.

Reunir grandes grupos de familiares em qualquer época do ano pode, às vezes, ser um pouco constrangedor. Como quando o tio Bill exagera nas bebidas e acaba dizendo algo sobre a prima Roberta que deixa todo mundo mastigando pastinacas sem saber o que fazer.

Que constrangedor. Abra seu editor de código e vamos começar.

Experimente antes de criar

Minha versão desse aplicativo já está no ar, então você pode enviar uma mensagem agora mesmo e ver os resultados antes de começarmos a analisar o código.

Envie um SMS com a palavra “awkward” para +44 7520619627 se você estiver no Reino Unido, ou +1 201 844 9627 se você estiver nos EUA e cair na gargalhada com as frases geniais que receberá em resposta... talvez.

(Quem tiver um olho mais atento já deve ter percebido que os últimos quatro dígitos de cada um desses números formam a sigla X-M-A-S no teclado do telefone.)

Essa frase não quebrou o silêncio sombrio, sombrio? Tudo bem, mande um SMS com a palavra “mais” em resposta e receba outra frase que talvez ajude.

Criação do aplicativo

O aplicativo que vamos desenvolver usa Node.js, o framework Koa (que é basicamente uma implementação mais moderna do Express) e a Messages API do Vonage.

O código está disponível em um repositório na conta da Comunidade Nexmo no GitHub , e também em formato remixável no Glitch.

Pré-requisitos

• A interface de linha de comando do Vinterface de linha de comando do Vonage

• Um novo número com capacidade para receber SMS

• Node.js versão 8 ou superior

• Uma seleção de piadas péssimas e frases de efeito

• Uma situação embaraçosa

Clonar o repositório

Em qualquer diretório, clone uma cópia do código da nossa nexmo-community no GitHub:

Em seguida, vá para o diretório para acessar o código:

Abra esse pacote festivo e cheio de surpresas no seu editor, e vamos dar início à configuração.

Vamos lá!

Para configurar este aplicativo, ele precisa estar acessível a partir do exterior. Use o Ngrok para expor a porta 3000 e anote a https URL fornecida:

Se você ainda não usou o Ngrok antes, siga o guia nesta esta postagem do blog para começar a usar.

Configuração

O primeiro arquivo a ser configurado é o .env.sample arquivo. Comece renomeando-o para .env.

Insira todas as seguintes informações:

A seguir, vamos aos detalhes específicos do aplicativo. Configure isso usando a CLI.

O aplicativo que você clonou contém dois endpoints:

• /inbound recebe novas mensagens SMS

• /status é uma URL obrigatória para qualquer aplicativo de Mensagens e Despacho; ela recebe confirmações de leitura e outras informações sobre as mensagens que você envia

Este comando configurará um novo aplicativo “Mensagens e Despacho” no seu Account. Ele exibe o Application ID na tela e também criará uma chave privada no diretório em que você está no momento. Ambos são necessários para a próxima etapa da configuração:

Por fim, insira seu novo número com capacidade para receber SMS:

Depois de preencher todos esses campos, você pode salvar seu .env e fechar o formulário.

Agora você precisa de um número para poder receber chamadas. Você pode alugar um usando o comando a seguir (substituindo o código do país pelo seu). Por exemplo, se você estiver nos EUA, substitua GB por US:

• Copiar

  vonage numbers:search US vonage numbers:buy [NUMBER] [COUNTRYCODE]

  Agora, vincule o número ao seu aplicativo:

  vonage apps:link --number=VONAGE_NUMBER APP_ID

  Copiar

É isso aí. A configuração está concluída!

Deixe o clima festivo rolar

Agora, o Vonage sabe para onde tudo está indo e como encaminhar novas mensagens para o seu aplicativo. Só falta uma coisa:

Assim que o servidor estiver em funcionamento, verifique se sua conexão com o Ngrok ainda está ativa na mesma URL que você usou nos callbacks e, em seguida, envie um SMS com a palavra “awkward” para o seu novo número.

E agora, para onde vamos?

Seus próximos passos são implantar esse aplicativo em um servidor. O Heroku é uma excelente opção para isso, e o aplicativo não precisará de nenhuma alteração no código para funcionar lá.

Lembre-se de que, ao implantar o aplicativo em outro lugar, você precisará atualizar os callbacks para o número de SMS e as duas URLs do seu aplicativo Messages & Dispatch.

Os comandos da CLI necessários para fazer isso são:

Então está tudo pronto.

Quer que seja ainda mais fácil?

Se você estiver procurando uma maneira ainda mais rápida de experimentar o código desse aplicativo, pode modificá-lo no Glitch clicando no botão abaixo: