# Commandes personnalisées

> Crée tes propres commandes de chat Kick comme !discord ou !socials avec KickBot, choisis qui peut les utiliser, ajoute des cooldowns et des variables.

Source: https://kickbot.com/fr/docs/chat-bot/custom-commands

Une commande personnalisée est une commande de chat que tu crées toi-même. Quand un viewer la tape dans ton chat Kick, par exemple `!discord`, KickBot poste la réponse que tu as enregistrée. Tu crées et modifies tes commandes de chat Kick sur la page [Commandes personnalisées](https://kickbot.com/dashboard/commands) du dashboard KickBot, dans **Chat Bot**.

Il te faut un compte KickBot avec ta chaîne Kick connectée, et KickBot doit être [modérateur sur ta chaîne](https://kickbot.com/fr/docs/getting-started/add-kickbot-as-moderator).

![La page Commandes personnalisées avec deux commandes à toi et les six commandes intégrées](https://kickbot.com/docs/images/chat-bot/custom-commands/01-commands-page.webp "Tes propres commandes sont en haut. Les commandes intégrées ont leur propre liste en dessous.")

La page a deux listes :

- **Tes commandes** : les commandes que tu as créées. Tu choisis le nom, la réponse et tous les paramètres.
- **Commandes intégrées** : six commandes prêtes à l'emploi, comme `!followage` et `!lurk`. Elles ne comptent pas dans la limite du forfait Gratuit. Consulte les [commandes intégrées](https://kickbot.com/fr/docs/chat-bot/built-in-commands).

## Ajouter une commande

1. Ouvre [kickbot.com/dashboard/commands](https://kickbot.com/dashboard/commands).
2. Clique sur **Ajouter une commande**. Un panneau s'ouvre à droite.
3. Dans **Commande**, tape le nom sans le `!`. KickBot l'ajoute pour toi. Par exemple, `discord` crée la commande `!discord`.
4. Dans **Réponse**, tape le message que KickBot poste. Tu peux ajouter des [variables](https://kickbot.com/fr/docs/chat-bot/command-variables) avec **Insérer une variable**.
5. Choisis **Qui peut l'utiliser** et règle un **Cooldown** si besoin.
6. Clique sur **Enregistrer**.

La zone **Dans le chat Kick**, en haut, montre comment la commande s'affiche dans le chat pendant que tu tapes. Les variables y affichent des valeurs d'exemple. Cet aperçu n'est visible que par toi.

![Le panneau Nouvelle commande avec la commande discord, une réponse avec une variable et l'aperçu dans le chat Kick](https://kickbot.com/docs/images/chat-bot/custom-commands/02-new-command.webp "L'aperçu en haut montre la réponse avec des valeurs d'exemple.")

## Paramètres

| Paramètre | Ce qu'il fait | Limites et valeur par défaut |
| --- | --- | --- |
| **Commande** | Le mot que les viewers tapent après `!`. | 1 à 20 caractères, sans espace. Les majuscules ne comptent pas : `!Discord` et `!discord` lancent la même commande. |
| **Réponse** | Le message que KickBot poste. | Jusqu'à 500 caractères. Peut contenir des [variables](https://kickbot.com/fr/docs/chat-bot/command-variables). |
| **Qui peut l'utiliser** | **Tout le monde**, **Subs**, **VIPs**, **Mods**, ou une combinaison. | **Tout le monde** par défaut. |
| **Chaque viewer attend** | Cooldown utilisateur : combien de temps un viewer attend avant de réutiliser la commande. | 0 à 300 secondes, par pas de 5. 0 par défaut. |
| **Tout le monde attend** | Cooldown global : combien de temps tout le chat attend après que quelqu'un a utilisé la commande. | 0 à 300 secondes, par pas de 5. 0 par défaut. |
| **Commande active** | Active ou désactive la commande sans la supprimer. | Activée pour les nouvelles commandes. |

## Qui peut utiliser une commande

**Tout le monde** permet à tous les viewers d'utiliser la commande. Quand **Tout le monde** est activé, les autres groupes ne comptent pas.

Désactive **Tout le monde** et choisis un ou plusieurs groupes pour limiter la commande. Par exemple, **Subs** et **Mods** permettent seulement aux subs et aux modérateurs de l'utiliser. Les autres viewers ne reçoivent pas de réponse.

Toi (le streamer), tu peux toujours utiliser toutes les commandes. Si tu désactives tous les groupes, personne à part toi ne peut l'utiliser, et le panneau affiche un avertissement.

![Les boutons Qui peut l'utiliser avec Subs et Mods activés, et les deux champs de cooldown](https://kickbot.com/docs/images/chat-bot/custom-commands/03-who-cooldown.webp "Subs et Mods sélectionnés. Les cooldowns sont en dessous.")

> **Commandes réservées aux modos:** Une commande réservée aux **Mods** est un bon moyen de garder des outils comme une commande de shout-out loin des viewers. C'est pour ça que la commande intégrée `!so` est réglée sur **Mods**. Pour les commandes de modération de Kick comme `/ban` et `/timeout`, consulte la [modération](https://kickbot.com/fr/docs/chat-bot/moderation#kicks-own-moderator-tools).

## Cooldowns

Un cooldown évite le spam quand beaucoup de viewers tapent la même commande.

- **Chaque viewer attend** s'applique à un seul viewer. Avec 30 secondes, un viewer peut utiliser `!discord` une fois toutes les 30 secondes. Les autres viewers peuvent l'utiliser pendant ce temps.
- **Tout le monde attend** s'applique à tout le chat. Avec 10 secondes, KickBot répond à `!discord` au maximum une fois toutes les 10 secondes, peu importe qui la tape.

Les cooldowns ne s'appliquent ni à toi ni à tes modérateurs.

## Modifier, désactiver ou supprimer une commande

- Utilise l'interrupteur sur une ligne pour activer ou désactiver une commande. Le changement est enregistré immédiatement.
- Clique sur une ligne pour l'ouvrir. Modifie n'importe quel champ et clique sur **Enregistrer**.
- Pour supprimer une commande, ouvre-la et clique sur **Supprimer**, puis sur **Supprimer la commande**. C'est définitif.

Les commandes intégrées ne peuvent pas être supprimées. Tu peux les désactiver ou changer leur réponse.

## La limite du forfait Gratuit

> **Note:** Avec le forfait Gratuit, 5 commandes personnalisées au maximum peuvent être activées en même temps. Tu peux en créer plus, mais les autres restent désactivées. Les commandes intégrées ne comptent pas dans cette limite. Premium n'a pas de limite.

## Exemples de commandes utiles

Copie-les et adapte-les à ta chaîne. Un texte comme `discord.gg/your-server-code` est un exemple à remplacer.

| Commande | Réponse |
| --- | --- |
| `!discord` | `Rejoins le Discord : discord.gg/your-server-code` |
| `!socials` | `Suis @{{streamer.username}} sur X : x.com/yourhandle` |
| `!schedule` | `En live mardi, jeudi et samedi à 20h.` |
| `!tip` | `Soutiens le stream : kickbot.com/tips/yourchannel` |
| `!title` | `Aujourd'hui : {{stream.title}}` |
| `!dice` | `@{{sender.username}} a fait un {{randomRange(1,6)}}` |
| `!8ball` | `{{randomItem("Oui","Non","Redemande plus tard")}}` |
| `!hug` | `{{sender.username}} fait un câlin à {{taggedUser.username}}` (les viewers tapent `!hug @name`) |

Pour la liste complète des variables et ce que chacune poste, consulte les [variables de commande](https://kickbot.com/fr/docs/chat-bot/command-variables). Si tu cherches des idées pour ta chaîne, le guide [Les commandes de chat Kick indispensables](https://kickbot.com/fr/guides/grow/kick-chat-commands) en propose d'autres.

## Dépannage

Si une commande ne poste rien dans le chat :

- **KickBot n'est pas modérateur.** C'est la cause la plus fréquente. Consulte [Ajoute KickBot comme modérateur](https://kickbot.com/fr/docs/getting-started/add-kickbot-as-moderator).
- **La commande est désactivée.** Vérifie l'interrupteur sur sa ligne. Avec le forfait Gratuit, une nouvelle commande démarre désactivée quand 5 commandes sont déjà activées.
- **Le viewer n'est pas dans un groupe qui peut l'utiliser.** Par exemple, une commande réservée aux **Subs** ne répond pas aux autres viewers.
- **Un cooldown est encore en cours.** Attends la fin du cooldown, ou teste en tant que streamer.
- **Le nom est déjà utilisé par une autre fonctionnalité.** Quand la [commande de clip](https://kickbot.com/fr/docs/chat-bot/clip-command) est activée, `!clip` fait toujours un clip : une commande personnalisée `!clip` ne se lance pas.

## FAQ

**Comment ajouter des commandes sur Kick ?**

Utilise un chatbot. Avec KickBot, ouvre [kickbot.com/dashboard/commands](https://kickbot.com/dashboard/commands), clique sur **Ajouter une commande**, tape un nom et une réponse, puis clique sur **Enregistrer**. Les viewers peuvent ensuite taper la commande dans ton chat.

**Mes modérateurs peuvent-ils créer des commandes KickBot ?**

Oui. Ajoute-les à ton équipe dans KickBot avec la permission **Commandes personnalisées**. Ils peuvent ensuite se connecter et modifier les commandes de ta chaîne. Consulte [Gérer l'équipe](https://kickbot.com/fr/docs/account/team).

**Combien de commandes puis-je avoir ?**

Il n'y a pas de limite au nombre de commandes que tu crées. Avec le forfait Gratuit, 5 commandes personnalisées peuvent être activées en même temps. Premium n'a pas de limite. Les commandes intégrées ne comptent pas.

**Une commande peut-elle afficher le nom du viewer ou depuis combien de temps il suit la chaîne ?**

Oui. Mets des variables comme `{{sender.username}}` ou `{{sender.followage}}` dans la réponse. KickBot les remplace par la valeur actuelle quand la commande se lance. Consulte les [variables de commande](https://kickbot.com/fr/docs/chat-bot/command-variables).
