# Configurer et utiliser Coworkies dans Slack

Source: https://docs.coworkies.com/fr/integrations/slack/

> Installez Coworkies dans Slack, connectez votre compte ou une clé API, gérez les offres et comprenez les permissions, la reconnexion et les erreurs.

> **My own jobs** est déployé pour Slack et le serveur MCP hébergé. Les intégrations clientes GPT/ChatGPT et Claude restent non testées et non déployées.

Le bot Slack est déployé. L’installation ajoute l’application à un espace de travail ; la configuration personnelle détermine quelles offres personnelles ou d’espace Coworkies vous pouvez gérer. Chaque personne qui publie doit se connecter séparément.

## Connexion et publication

Connectez votre compte Coworkies actif et vérifié. Choisissez **My own jobs** pour recruter sans espace de coworking, ou un espace confirmé dont vous êtes propriétaire ou membre de l’équipe.

La publication est distincte : les annonces gratuites suivent les règles Coworkies ; les offres payantes utilisent votre crédit de recrutement ou nécessitent un paiement. L’accès gratuit au bot ne comprend pas de publications payantes illimitées. Créer ou renouveler une clé API manuelle exige un espace Pro confirmé que vous gérez ; choisissez **Set up on Coworkies** si vous n’avez pas de clé.

## 1. Installer l’application Slack

1. Ouvrez [Coworkies pour Slack](https://www.coworkies.com/slack-bot).
2. Sélectionnez **Add to Slack**. L’installation passe par `https://bot.coworkies.com/slack/install` avant la redirection vers Slack.
3. Choisissez le bon espace de travail Slack et vérifiez les permissions. L’accord d’un administrateur peut être nécessaire.
4. Terminez dans le même navigateur, puis ouvrez Slack et lancez `/coworkies setup`.

Le lien utilise un état lié au navigateur, à usage unique, valable dix minutes. Ne réutilisez pas et ne mettez pas en favori l’URL d’autorisation Slack ou l’URL de retour.

## 2. Choisir une méthode de connexion

La configuration affiche d’abord votre connexion actuelle. Dépliez **Show options** pour voir les choix ; **First time here?** présente les premières étapes. Chaque membre Slack peut connecter son compte de recrutement personnel ou un espace géré par espace de travail Slack.

### Sans clé API : Set up on Coworkies

1. Choisissez **Set up on Coworkies**.
2. Connectez-vous à votre propre compte Coworkies actif et vérifiez votre e-mail si nécessaire.
3. Choisissez **My own jobs**, ou un espace confirmé dont vous êtes propriétaire ou membre de l’équipe (`staff`).
4. Vérifiez puis confirmez la connexion.
5. Sélectionnez **Back to Slack**, puis lancez `/coworkies new` lorsque vous êtes prêt.

Cette connexion ne nécessite ni clé API existante ni abonnement Pro. Coworkies crée un identifiant Slack distinct valable 90 jours. Les règles de recrutement et de publication restent applicables.

Aucun espace n’est nécessaire pour **My own jobs**. Si un espace géré manque, vérifiez sa confirmation et votre rôle dans l’équipe. Une simple adhésion à l’espace ne suffit pas. Consultez [Configurer votre espace](https://docs.coworkies.com/fr/getting-started/space-owner-journey/) ou demandez au propriétaire les droits appropriés.

### Avec une clé : Enter API key dans Slack

1. Choisissez **Enter API key**.
2. Collez une clé API d’espace ordinaire et active dans la fenêtre privée.
3. Sélectionnez **Check key** et vérifiez l’espace détecté.
4. Sélectionnez **Connect**. Les permissions sont vérifiées à nouveau lors de la confirmation.

La clé doit autoriser la lecture et l’écriture des offres ; son propriétaire doit encore gérer cet espace confirmé. Les clés de test, de plateforme/administrateur et les identifiants d’assistant sont refusés. La connexion en attente expire après dix minutes. Une même clé ne peut être liée qu’à une seule combinaison membre/espace de travail Slack : prévoyez une clé par personne qui publie.

**La clé est visible pendant la saisie et transite par Slack.** Ne l’envoyez jamais dans un canal ou un message direct. Coworkies conserve une copie chiffrée ; les permissions, l’expiration et les restrictions de requête restent applicables. Cette méthode a des tests automatisés, mais une soumission réelle par un membre reste à vérifier.

Détenir la clé d’un gestionnaire permet d’agir avec ses permissions sans connexion indépendante à Coworkies. Partagez une clé uniquement si vous souhaitez déléguer cet accès.

Les clés se trouvent dans **Space Admin Panel → Settings & tools → API Keys**. Cette interface est affichée pour les espaces Pro. Consultez [Créer et gérer les clés](https://docs.coworkies.com/fr/spaces/api-keys/). Sans clé, utilisez la connexion par compte ci-dessus.

### Préférer le site : Use an API key

Choisissez **Set up on Coworkies**, puis **Use an API key** sur le site. Connectez-vous comme propriétaire de la clé, saisissez-la dans le champ masqué et confirmez. La clé identifie l’espace ; Coworkies crée un identifiant Slack distinct pour la connexion.

Cette méthode refuse les clés limitées à un réseau ou à une origine, ainsi que les clés de plateforme/administrateur, de test et d’assistant. La clé d’origine n’est ni adoptée ni révoquée par cette configuration.

## 3. Utiliser les commandes

| Commande | Résultat |
| --- | --- |
| `/coworkies setup` | Voir la connexion, changer de compte de recrutement, se reconnecter ou ouvrir les options. |
| `/coworkies new` | Ouvrir le formulaire d’offre. Vérifiez le statut retourné avant de considérer l’offre comme publiée. |
| `/coworkies list` | Afficher jusqu’à dix offres actives du compte de recrutement connecté. |
| `/coworkies delete <job_id>` | Dépublier une offre du compte de recrutement connecté. |
| `/coworkies help` | Afficher l’aide. |
| `/coworkies disconnect` | Supprimer votre connexion personnelle dans cet espace de travail. |

Les résultats de création sont privés ; les mentions et réponses de liste dans un canal peuvent être visibles par ses membres. Un gestionnaire peut gérer les offres de l’espace créées par un autre membre de l’équipe.

Le formulaire Slack propose actuellement temps plein, temps partiel, freelance et stage. Il ne propose **pas** `contract`, même si REST/MCP prennent en charge ce type distinct. Ne remplacez pas un contrat à durée déterminée par freelance. La ville saisie est validée par le serveur. L’extraction automatique depuis une URL, les récapitulatifs automatiques et les circuits d’approbation pour les membres ordinaires ne sont pas disponibles.

## Changer de compte de recrutement ou se déconnecter

Utilisez `/coworkies setup` pour changer de compte de recrutement ou vous reconnecter. La confirmation sur le site vous renvoie vers Slack.

La déconnexion concerne votre lien, pas vos collègues ni les offres déjà publiées. Un identifiant créé par le site est placé en attente de révocation. Pour une clé saisie directement dans Slack, la copie chiffrée est supprimée mais la clé d’origine reste active. Réinstaller ou désinstaller l’application invalide les liens personnels et brouillons en attente concernés ; ils ne sont pas restaurés automatiquement. Une déconnexion ne peut pas annuler une écriture déjà envoyée au serveur.

## Résoudre les problèmes

| Problème | Action |
| --- | --- |
| Lien expiré ou navigateur différent | Recommencez depuis la page Slack de Coworkies dans le même navigateur. Ne réutilisez pas l’onglet de retour en erreur ni une URL d’autorisation enregistrée. |
| Aucun espace éligible | Vérifiez le compte, la confirmation de l’espace et votre rôle propriétaire/équipe. Administrer Slack ne suffit pas. |
| Clé refusée ou accès refusé | Vérifiez le type, les permissions d’offres, l’expiration, les restrictions et le rôle actuel du propriétaire. Utilisez une clé distincte par personne. |
| Connexion expirée | Lancez `/coworkies setup` et reconnectez-vous. |
| Offre en brouillon ou paiement nécessaire | Suivez le résultat et terminez le paiement sur Coworkies. La connexion ne donne pas de publication illimitée. |
| Délai dépassé ou résultat incertain | Vérifiez les offres sur Coworkies avant de soumettre à nouveau ; la première écriture a pu réussir. |

Pour un formulaire bloqué, un contrôle de sécurité HTML ou un échec répété, utilisez [Contacter le support](https://docs.coworkies.com/fr/contact/). Ne désactivez pas la sécurité du navigateur et ne partagez pas vos identifiants. Consultez les [Permissions](https://docs.coworkies.com/fr/integrations/permissions/).

## Recrutement individuel sans espace

Choisissez **My own jobs** lors de la connexion par compte. Seules les offres créées par votre utilisateur Coworkies sans espace associé sont accessibles. Le nom de l’entreprise, l’adresse de contact et l’adhésion à Slack ne donnent aucun droit sur les offres d’autrui. Une ancienne clé sans espace ne reçoit aucun nouvel accès ; les clés API manuelles restent une fonctionnalité des espaces Pro.

Les requêtes de recrutement personnel partagent **20 requêtes par minute et 1 000 par jour UTC** par utilisateur, entre MCP et Slack, vérifications d’identité comprises. Renouveler une clé ou ajouter une connexion n’augmente pas cette limite. Si le stockage des quotas est indisponible, les opérations sont refusées avec `503` ; la déconnexion reste possible. Les limites de découverte MCP et les crédits de publication payante sont distincts.

Le formulaire Slack et l’aperçu MCP proposent **Free** ou **Standard** (`listing_option: "free"` ou `"standard"`). Standard est la valeur par défaut. Free utilise l’annonce de base de 30 jours sans promotion payante ; Standard utilise un crédit disponible ou enregistre un brouillon nécessitant un paiement. Consultez toujours le résultat. MCP permet de modifier et republier les offres ; dans Slack, utilisez le formulaire, la liste des offres actives et la dépublication, puis [Mes offres](https://www.coworkies.com/jobs/my-jobs) pour les brouillons et les autres modifications.