Documentation

Do you use documentation to use NewBot Framework

Emulateur

Vous avez deux moyens pour tester votre chatbot :

  1. Via le terminal
  2. Dans le navigateur
  3. Via le logiciel BotFramework Emulator
  4. Tester directement sur une platforme externe

Terminal

L'interêt de tester via le terminal est de rien installer sur votre machine et simuler la source (messenger, viber, etc.)

Tapez newbot emulator sur votre projet. Si vous utilisez des formats, le format JSON vous sera renvoyé

Pour tester les formats sous une autre source, par exemple Messenger, tapez newbot emulator -s messenger

Pas besoin d'avoir des comptes sur les différentes sources, c'est juste une simulation

Emulateur graphique

L'interêt de tester via l'émulateur est

  1. De profiter d'une interface graphique enrichie
  2. D'avoir le Hot Reloading (en modifiant un fichier dans la compétence, cela relance le serveur sans affecter ngrok et l'émulateur en cours)

Avant tout, Tapez newbot serve dans le terminal

Cela effectue une écoute sur le port 3000. Pour changer le port : newbot serve -p <PORT>

Dans le navigateur

Allez sur http://localhost:3000 (ou un autre port s'il a été changé)

BotFramework Emulator

Tapez newbot serve dans le terminal

  1. Télécharger la version 4 sur votre machine : BotFramework Emulator
  2. Cliquez sur File > Open Bot
  3. Selectionnez le fichier emulator.bot se trouvant à la racine de votre projet

Tester directement sur Messenger

  1. Vérifier que vous avez la bonne configuration dans le fichier newbot.config.js
module.exports = {
    platforms: {
        messenger: {
            accessToken: '__FILL_YOUR_TOKEN_HERE__',
            appSecret: '__FILL_YOUR_SECRET_HERE__',
            verifyToken: '__FILL_YOUR_VERIFYTOKEN_HERE__',
        }
    }
}
  1. Tapez newbot serve dans le terminal.
  2. Cela vous donne une URL généré par le programme ngrok. Ajoutez cette URL dans le webhook de Messenger

Tester sur Amazon Alexa

  1. Ajoutez le modèle suivante dans Amazon Alexa :
{
    "interactionModel": {
        "languageModel": {
            "invocationName": "<INVOCATION NAME>",
            "intents": [
                {
                    "name": "NewBotIntent",
                    "slots": [
                        {
                            "name": "any",
                            "type": "any"
                        }
                    ],
                    "samples": [
                        "{any}"
                    ]
                },
                {
                    "name": "AMAZON.NavigateHomeIntent",
                    "samples": []
                },
                {
                    "name": "AMAZON.CancelIntent",
                    "samples": []
                },
                {
                    "name": "AMAZON.HelpIntent",
                    "samples": []
                },
                {
                    "name": "AMAZON.StopIntent",
                    "samples": []
                },
                {
                    "name": "AMAZON.PauseIntent",
                    "samples": []
                },
                {
                    "name": "AMAZON.ResumeIntent",
                    "samples": []
                }
            ],
            "types": [
                {
                    "name": "any",
                    "values": [
                        {
                            "name": {
                                "value": "a test"
                            }
                        },
                        {
                            "name": {
                                "value": "a simple sentence"
                            }
                        },
                        {
                            "name": {
                                "value": "what is your name?"
                            }
                        }
                    ]
                }
            ]
        }
    }
}
  1. Ajoutez un endpoint :

Default Region : <ADRESSE NGROK>/emulator/alexa Option: My development endpoint is a sub-domain of a domain that has a wildcard certificate from a certificate authority

© 2019 NewBot