https://d226lax1qjow5r.cloudfront.net/blog/blogposts/break-awkward-silences-with-terrible-festive-jokes-via-sms-dr/Break-Awkward-Silences-With-Terrible-Festive-Jokes-Via-SMS.png

Rompre les silences gênants avec de terribles blagues festives par SMS

Publié le April 19, 2021

Temps de lecture : 13 minutes

Dans ce tutoriel, je vais vous montrer comment construire votre propre briseur de silence gênant, sous la forme d'une application SMS qui vous répondra avec de terribles blagues festives et des one-liners que vous pouvez lancer à la table, en brisant rapidement la tension.

Réunir un grand nombre de membres de la famille à n'importe quel moment de l'année peut parfois s'avérer un peu gênant. Par exemple, lorsque l'oncle Bill a mélangé ses boissons et qu'il finit par dire quelque chose à propos de la cousine Roberta qui met tout le monde mal à l'aise en grignotant des panais.

C'est un peu gênant. Lancez votre éditeur de code et commençons.

Essayer avant de construire

Ma version de cette application est en ligne, vous pouvez donc l'envoyer par message dès maintenant et voir les résultats avant que nous n'entrions dans le code.


Envoyez un SMS contenant le mot "awkward" à +44 7520619627 si vous êtes au Royaume-Uni, ou +1 201 844 9627 si vous êtes aux États-Unis et éclatez de rire devant les phrases géniales qui vous seront envoyées en retour... peut-être.


(Les plus attentifs auront déjà remarqué que les 4 derniers chiffres de chacun de ces numéros s'écrivent X-M-A-S sur un clavier de téléphone).

Une ligne n'a pas brisé le silence sinistre ? D'accord, envoyez par SMS le mot "plus" en réponse et vous obtiendrez une autre ligne qui pourrait vous aider.

Création de l'application

L'application que nous allons construire utilise Node.jsle Koa (qui n'est autre qu'une implémentation plus moderne d'Express) et l'API Messages de Vonage.

Le code est disponible dans un dépôt sur le site de la Communauté Nexmo GitHub Account, et également sous forme de remixable sur Glitch.

Conditions préalables

  • L'interface de ligne de commande Vonage est une interface de ligne de commande

  • Un nouveau numéro capable d'envoyer des SMS

  • Node.js version 8 ou supérieure

  • Une sélection de blagues et de répliques terribles

  • Une situation délicate

Vonage API Account

To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

This tutorial also uses a virtual phone number. To purchase one, go to Numbers > Buy Numbers and search for one that meets your needs.

Cloner le référentiel

Dans n'importe quel répertoire, clonez une copie du code de notre site web nexmo-community sur GitHub :

git clone git@github.com:nexmo-community/xmas-jokes-nodejs.git

Ensuite, vous devez vous rendre dans le répertoire pour accéder au code :

cd xmas-jokes-nodejs

Ouvrez ce paquet de merveilles dans votre éditeur, et nous allons commencer la configuration.

Démarrer

Pour configurer cette application, il faut qu'elle soit accessible depuis le monde extérieur. Utiliser Ngrok pour exposer le port 3000 et notez l https URL qui vous est donnée :

ngrok http 3000

Si vous n'avez pas utilisé Ngrok auparavant, suivez le guide dans cet article de blog pour démarrer.

Configuration

Le premier élément à configurer est le fichier .env.sample est le premier élément à configurer. Commencez par le renommer en .env.

Ajoutez toutes les informations suivantes :

NEXMO_API_KEY="" # from your account dashboard NEXMO_API_SECRET="" # from your account dashboard

L'étape suivante est le détail spécifique à l'application. Il faut les configurer à l'aide de l'interface de programmation.

L'application que vous avez clonée contient deux points d'extrémité :

  • /inbound reçoit de nouveaux SMS

  • /status est une URL obligatoire pour toute application Messages & Dispatch, elle reçoit les accusés de réception et d'autres informations sur les messages que vous envoyez

vonage apps:create ✔ Application Name … Xmas Jokes ✔ Select App Capabilities › Messages ✔ Create messages webhooks? … yes ✔ Inbound Message Webhook - URL … https:///inbound ✔ Inbound Message Webhook - Method › POST ✔ Status Webhook - URL … https:///status ✔ Status Webhook - Method › POST ✔ Allow use of data for AI training? Read data collection disclosure - https://help.nexmo.com/hc/en-us/articles/4401914566036 … yes

Cette commande crée une nouvelle application Applications & Dispatch sur votre Account. Elle affiche à l'écran le message Application ID à l'écran et créera également une clé privée dans le répertoire où vous vous trouvez. Ces deux éléments sont nécessaires pour l'étape suivante de la configuration :

NEXMO_APPLICATION_ID="" # The new App ID you just generated NEXMO_APPLICATION_PRIVATE_KEY="./XmasJokes.key" # No need to change this unless you called your keyfile something different

Enfin, ajoutez votre nouveau numéro capable d'envoyer des SMS :

NEXMO_FROM_NUMBER="" # If you have a Non-US number put it here, otherwise blank NEXMO_FROM_NUMBER_US="" # If you have a US number, put it here, otherwise blank

Une fois tous ces champs remplis, vous pouvez enregistrer votre .env et le fermer.

Vous avez maintenant besoin d'un numéro pour pouvoir recevoir des appels. Vous pouvez en louer un en utilisant la commande suivante (en remplaçant le code du pays par votre code). Par exemple, si vous êtes aux États-Unis, remplacez GB par US:

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

    Reliez maintenant le numéro à votre application :

    vonage apps:link --number=VONAGE_NUMBER APP_ID

Voilà, c'est fait. L'installation est terminée !

La joie des fêtes de fin d'année est à son comble

Vonage sait maintenant où tout va et comment acheminer les nouveaux messages vers votre application. Il ne reste plus qu'une chose à faire :

npm run dev

Une fois que le serveur fonctionne, assurez-vous que votre connexion Numbers est toujours opérationnelle sur la même URL que vous avez utilisée dans les rappels, puis envoyez par SMS le mot "maladroit" à votre nouveau numéro.

Numbers in action

Quelle est la prochaine étape ?

Les étapes suivantes consistent à déployer cette application sur un serveur. Heroku est un excellent choix pour cela et l'application ne nécessitera aucune modification de code pour fonctionner sur ce serveur.

N'oubliez pas que lorsque vous déployez l'application ailleurs, vous devez mettre à jour les rappels pour le numéro de SMS, ainsi que les deux URL pour votre application Messages & Dispatch.

Les commandes CLI dont vous avez besoin pour ce faire sont les suivantes :

vonage apps:update [APP_ID] --voice_event_url=http://example.com/webhooks/event --voice_answer_url=http://example.com/webhooks/answer

Vous êtes alors prêt à partir.

Vous voulez que ce soit encore plus facile ?

Si vous cherchez un moyen encore plus rapide de jouer avec le code de cette application, vous pouvez la remixer sur Glitch en cliquant sur le bouton ci-dessous :

remix button

Partager:

https://a.storyblok.com/f/270183/250x250/d0444194cd/martyn.png
Martyn DaviesAnciens de Vonage

Ancien directeur de la formation des développeurs chez Vonage. Avec une expérience de développeur créatif, de gestionnaire de produits et d'organisateur de journées de hacking, Martyn travaille comme défenseur de la technologie depuis 2012, après avoir travaillé dans le secteur de la radiodiffusion et dans de grandes maisons de disques. Il forme et responsabilise les développeurs du monde entier.