Intégration Slack : lancer une demande d'événement sans quitter le canal
Une phrase tapée dans Slack suffit pour obtenir des lieux disponibles et ouvrir une demande d'afterwork, de séminaire ou de salle de réunion. L'intégration se construit avec l'API publique BookAfterwork.
Comment organiser un afterwork depuis Slack ?
Créez une clé API BookAfterwork, déclarez une slash command dans votre workspace et appelez trois endpoints : analyse de la phrase, recommandation de lieux, création de la demande. Les devis remontent ensuite dans le canal. Gratuit pour les entreprises.
- Une slash command, une vingtaine de lignes de code
- Analyse en langage naturel du brief
- Devis postés dans le canal via webhook signé
- 0 € pour l'entreprise, demandes illimitées
Quatre étapes d'installation
1. Créer une clé API
Depuis la page développeurs, générez une clé de test (bak_test_) puis une clé de production. Stockez-la dans les variables d'environnement de votre app Slack, jamais dans le code du workspace.
2. Déclarer la commande
Dans votre app Slack, ajoutez une slash command (par exemple /afterwork) pointant vers votre endpoint. Vérifiez la signature Slack avant de traiter la requête.
3. Analyser la phrase
Transmettez le texte à /api/v1/ai/parse-request : ville, date, nombre de participants et budget sont extraits automatiquement.
4. Répondre dans le canal
Appelez /api/v1/ai/recommend pour proposer trois lieux, puis /api/v1/requests pour ouvrir la demande. Les devis reçus peuvent être postés dans le canal via un webhook signé.
Exemple de commande
// Slash command Slack : /afterwork 35 pers Lyon 12 mars 40€
app.command('/afterwork', async ({ command, ack, respond }) => {
await ack();
const brief = await fetch('https://bookafterwork.com/api/v1/ai/parse-request', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BAK_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ text: command.text }),
}).then((r) => r.json());
const venues = await fetch('https://bookafterwork.com/api/v1/ai/recommend', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BAK_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify(brief),
}).then((r) => r.json());
await respond(
venues.results
.slice(0, 3)
.map((v) => `• ${v.name} — ${v.city} — ${v.capacity} pers.`)
.join('\n'),
);
});Questions fréquentes
Existe-t-il une application Slack officielle BookAfterwork ?
Pas encore. L'intégration se construit aujourd'hui avec l'API publique et une app Slack interne : c'est une vingtaine de lignes de code pour une slash command. Une app publiée sur le répertoire Slack est prévue.
Que peut-on faire depuis Slack ?
Analyser une phrase en langage naturel, obtenir des lieux disponibles avec leur capacité, ouvrir une demande d'afterwork, de séminaire ou de salle de réunion et recevoir les devis dans le canal de l'équipe.
Qui voit les informations ?
Les résultats sont postés dans le canal choisi par votre équipe. Les données personnelles des participants ne sont pas nécessaires pour lancer une demande : ville, date, nombre de personnes et budget suffisent.
Cette intégration est-elle facturée ?
Non. L'usage reste gratuit pour les entreprises, comme sur le site. Les frais de service ne concernent que les lieux et prestataires, et uniquement lorsque l'entreprise accepte un devis.
