Comment héberger un bot Slack

​

Introduction

​

Prérequis

• Compte Square Cloud : Inscrivez-vous via la page d’inscription en utilisant votre adresse e-mail.
• Plan actif : Garantit des ressources dédiées et des performances optimisées pour votre application. Consultez nos plans disponibles et choisissez celui qui convient le mieux à vos besoins.

​

Créer le projet

​

Application bot sur Slack

1. Rendez-vous sur Slack API - Your Apps et cliquez sur « Create New App ».
2. Choisissez « From scratch », donnez un nom à l’app et sélectionnez le workspace où vous l’installerez.
3. Dans la section « Socket Mode », activez le Socket Mode et générez un app-level token avec le scope connections:write. Copiez-le (il commence par xapp-) : c’est votre SLACK_APP_TOKEN.
4. Dans la section « OAuth & Permissions », ajoutez les scopes dont votre bot a besoin (par exemple chat:write, app_mentions:read, commands), installez l’app sur votre workspace et copiez le Bot User OAuth Token (il commence par xoxb-) : c’est votre SLACK_BOT_TOKEN.
5. Dans « Event Subscriptions », activez les événements et abonnez-vous à l’événement de bot app_mention. Dans « Slash Commands », créez la commande /hello. Avec le Socket Mode activé, aucun des deux ne demande de Request URL.

​

Développer le bot

npm init -y
npm install @slack/bolt

const { App } = require('@slack/bolt');

const app = new App({
  token: process.env.SLACK_BOT_TOKEN,
  appToken: process.env.SLACK_APP_TOKEN,
  // Socket Mode: the bot connects to Slack, so no public URL is needed
  socketMode: true,
});

// Responds when mentioned
app.event('app_mention', async ({ event, say }) => {
  await say(`<@${event.user}> Thanks for mentioning me!`);
});

// Example slash command
app.command('/hello', async ({ ack, respond }) => {
  await ack();
  await respond('Hello from Square Cloud!');
});

(async () => {
  await app.start();
  console.log('⚡️ Slack Bolt app is running!');
})();

pip install slack_bolt

import os

from slack_bolt import App
from slack_bolt.adapter.socket_mode import SocketModeHandler

app = App(token=os.environ.get('SLACK_BOT_TOKEN'))

@app.event('app_mention')
def handle_mention(event, say):
    user = event.get('user')
    say(f'<@{user}> Thanks for mentioning me!')

@app.command('/hello')
def hello_command(ack, respond):
    ack()
    respond('Hello from Square Cloud!')

if __name__ == '__main__':
    # Socket Mode: the bot connects to Slack, so no public URL is needed
    SocketModeHandler(app, os.environ.get('SLACK_APP_TOKEN')).start()

slack_bolt

​

Configurer Square Cloud

DISPLAY_NAME=My Slack Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Slack Bot
MAIN=app.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

• MAIN est le fichier que Square Cloud exécute, et MEMORY la RAM du bot en Mo. Les bots ont besoin d’au moins 256 Mo ; 512 Mo laissent de la marge pour évoluer.
• AUTORESTART=true redémarre le bot s’il plante. Consultez le fonctionnement du redémarrage automatique.
• Il n’y a pas de SUBDOMAIN : en Socket Mode, le bot n’a besoin d’aucune URL publique.

​

Définir les tokens

• Tableau de bord : sur la page d’envoi, ouvrez Configuration avancée et ajoutez les deux variables. Pour un bot déjà déployé, ajoutez-les sur la page Variables d’environnement de l’application et redémarrez le bot.
• CLI : juste après avoir envoyé le bot (voir Déployer et vérifier), définissez-les avec squarecloud app env set et redémarrez le bot :

squarecloud app env set SLACK_BOT_TOKEN=xoxb-your-token SLACK_APP_TOKEN=xapp-your-token
squarecloud app restart

​

Contenu du ZIP

• Votre fichier principal (index.js ou app.py) et vos autres fichiers source.
• package.json ou requirements.txt.
• squarecloud.app.

​

Déployer et vérifier

​

Via le tableau de bord

1

Accéder à la page d'upload

Accédez à la page d’upload et téléversez le fichier zip de votre projet.

2

Configurer votre environnement

Après avoir téléversé votre zip, vous devrez configurer le nom, le fichier principal ou l’environnement d’exécution ainsi que d’autres paramètres de votre projet.
Si vous téléversez un projet web, veillez à sélectionner « Publication Web » et à définir un sous-domaine pour votre projet.

3

Déployer votre projet

Enfin, cliquez sur le bouton « Deploy » pour héberger votre projet sur Square Cloud.
Une fois le déploiement effectué, vous pouvez suivre l’état et les logs de votre projet depuis le tableau de bord.

4

Confirmez que votre application est en ligne

Votre premier déploiement prend généralement moins d’une minute. Dans le tableau de bord, attendez que le statut de votre application affiche « en cours d’exécution » et vérifiez les logs pour détecter d’éventuelles erreurs de démarrage.
Si vous avez déployé un site web ou une API, ouvrez https://<votre-sous-domaine>.squareweb.app dans votre navigateur, vous devriez voir votre application répondre. Si vous avez déployé un bot, envoyez-lui une commande pour confirmer qu’il est en ligne.

Votre application ne démarre pas ? Consultez le guide de dépannage pour les causes les plus courantes et leurs solutions.

​

Via la CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Tester le bot

1. Dans les paramètres de l’app Slack, sous « OAuth & Permissions », installez l’app sur le workspace (si ce n’est pas déjà fait).
2. Vérifiez les logs de l’application dans le tableau de bord Square Cloud pour repérer d’éventuelles erreurs de démarrage. Avec le Socket Mode, il n’y a aucune Request URL à configurer : le bot se connecte à Slack dès son démarrage.
3. Invitez le bot dans un canal, puis mentionnez-le ou exécutez la commande /hello pour valider les réponses.

https://slack.com/oauth/v2/authorize?client_id=000000000000.000000000000&scope=commands,chat:write,app_mentions:read

​

Erreurs courantes

​

You must provide an appToken when socketMode is set to true

​

Either an env variable SLACK_BOT_TOKEN or token argument in the constructor is required

​

Le bot ne répond pas aux mentions

​

Utiliser le mode HTTP au lieu du Socket Mode

1. Dans les paramètres de l’app Slack, désactivez le Socket Mode et copiez le Signing Secret (dans « Basic Information ») dans une variable d’environnement SLACK_SIGNING_SECRET, définie de la même façon que les tokens.
2. Créez l’app avec le signing secret au lieu de l’app-level token, et écoutez sur le port indiqué dans la variable d’environnement PORT :

const app = new App({
  token: process.env.SLACK_BOT_TOKEN,
  signingSecret: process.env.SLACK_SIGNING_SECRET,
});

(async () => {
  // Square Cloud sets PORT=80
  await app.start(Number(process.env.PORT) || 80);
  console.log('⚡️ Slack Bolt app is running!');
})();

app = App(
    token=os.environ.get('SLACK_BOT_TOKEN'),
    signing_secret=os.environ.get('SLACK_SIGNING_SECRET')
)

if __name__ == '__main__':
    # Square Cloud sets PORT=80
    app.start(port=int(os.environ.get('PORT', 80)))

3. Ajoutez un SUBDOMAIN à votre fichier de configuration (ou sélectionnez « Publication Web » et définissez un sous-domaine lors de l’envoi depuis le tableau de bord) pour que le bot obtienne une URL publique. Les applications web nécessitent au moins MEMORY=512 :

DISPLAY_NAME=My Slack Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true
SUBDOMAIN=my-slack-bot

4. Dans « Event Subscriptions » et dans la slash command /hello, définissez la Request URL sur https://<subdomain>.squareweb.app/slack/events.

​

Prochaines étapes

​

Contactez-nous