Canal Slack

Le canal Slack permet a vos employes de discuter avec Merlin via Slack. Tapez @Merlin suivi d'une question dans un canal Slack ou envoyez un message prive, et Merlin repond avec les donnees de vos services connectes.

Disponibilite

Le canal Slack est disponible a partir du plan Professional.

Comment ca marche

1. Un employe tape @Merlin combien de factures ouvertes ai-je ? dans un canal Slack
2. Slack envoie le message a CallMerlin
3. En 5-15 secondes, Merlin repond dans un fil
4. Merlin a acces aux memes outils que le webchat, le telephone et le bureau

Prerequis

• Un plan Professional ou superieur
• Un workspace Slack ou vous pouvez installer des apps
• Droits de proprietaire ou admin du workspace

Configuration

Etape 1 : Creer une application Slack

1. Allez sur api.slack.com/apps et cliquez sur Create New App
2. Choisissez From scratch
3. Nommez l'app (par ex. Merlin) et selectionnez votre workspace
4. Allez dans OAuth & Permissions et ajoutez ces Bot Token Scopes :
   • app_mentions:read
   • chat:write
   • im:read
   • im:write
   • im:history
   • channels:history
   • users:read
5. Cliquez sur Install to Workspace et autorisez l'app
6. Copiez le Bot User OAuth Token (commence par xoxb-)

Etape 2 : Configurer les Event Subscriptions

1. Allez dans Event Subscriptions dans la configuration de votre app Slack
2. Activez Enable Events
3. Collez la Request URL du dashboard CallMerlin (section Canal Slack)
4. Attendez la verification par Slack (coche verte)
5. Ajoutez ces events sous Subscribe to bot events :
   • app_mention
   • message.im
6. Cliquez sur Save Changes

Etape 3 : Configurer le dashboard

1. Allez sur callmerlin.app → Dashboard → Canal Slack
2. Entrez le Bot Token (de l'etape 1)
3. Entrez le Signing Secret (sous Basic Information → App Credentials)
4. Cliquez sur Tester la connexion
5. Choisissez un PIN par defaut (optionnel)
6. Activez le toggle
7. Cliquez sur Enregistrer

Etape 4 : Envoyer le premier message

1. Allez dans Slack
2. Invitez le bot dans un canal : /invite @Merlin
3. Tapez @Merlin bonjour
4. Merlin repond dans un fil

Association d'utilisateurs

Chaque utilisateur Slack est associe a un code PIN. Le PIN determine les autorisations et le template utilises par Merlin.

PIN par defaut

Definissez un PIN par defaut pour les utilisateurs Slack qui ne sont pas encore associes individuellement.

Conseil : Creez un PIN avec des droits de lecture limites comme defaut.

Filtre de canaux

Limitez les canaux Slack dans lesquels Merlin repond. Laissez vide pour tous les canaux.

Facturation

Les messages Slack sont factures comme des sessions de chat :

• Premier message = 0,5 minute
• Questions de suivi dans les 15 minutes = gratuites (meme session)
• Apres 15 minutes = nouvelle session de 0,5 minute

Limites

Depannage

Merlin ne repond pas

1. Verifiez que le toggle est active
2. Verifiez le Bot Token et le Signing Secret
3. Verifiez que les Event Subscriptions sont actives
4. Verifiez que Merlin est invite dans le canal (/invite @Merlin)
5. Verifiez que l'utilisateur a un PIN associe